db_dump.o depends on budb_errs.h
[openafs.git] / README
diff --git a/README b/README
index 0b537e8..393f475 100644 (file)
--- a/README
+++ b/README
@@ -27,7 +27,7 @@ A  Configuring
    source in, you will only have an src/ directory.
 
    1. Pick a system to build for, and note its default AFS sys_name.
-      A directory will be automatically created for binaries to be written 
+      A directory will be automatically created for binaries to be written
       into with this name when you build.
 
       alpha_dux40, alpha_dux50, alpha_dux51 (client does not work)
@@ -68,11 +68,10 @@ A  Configuring
       sgi_62, sgi_63, sgi_64, sgi_65 (file server not tested)
       sparc64_linux22, sparc64_linux24, sparc64_linux26
       sparc_linux22, sparc_linux24
-      sun4_413 (No client support, no fileserver support, db servers only)
-      sun4x_56, sun4x_57, sun4x_58, sun4x_59, sun4x_510, sun4x_511
+      sun4x_58, sun4x_59, sun4x_510, sun4x_511
          (logging UFS not supported for mixed-use partitions containing
          client cache)
-      sunx86_57, sunx86_58, sunx86_59, sunx86_510, sunx86_511
+      sunx86_58, sunx86_59, sunx86_510, sunx86_511
          (logging UFS not supported for mixed-use partitions containing
          client cache)
       x86_darwin_80, x86_darwin90
@@ -145,18 +144,18 @@ A  Configuring
 
 B  Building
 
-   1. Now, you can build OpenAFS. 
+   1. Now, you can build OpenAFS.
 
       % make
 
-   2. Install your build using either "make install" to install 
+   2. Install your build using either "make install" to install
       into the current system (you will need to be root, and files
       will be placed as appropriate for Transarc or standard paths),
-      "make install DESTDIR=/some/path" to install into an alternate 
+      "make install DESTDIR=/some/path" to install into an alternate
       directory tree, or if you configured with --enable-transarc-paths
-      make dest to create a complete binary tree in the dest directory      
+      make dest to create a complete binary tree in the dest directory
       under the directory named for the sys_name you built for,
-      e.g. sun4x_57/dest or i386_linux22/dest 
+      e.g. sun4x_57/dest or i386_linux22/dest
 
    3. As appropriate you can clean up or, if you're using Linux, build for
       another kernel version.
@@ -168,7 +167,7 @@ B  Building
 C  Problems
 
    If you have a problem building this source, you may want to visit
-   http://www.openafs.org/ to see if any problems have been reported 
+   http://www.openafs.org/ to see if any problems have been reported
    or to find out how to get more help.
 
    Mailing lists have been set up to help; More details can be found
@@ -200,7 +199,7 @@ D  Linux Notes
 
       % ./configure --with-afs-sysname=<sysname> \
           --with-linux-kernel-headers=/usr/src/linux-2.2.19-i686
-      % make 
+      % make
 
    Your build tree will now include an additional kernel module for your
    additional kernel headers. Be aware that if the kernel version string
@@ -246,9 +245,9 @@ G  FreeBSD Notes
 
    You also need access to your kernel build directory for the opt_global.h
    include file.  Use the --with-bsd-kernel-build= configure option if your
-   kernel build is not GENERIC in the standard place. If 
-   /usr/src/sys/${CPUARCH}/compile/GENERIC does not point to 
-   /usr/obj/usr/src/sys/GENERIC you may need to resolve that and retry the 
+   kernel build is not GENERIC in the standard place. If
+   /usr/src/sys/${CPUARCH}/compile/GENERIC does not point to
+   /usr/obj/usr/src/sys/GENERIC you may need to resolve that and retry the
    build.
 
    There is no server package, but I am told that "make install" will put
@@ -411,6 +410,9 @@ I  Other configure options
        the kernel headers).  The SYSNAME should be one of the options
        listed in A2.
 
+   --with-gssapi=DIR
+   --with-gssapi-include=DIR
+   --with-gssapi-lib=DIR
    --with-krb5[=DIR]
    --with-krb5-include=DIR
    --with-krb5-lib=DIR
@@ -429,6 +431,27 @@ I  Other configure options
        Autoconf can't figure out whether to use lib, lib32, or lib64 on
        your platform.
 
+       --with-gssapi is similar, except for the GSS-API libraries instead
+       of the Kerberos libraries.  If you have to manually set the
+       location of the Kerberos libraries, you may need to do the same
+       thing for the GSS-API libraries.
+
+   --with-libintl=DIR
+   --with-libintl-include=DIR
+   --with-libintl-lib=DIR
+       Specifies the install location of the libintl library, used for
+       internationalization, or separately specifies the location of the
+       header files and libraries.  By default, the default system library
+       paths will be searched.  This library is not required on many
+       platforms.
+
+   --with-roken=PATH
+   --with-roken=internal
+       Specifies the install location of the libroken library.  Specify
+       "internal" to use the embedded libroken library that comes with
+       OpenAFS (the default).  This option is primarily useful for
+       building against a system libroken library if you have one.
+
    --with-linux-kernel-build=PATH
    --with-linux-kernel-headers=PATH
    --with-bsd-kernel-build=PATH
@@ -443,10 +466,27 @@ I  Other configure options
        rather than libafs-<VERSION>.ko, which is easier to handle in Linux
        distribution init scripts.
 
+   --with-docbook2pdf=PROGRAM
+       Specifies the program used to convert the DocBook manuals to PDF.
+       Supported choices are fop, dblatex, and docbook2pdf.  By default,
+       the user's path is searched for those programs in that order, and
+       the first one found is used.
+
+   --with-docbook-stylesheets=PATH
+       The location of the DocBook style sheets, used to convert the
+       DocBook manuals to other formats.  By default, a set of likely
+       paths are searched.
+
    --with-html-xsl=PATH
+       Specifies the XSLT style sheet to convert DocBook manuals into
+       HTML.  The default is html/chunk.xsl.  You may wish to use
+       html/docbook.xsml instead.
+
    --with-xslt-processor=PROGRAM
-       Specifies the XSLT style sheet and XSLT processor to use to convert
-       the DocBook manuals into HTML.
+       Specifies the XSLT processor to use to convert the DocBook manuals
+       into HTML.  Supported choices are libxslt, saxon, xalan-j, and
+       xsltproc.  By default, the user's path is searched for those
+       programs in that order, and the first one found is used.
 
    There are also some environment variables that you can set to control
    aspects of the build.  They can be set either on the configure command