Changes between Initial version and Version 1 of ropp_branches

Timestamp:

2008-03-13T11:12:54Z (17 years ago)

Author:

Huw Lewis

Comment:

Create separate page with branch instructions for developers

ropp_branches

@@ +1 @@
+== Branches ==
+
+Developments to ROPP should be made from, and committed to, a [http://svnbook.red-bean.com/en/1.0/ch04.html#svn-ch-4-sect-1 branch] rather than directly to the latest trunk version. This allows changes to be tested before merging the required changes back into the trunk. The trunk therefore represents a stable 'next potential release' state for ROPP. Branches can be temporary and might be for working on resolving a specific Trac Ticket.
+
+'''Creating a branch'''
+
+To create a branch of ropp_src from the trunk use the [http://svnbook.red-bean.com/en/1.0/re07.html svn copy ''SRC DST''] command:
+{{{
+svn copy https://svn.grassaf.org/ropp/ropp_src/trunk https://svn.grassaf.org/ropp/ropp_src/branches/dev/Share/<branch_name>
+}}}
+where <branch name> is a name of your choice which should reflect what you are working on. This prompts a text editor where you should describe the purpose of the new branch.
+
+By default it is assumed that you wish to branch from the latest change version of the trunk. The ''-r'' flag can be used to specify the trunk revision from which a branch is required if this is not the latest. The ''-m'' flag could also be used when creating a branch to describe the contents of the branch.
+{{{
+svn copy [-r revision] SRC DST [-m "some text here"]
+}}}
+
+Similar branches may be created to store user versions of ropp_doc or ropp_test as required.
+
+'''Checking out a branch'''
+
+To make developments, the branch needs to be checked out to the local working directory for editing as above, specifying the path name for the required branch as
+{{{
+svn checkout https://svn.grassaf.org/ropp/ropp_src/branches/dev/Share/<branch_name>
+}}}
+
+'''Working in a branch'''
+
+Code developments are then made and logged within a branch as normal.
+To view the local changes made to a branch, use the [http://svnbook.red-bean.com/en/1.0/re26.html svn status] command.
+
+
+'''Committing changes to a branch''' 
+
+When changes to a branch are ready to be updated in the repository, the code needs to be committed using the [http://svnbook.red-bean.com/en/1.0/re05.html svn commit] command.
+{{{
+svn commit -m "Some text here to describe the changes"
+}}}
+This will prompt a list of the changes to be committed.
+
+When you are satisfied that all the changes you require to your branch have been committed and the ROPP Development Team are satisfied that it will be part of the next release, these changes will be merged back into the trunk by ROPP Admin.
+
+'''Keeping up to date with changes to trunk'''
+
+At some stage it may be necessary to update the trunk with latest developments while a user is still working in a particular branch. Users will be notified of any changes to trunk. 
+
+In order to keep a branch up to date with the latest version of the trunk while you are working on your branch, you may want to bring in the changes that have been made to the main trunk. This can be done using the [http://svnbook.red-bean.com/en/1.0/re16.html svn merge] command. You must first change directory to your branch's working copy: e.g.
+{{{
+cd ${HOME}/<SVN_working_dir>/<branch name>
+}}}
+For a branch was created at revision ''NNNN'', the following command will merge all changes made in trunk since the branch was created into your branch.
+{{{
+svn merge -r NNNN:HEAD https://svn.grassaf.org/ropp/ropp_src/trunk
+}}}
+When you do this, you should see the list of updates that have been made to the trunk since you last brought in any changes (or since you branched). Note that this only results in changes to your working copy so you might want to commit them to the repository. 
+
+It is useful to preview the files which will be changed on performing a merge before going ahead using:
+{{{
+cd ${HOME}/<SVN_working_dir>/<branch name>
+svn merge --dry-run -r NNNN:HEAD https://svn.grassaf.org/ropp/ropp_src/trunk
+}}}
+
+The merge command can be used separately on subdirectories and files within a branch as required.
+
+Further information on branches are available in 
+[http://svnbook.red-bean.com/en/1.0/ch04.html#svn-ch-4-sect-1 SVN reference: Branching and Merging]
+