Author: branden Date: 2003-06-18 12:01:26 -0500 (Wed, 18 Jun 2003) New Revision: 212
Modified: HACKING README Log: move checkout/export policy from README to HACKING, since it is only applicable to those with the power to checkout or export from the repository Modified: HACKING ============================================================================== --- HACKING 2003-06-18 16:51:15 UTC (rev 211) +++ HACKING 2003-06-18 17:01:26 UTC (rev 212) @@ -9,6 +9,43 @@ Colin Watson ISHIKAWA Mutsumi +Checkout/export policy +---------------------- + +DO NOT EVER CHECK OUT OR EXPORT THE FOLLOWING PATHS WITHOUT PRIOR +PERMISSION FROM BRANDEN ROBINSON: + svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86 + svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86/branches + svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86/tags + svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86/vendor + +Once the XFree86 upstream code is imported, the *huge* number of tags and +branches in it will 1) consume massive amounts of bandwidth from this +server, and 2) consume massive amounts of disk space in your export or +checkout directory. Recall that in Subversion, unlike CVS, branches and +tags aren't "special" -- they are simply copies of a particular revision of +the repository. This is handled in a highly space-efficient manner in the +Subversion repository, but will cause complete copies to be sent to +checkouts and exports. Let's say that one copy of XFree86 source tree is +about 350 MB, which is approximately correct. At the time XFree86 4.3.0 +was released, there were *FOUR HUNDRED SIXTY-SEVEN* branches and tags. +This means that checking out the root of the repository will cause *ONE +HUNDRED SIXTY-THREE GIGABYTES* of data to be transferred off of my server +and onto your hard disk, if you even have that much space. Checking out +the branches, tags, or vendor directories will be almost as bad. + +So, please, DO NOT DO THAT. + +Checking out one of the following: + svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86/people + svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86/trunk + +or any subdirectory thereof is freely permitted until further notice, +however. + +Branden strongly encourage users of the repository to read the Subversion book: + http://svnbook.red-bean.com/ + Recommended best practices for handling commits and changelog entries --------------------------------------------------------------------- Modified: README ============================================================================== --- README 2003-06-18 16:51:15 UTC (rev 211) +++ README 2003-06-18 17:01:26 UTC (rev 212) @@ -28,46 +28,6 @@ is due to the perversity of the Berkeley DB software, and is corrected by the repository administrator as soon as possible. -X Strike Force team members: - -*** IMPORTANT * IMPORTANT * IMPORTANT * IMPORTANT * IMPORTANT * IMPORTANT *** - -DO NOT EVER CHECK OUT OR EXPORT THE FOLLOWING PATHS WITHOUT PRIOR -PERMISSION FROM BRANDEN ROBINSON: - svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86 - svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86/branches - svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86/tags - svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86/vendor - -Once the XFree86 upstream code is imported, the *huge* number of tags and -branches in it will 1) consume massive amounts of bandwidth from this -server, and 2) consume massive amounts of disk space in your export or -checkout directory. Recall that in Subversion, unlike CVS, branches and -tags aren't "special" -- they are simply copies of a particular revision of -the repository. This is handled in a highly space-efficient manner in the -Subversion repository, but will cause complete copies to be sent to -checkouts and exports. Let's say that one copy of XFree86 source tree is -about 350 MB, which is approximately correct. At the time XFree86 4.3.0 -was released, there were *FOUR HUNDRED SIXTY-SEVEN* branches and tags. -This means that checking out the root of the repository will cause *ONE -HUNDRED SIXTY-THREE GIGABYTES* of data to be transferred off of my server -and onto your hard disk, if you even have that much space. Checking out -the branches, tags, or vendor directories will be almost as bad. - -So, please, DO NOT DO THAT. - -Checking out one of the following: - svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86/people - svn+ssh://necrotic.deadbeast.net/var/lib/svn/xfree86/trunk - -or any subdirectory thereof is freely permitted until further notice, -however. - -I strongly encourage users of my repository to read the Subversion book: - http://svnbook.red-bean.com/ - -*** IMPORTANT * IMPORTANT * IMPORTANT * IMPORTANT * IMPORTANT * IMPORTANT *** - The "trunk" is destined to be the next Debian unstable release. It's where the cutting-edge but non-disruptive work takes place.
