[pypy-svn] r12771 - pypy/dist/pypy/documentation

[hpk at codespeak.net]

Author: hpk
Date: Tue May 24 15:58:48 2005
New Revision: 12771

Modified:
   pypy/dist/pypy/documentation/coding-guide.txt
Log:
added "branching" information/recommendations to the coding guide. 



Modified: pypy/dist/pypy/documentation/coding-guide.txt
==============================================================================
--- pypy/dist/pypy/documentation/coding-guide.txt	(original)
+++ pypy/dist/pypy/documentation/coding-guide.txt	Tue May 24 15:58:48 2005
@@ -732,8 +732,8 @@
   includes w_self.  Don't use ``w_`` in application level
   python only code.
 
-Committing
-----------
+Committing & Branching to the repository
+-----------------------------------------------------
 
 - write good log messages because several people
   are reading the diffs. 
@@ -743,6 +743,19 @@
   that the property 'svn:eol-style' is set to native which 
   allows checkin/checkout in native line-ending format.
 
+- branching (aka "svn copy") of source code should usually
+  happen at ``svn/pypy/dist`` level in order to have a full
+  self-contained pypy checkout for each branch.   For branching
+  a ``try1`` branch you would for example do:: 
+
+    svn cp http://codespeak.net/svn/pypy/dist \
+           http://codespeak.net/svn/pypy/branch/try1 
+
+  This allows to checkout the ``try1`` branch and receive a 
+  self-contained working-copy for the branch.   Note that 
+  branching/copying is a cheap operation with subversion, as it 
+  takes constant time irrespective of the size of the tree. 
+
 - To learn more about how to use subversion read `this document`_.
 
 .. _`this document`: svn-help.html