none
[openafs-wiki.git] / AFSLore / HowToBuildOpenAFSFromSource.mdwn
index d4a8ebf..e1dc8fc 100644 (file)
@@ -35,28 +35,33 @@ First you need to run cvs login. This step is normally only done once. A ~/.cvsp
        cvs -d :pserver:anonymous@cvs.openafs.org:/cvs  login
        password is anonymous
 
-To check out the 1.4 branch:
+Before doing a CVS check out, you'll need to decide which branch you want to check out. The trunk is for bleeding edge development and may not even build. The current stable series is openafs-stable-1\_4\_x and the current development work is going on the openafs-devel-1\_5\_x branch.
 
-       cvs -d :pserver:anonymous@cvs.openafs.org:/cvs co -r openafs-stable-1_4_x openafs
+See the CVSWeb interface at <http://www.openafs.org/frameset/cgi-bin/cvsweb.cgi/openafs/> for the full list of available branches and tags.
 
-To check out the 1.5 development branch:
+To check out the stable branch:
 
-       cvs -d :pserver:anonymous@cvs.openafs.org:/cvs co -r openafs-devel-1_5_x openafs
+       cvs -d :pserver:anonymous@cvs.openafs.org:/cvs checkout -r openafs-stable-1_4_x openafs
 
-See the CVSWeb interface at <http://www.openafs.org/frameset/cgi-bin/cvsweb.cgi/openafs/> to see a full list of available branches and tags
+To check out the development branch:
 
-CVS snapshots do not include files generated by autoconf; You can run regen.sh at the top level to create these files. You will need to have autoconf and automake installed on your system.
+       cvs -d :pserver:anonymous@cvs.openafs.org:/cvs checkout -r openafs-devel-1_5_x openafs
+
+This will create a source tree in a directory named openafs.
+
+Run the regen.sh script to create the configure script.
+
+       cd openafs
+       ./regen.sh
 
 ### <a name="Building the Binaries"></a> Building the Binaries
 
 #### <a name="Transarc Paths"></a> Transarc Paths
 
-By convention, [[OpenAFS]] server binaries and related files are located in /usr/afs, and client binaries and related files are located in /usr/vice. These are known as Transarc paths, so called because that is is the convention used by Transarc, the company that first commercized AFS.
+By convention, [[OpenAFS]] server binaries and related files are located in /usr/afs, and client binaries and related files are located in /usr/vice. These are known as Transarc paths, so called because that is is the convention used by Transarc, the company that first commercialized AFS.
 
 To build [[OpenAFS]] with Kerberos 5 support and the traditional, Transarc paths:
 
-       cd openafs
-       ./regen.sh
        ./configure  --enable-transarc-paths --with-krb5-conf=(full path to krb5-config script)
        make
        make dest
@@ -77,8 +82,6 @@ The 'make install' command does not work with Transarc paths. You will have to m
 
 To build [[OpenAFS]] with Kerberos 5 support, and with a custom install path,
 
-       cd openafs
-       ./regen.sh
        ./configure --prefix=/usr/local/openafs --with-krb5-conf=(full path to krb5-config script)
        make
        sudo make install