FCKeditor 2.x/Developers Guide/SVN - Revision history

Fredck at 11:13, 23 January 2008

2008-01-23T11:13:39Z

Fredck at 11:12, 23 January 2008

2008-01-23T11:12:21Z

W.olchawa at 10:23, 23 January 2008

2008-01-23T10:23:19Z

W.olchawa at 10:22, 23 January 2008

2008-01-23T10:22:56Z

W.olchawa at 10:22, 23 January 2008

2008-01-23T10:22:37Z

W.olchawa at 10:22, 23 January 2008

2008-01-23T10:22:15Z

W.olchawa at 10:20, 23 January 2008

2008-01-23T10:20:52Z

W.olchawa at 10:15, 23 January 2008

2008-01-23T10:15:05Z

W.olchawa at 10:14, 23 January 2008

2008-01-23T10:14:05Z

W.olchawa at 10:08, 23 January 2008

2008-01-23T10:08:08Z

@@ Line 33: / Line 33: @@
 == Repository Structure ==
 <pre>FCKeditor -----------+ Every subproject will have a directory in the root.
-<pre>
+trunk -----------+ This is the development place.
-FCKeditor -----------+ Every subproject will have a directory in the root.
+branches
-    trunk -----------+ This is the development place.
+developers --+
-    branches
+features | Isolated development spaces.
-        developers --+
+versions ----+
-        features     | Isolated development spaces.
+tags
-        versions ----+
+.3.2 -------+
-    tags
+.3.1 | A tag will be available for each version release.
-.3.2 -------+
+.3 | It contains the development version (trunk) at release time.
-.3.1        | A tag will be available for each version release.
+.6.1 -------+
-.3          | It contains the development version (trunk) at release time.
+</pre>
 All subprojects in the repository will present a structure similar to the above.
@@ Line 75: / Line 73: @@
 If you are insecure, don't be afraid of asking others to execute this task for you.
-TortoiseSVN offers a nice tool to track the creation an life-cicle of branches. It is called "Revision graph". The SVN log can also be used for it.
+TortoiseSVN offers a nice tool to track the creation an life-cicle of branches. It is called "Revision graph". The SVN log can also be used for it.<br>
 == Links ==

← Older revision		Revision as of 11:12, 23 January 2008
Line 77:		Line 77:
	TortoiseSVN offers a nice tool to track the creation an life-cicle of branches. It is called "Revision graph". The SVN log can also be used for it.		TortoiseSVN offers a nice tool to track the creation an life-cicle of branches. It is called "Revision graph". The SVN log can also be used for it.

−	~~== Committing ==~~

