[Orca-checkins] rev 208 - /

[blair at orcaware.com]

Author: blair
Date: 2003-03-08 13:25:40 -0800 (Sat, 08 Mar 2003)
New Revision: 208

Added:
   README
Log:
* README:
  Add a top level file describing the layout of the repository and
  how to and how not to check out the repository.


Added: README
==============================================================================
--- README	(original)
+++ README	2003-03-08 13:26:07.000000000 -0800
@@ -0,0 +1,44 @@
+This is the top of OrcaWare Consulting's Subversion repository.
+
+   trunk/ ......... The latest development sources.  When people say
+                    "Get the head of trunk", they mean the latest
+                    revision of an entire project directory located in
+                    trunk/, such as trunk/find_badblocks or
+                    trunk/orca.  Normally, you wouldn't want to check
+                    out an entire copy of trunk/, because it contains
+                    many unrelated projects.
+
+   branches/ ...... Various development branches.  Typically a branch
+                    contains a complete copy of a project's directory
+                    in trunk/, even if the changes are isolated to one
+                    subdirectory in the project.  Note that branch
+                    copies are generally removed after they've been
+                    merged back into trunk/, so what's in branches/
+                    now does not reflect all the branches that have
+                    ever been created.
+
+   tags/ .......... Snapshots of releases.  As a general policy, we
+                    don't change these after they're created; if
+                    something needs to change, we move it to branches
+                    and work on it there.
+
+When checking out the source code on this server, please be extra
+careful to check out only the package you need, otherwise you may
+check out the entire repository and fill up a minimum of 300 Mbytes on
+your disk and take forever to check out. Here are some sample
+commands:
+
+   Check out the HEAD, that is the latest working copy, of the Orca
+   package:
+
+      svn co http://svn.orcaware.com:8000/repos/trunk/orca/
+
+   Check out Orca tagged at version 0.27:
+
+      svn co http://svn.orcaware.com:8000/repos/tags/orca/0.27/
+
+   These are the commands to avoid, as they will check out everything
+   underneath the specified URL. Be careful :) :
+
+      svn co http://svn.orcaware.com:8000/repos/
+      svn co http://svn.orcaware.com:8000/repos/tags/