need the pre suffix on prerelease directories

[openafs-wiki.git] / AFSLore / HowToBuildOpenAFSFromSource.mdwn

diff --git a/AFSLore/HowToBuildOpenAFSFromSource.mdwn b/AFSLore/HowToBuildOpenAFSFromSource.mdwn
index 1d5330b..2c29ec5 100644 (file)
--- a/AFSLore/HowToBuildOpenAFSFromSource.mdwn
+++ b/AFSLore/HowToBuildOpenAFSFromSource.mdwn
@@ -8,7 +8,7 @@ Unless otherwise noted, the information on this page is for version 1.6.x
 
 ## Getting Started
 
-The following shows how to download a source code tarballs and build the
+The following shows how to download source code tarballs and build the
 OpenAFS binaries:
 
     $ wget http://openafs.org/dl/openafs/<version>/openafs-<version>-src.tar.bz2
@@ -30,7 +30,6 @@ The following shows how to do a git checkout and build the OpenAFS binaries,
     $ ./configure
     $ make
 
-
 You will usually want to specify configure options. For example, to enable the
 traditional Transarc/IBM AFS installation paths, run configure with the
 --enable-transarc-paths option. (Read on for more information about configure
@@ -94,21 +93,14 @@ The following tools are needed to build OpenAFS from source from a tar file:
 - ranlib
 - lex/yacc
 - install
+- perl 5.6 or better (only to build the documention)
 
-The following tools are needed to build OpenAFS from source from a git
-checkout:
+In addtion to the above, the following tools are needed to build OpenAFS 
+from a git checkout:
 
 - git
-- autoconf v2.60 or better
+- autoconf 2.60 or better
 - automake
-- perl v5.6 or better 
-- make
-- compiler
-- assembler
-- linker
-- ranlib
-- lex/yacc
-- install
 
 The compiler used must be capable of building kernel modules for the target
 platform.
@@ -124,12 +116,12 @@ The following tools are needed to build OpenAFS RPMS:
 - perl 5.6 or better
 - rpmbuild
 
-The following development libraries are used to build OpenAFS:
+The following development libraries are needed:
 
 - libc
 - kerberos 5
-- ncurses
-- pam
+- ncurses (optional, needed to build scout/afsmonitor)
+- pam (optional)
 - kernel headers
 
 The ncurses libraries are needed to build the ncurses based admin tools
@@ -154,8 +146,20 @@ installed with the following yum commands,
 
 ### Solaris Packages
 
-XXX: Please add the solaris pgk names
+For Solaris packages, start by installing pkg-get, if you have not already.
+
+     $ wget http://www.opencsw.org/pkg-get
+     $ pkgadd -d /path/to/pkg-get
+     $ wget --output-document=/tmp/gpg.key http://www.opencsw.org/get-it/mirrors/
+     $ gpg --import /tmp/gpg.key
+
+Check to make sure pkg-get is installed properly by doing a pkg-get compare.
+It should output a list of installed packages compared to up-to-date remote packages.
+
+With pkg-get installed, go ahead and begin installing the necessary packages
 
+     $ pkg-get install gcc flex bison automake autoconf gmake
+     $ pkg-get install krb5_kdc ncurses
 
 ## Getting the Source Code
 
@@ -387,7 +391,7 @@ The makesrpm.pl requires the source and document tar archive files. If you
 are building from a git repository, first create the source and document
 archive files.
 
-    $ git clone git://git.sinenomine.net/openafs.git openafs-<version>
+    $ git clone git://git.openafs.org/openafs.git openafs-<version>
     $ cd openafs-<version>
     $ git checkout <tagname>
     $ git describe >.version
@@ -398,6 +402,8 @@ archive files.
 
 where _version_ is the dotted OpenAFS version number, such as 1.6.0,
 and _tagname_ is the git tag for the version, such as openafs-stable-1_6_0.
+The _version_ number for pre-releases are suffixed with pre<number>. For example,
+to build 1.6.0pre5, create a directory called openafs-1.6.0pre5.
 
 Next run makesrpm.pl to build the source RPM, and then use rpmbuild to
 build the binaries and packages. The resulting packages will be located