−	~~Try to make a single commit for each fix or feature. Avoid making big commits with lots of changes. This separation makes each commit an isolate thing. It makes code review and merge tasks easy.~~
−
−	The commit log message is very important. Don't underestimate it. It must be well written and informative. Whenever possible, make references to related trac items, like tickets or changesets. You may use one of the "standard" messages, like the following examples:
−
−	* Fixed [http://dev.fckeditor.net/ticket/81 #81]: IE has a DOM bug that caused FCKDomTools.RTrimNode to break.
−	* Merged trunk [http://dev.fckeditor.net/log/?rev=132&stop_rev=131 r131:132] into branches/versions/2.4.x
−	* FCKeditor 2.4 tagging

	== Links ==		== Links ==

@@ Line 83: / Line 83: @@
 The commit log message is very important. Don't underestimate it. It must be well written and informative. Whenever possible, make references to related trac items, like tickets or changesets. You may use one of the "standard" messages, like the following examples:
-* Fixed [http://dev.fckeditor.net/ticket/81| #81]: IE has a DOM bug that caused FCKDomTools.RTrimNode to break.
+* Fixed [http://dev.fckeditor.net/ticket/81 #81]: IE has a DOM bug that caused FCKDomTools.RTrimNode to break.
-* Merged trunk [http://dev.fckeditor.net/log/?rev=132&stop_rev=131| r131:132] into branches/versions/2.4.x
+* Merged trunk [http://dev.fckeditor.net/log/?rev=132&stop_rev=131 r131:132] into branches/versions/2.4.x
 * FCKeditor 2.4 tagging

@@ Line 30: / Line 30: @@
 http://rev.fckeditor.net/
-The list in the above site is quite similar to the [http://dev.fckeditor.net/log/FCKeditor/trunk| trunk log page], with the exception that it contains and additional column called "Test". A link can be found there to open the sample pages of FCKeditor, generated for each precise revision.
+The list in the above site is quite similar to the [http://dev.fckeditor.net/log/FCKeditor/trunk trunk log page], with the exception that it contains and additional column called "Test". A link can be found there to open the sample pages of FCKeditor, generated for each precise revision.
 == Repository Structure ==

@@ Line 16: / Line 16: @@
 * http://www.fckeditor.net/nightly/FCKeditor_N.tar.gz
-You may also test it online [http://www.fckeditor.net/nightly/fckeditor/_samples/default.html: here].
+You may also test it online [http://www.fckeditor.net/nightly/fckeditor/_samples/default.html here].
 The nightly is processed for public distribution. As the fixes and features available on nightlies are still under testing and development, it may be used on production systems at your own risk.

@@ Line 1: / Line 1: @@
 == Development SVN ==
-The SVN repository used for the development can be found at ([http://dev.fckeditor.net/browser: browsable]):
+The SVN repository used for the development can be found at ([http://dev.fckeditor.net/browser browsable]):
 http://svn.fckeditor.net

@@ Line 12: / Line 12: @@
 Every night, at 0:30 PST, a "'''Nightly Build'''" is generated, from the SVN version. You may download it from one of the following links:
 * http://www.fckeditor.net/nightly/FCKeditor_N.zip
 * http://www.fckeditor.net/nightly/FCKeditor_N.tar.gz
-You may also test it online [http://www.fckeditor.net/nightly/fckeditor/_samples/default.html| here].
 The nightly is processed for public distribution. As the fixes and features available on nightlies are still under testing and development, it may be used on production systems at your own risk.
 == Working with SVN ==

@@ Line 87: / Line 87: @@
 == Links ==
-* '''TortoiseSVN:''' the SVN integration with the Windows Shell. This is the best way to work with SVN in Windows:
+* '''TortoiseSVN:''' the SVN integration with the Windows Shell. This is the best way to work with SVN in Windows:<br>http://tortoisesvn.tigris.org/
+* '''Subversion:''' the official SVN command line. Windows binaries can be found in the download page:<br>http://subversion.tigris.org/
-http://tortoisesvn.tigris.org/
+* '''Book - Version Control with Subversion:''' a good book about SVN:<br>http://svnbook.red-bean.com/

← Older revision		Revision as of 10:14, 23 January 2008
Line 52:		Line 52:

	Starting from version 2.4, the trunk will always have stable code which we can publish to the public SVN, and eventually release officially. So, only important bugs and small changes will be committed here, while more delicate and extensive developments will be done in a "branch".		Starting from version 2.4, the trunk will always have stable code which we can publish to the public SVN, and eventually release officially. So, only important bugs and small changes will be committed here, while more delicate and extensive developments will be done in a "branch".
		+
		+	=== Branches ===
		+
		+	Branches give us isolated environments for development, and once tested and confirmed a new work is ready, it can be simply merged in the trunk.
		+
		+	For code that doesn't bring instability, like trivial fixes or small features, there is no need to work on a separated branch. It can be committed directly to the trunk if you feel the code is ok and it is well tested. It makes the management easier.
		+
		+	The branches could be created in the following spaces:
		+
		+	* '''branches/developers:''' each developer may have a private branch under this directory. The directory name is the developer name (fredck, for example). The developer himself can decide to use it or not, and have complete freedom for it.
		+	* '''branches/features:''' if a feature is too big and complex, a developer could decide to create a dedicated branch for it.
		+	* '''branches/versions:''' there could be branches for future versions, waiting while previous ones are being tested and released.
		+
		+	==== Merging Branches ====
		+
		+	A common task during a branch development, is to '''merge changes made in the trunk to the branch''', leaving it always up to date with the trunk. Remember that merges must be done from the last revision merged, starting from the revision from which the branch has been created.
		+
		+	When '''merging branches to the trunk''', first merge the trunk to the branch and check that everything is ok. Make the necessary changes and commit the branch. Then switch to the trunk and merge the differences between the branch HEAD and the last trunk revision you have just merged to the branch (usually HEAD). Then, if the branch is not anymore needed, just delete it (SVN delete I mean).
		+
		+	If you are insecure, don't be afraid of asking others to execute this task for you.
		+
		+	TortoiseSVN offers a nice tool to track the creation an life-cicle of branches. It is called "Revision graph". The SVN log can also be used for it.
		+
		+	== Committing ==
		+
		+	Try to make a single commit for each fix or feature. Avoid making big commits with lots of changes. This separation makes each commit an isolate thing. It makes code review and merge tasks easy.
		+
		+	The commit log message is very important. Don't underestimate it. It must be well written and informative. Whenever possible, make references to related trac items, like tickets or changesets. You may use one of the "standard" messages, like the following examples:
		+
		+	* Fixed [http://dev.fckeditor.net/ticket/81\| #81]: IE has a DOM bug that caused FCKDomTools.RTrimNode to break.
		+	* Merged trunk [http://dev.fckeditor.net/log/?rev=132&stop_rev=131\| r131:132] into branches/versions/2.4.x
		+	* FCKeditor 2.4 tagging
		+
		+	== Links ==
		+
		+	* '''TortoiseSVN:''' the SVN integration with the Windows Shell. This is the best way to work with SVN in Windows:
		+
		+	http://tortoisesvn.tigris.org/
		+
		+	* '''Subversion:''' the official SVN command line. Windows binaries can be found in the download page:
		+
		+	http://subversion.tigris.org/
		+
		+	* '''Book - Version Control with Subversion:''' a good book about SVN:
		+
		+	http://svnbook.red-bean.com/

← Older revision		Revision as of 10:08, 23 January 2008
Line 28:		Line 28:
	http://rev.fckeditor.net/		http://rev.fckeditor.net/

−	The list in the above site is quite similar to the [http://dev.fckeditor.net/log/FCKeditor/trunk\|trunk log page], with the exception that it contains and additional column called "Test". A link can be found there to open the sample pages of FCKeditor, generated for each precise revision.	+	The list in the above site is quite similar to the [http://dev.fckeditor.net/log/FCKeditor/trunk\| trunk log page], with the exception that it contains and additional column called "Test". A link can be found there to open the sample pages of FCKeditor, generated for each precise revision.
		+
		+	== Repository Structure ==
		+
		+	<pre>
		+	FCKeditor -----------+ Every subproject will have a directory in the root.
		+	trunk -----------+ This is the development place.
		+	branches
		+	developers --+
		+	features \| Isolated development spaces.
		+	versions ----+
		+	tags
		+	2.3.2 -------+
		+	2.3.1 \| A tag will be available for each version release.
		+	2.3 \| It contains the development version (trunk) at release time.
		+	1.6.1 -------+
		+	</pre>
		+	All subprojects in the repository will present a structure similar to the above.
		+
		+	=== The "trunk" ===
		+
		+	The trunk is the effective place we'll be working everyday. Usually we'll have local working copies of the trunk only (and possibly any branch).
		+
		+	Starting from version 2.4, the trunk will always have stable code which we can publish to the public SVN, and eventually release officially. So, only important bugs and small changes will be committed here, while more delicate and extensive developments will be done in a "branch".