Changes between Initial version and Version 1 of ropp_repository

Timestamp:

2008-03-11T16:59:32Z (16 years ago)

Author:

Huw Lewis

Comment:

--

ropp_repository

@@ +1 @@
+== The ROPP Repository ==
+
+The whole ROPP development system is divided into three areas:
+ * '''ropp_src'''   : deliverable code & supporting development system
+ * '''ropp_doc'''   : user and project documentation
+ * '''ropp_test'''  : Test Folder (test system and its results)
+ 
+The repository for ROPP can be accessed via the Subversion server at the URL
+{{{
+https://svn.grassaf.org/ropp/
+}}}
+For example, checking out the latest development (trunk) versions:
+{{{
+svn checkout https://svn.grassaf.org/ropp/ropp_src/trunk . 
+svn checkout https://svn.grassaf.org/ropp/ropp_doc/trunk . 
+svn checkout https://svn.grassaf.org/ropp/ropp_test/trunk .
+}}}
+will check out the source code, documentation, and test folder, respectively to the local working directory.
+
+For a complete list of Subversion commands see the [http://svnbook.red-bean.com/en/1.0/index.html SVN reference manual]
+
+== Branches ==
+
+Developments to ROPP should be made from, and committed to, a ''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 ''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. 
+
+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 should 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 ''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.
+{{{
+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 ''svn merge'' command. You must first change directory to your branch's working copy: e.g.
+{{{
+cd ${HOME}/FCM/<branch name>
+svn merge 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}/FCM/<branch name>
+svn merge --dry-run https://svn.grassaf.org/ropp/ropp_src/trunk
+}}}
+
+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]