X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=INSTALL;h=1aaec4a207b968efecc1e2e4f1659bed046bd064;hb=e0fdd89432f922267269f276831ad1dc020ffdc0;hp=3e76e3a34fc5683a92189b59fb91e0ae77bf00b8;hpb=1963dde36da9084526d4b9d5689643f8721f2876;p=openldap

diff --git a/INSTALL b/INSTALL
index 3e76e3a34f..1aaec4a207 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,7 +1,16 @@
 Making and Installing the OpenLDAP Distribution
 
+**
 ** It is recommended that you read or at least skim through ALL of the
 ** instructions in this file before attempting to build the software.
+**
+** The OpenLDAP Installation FAQ is available at:
+**    http://www.openldap.org/faq/index.cgi?file=8
+**
+** You should also check for platform specific hints.
+** These are located in doc/install/hints or:
+**    http://www.openldap.org/faq/index.cgi?file=9
+**
 
 If you want to build binaries for more than one platform from a single
 source tree, skip ahead to the "Building LDAP For More Than One Platform"
@@ -32,7 +41,8 @@ these steps:
 		CC			C Compiler	(cc, ecgs)
 		CFLAGS		C Flags		(-ansi)
 		CPPFLAGS	CPP Flags	(-I/path/include -Ddef)
-		LDFLAGS		LDFLAGS		(-L/path/lib -llib)
+		LDFLAGS		LDFLAGS		(-L/path/lib)
+		LIBS		LIBS		(-llib)
 
 	See the 'USING ENVIRONMENT VARIABLES' section for information
 	on how to use the variables. 
@@ -59,26 +69,53 @@ these steps:
 	% make
 
     If all goes well, the system will build as configured.  If not,
-	return to step 4 after reviewing the enable/with options settings.
-	
- 7. install the binaries and man pages.  You may need to be superuser to
+	return to step 4 after reviewing the configuration settings.
+
+	You may want to consult the doc/install/hints file for your
+	platform.
+
+ 7. Test the standalone system
+
+	This step requires the standalone LDAP server (slapd) with
+	LDBM support.
+
+	% cd tests
+	% make
+
+	If all goes well, the system has been built as configured.  If not,
+	return to step 4 after reviewing your configuration settings.
+
+	You may want to consult the doc/install/hints file for your
+	platform.
+
+ 8. install the binaries and man pages.  You may need to be superuser to
     do this (depending on where you are installing things):
 
 	% su
 	# make install
 
-    That's it!  See the man pages for the individual clients for information
-    on configuring and using them.  Eventually you will probably want to
-    edit the configuration files used by the various clients (installed in
-    the LDAP etc directory).  The files are:
+    That's it!
 
+	See the man pages for the individual applications for
+	information on configuring and using them.  You may also want
+	to edit the configuration files used by the various clients.
+	These configuration files are located in the OpenLDAP
+	configuration directory (normally /usr/local/etc/openldap).
+
+	ldap.conf            - LDAP defaults
 	ldapfilter.conf      - search filter configuration
-	ldapfriendly         - mapping of X.500 names to human-friendly names
 	ldapsearchprefs.conf - search object definitions
 	ldaptemplates.conf   - display template definitions
 
     There are section 5 man pages for all of these files.
 
+ 9. edit client configuration files as needed.
+	See ldap.conf(5) for details.
+
+10. edit server configuration files as needed.
+	See slapd.conf(5) if running slapd.
+	See ldapd.conf(5) if running ldapd.
+
 
 Building LDAP For More Than One Platform
 
@@ -111,7 +148,9 @@ Follow these steps for each different platform:
 CONFIGURE OPTIONS
 
 Regrettably, this section has not been written (yet).  See
-"./configure --help" for current list of options.
+"./configure --help" for current list of options.  For general
+information about how to use "configure", please read:
+	doc/install/configure
 
 
 USING ENVIRONMENT VARIABLES
@@ -120,11 +159,15 @@ The configure script will also use your environmental
 variables for determining compiler/linker options.   This can
 be used to manual specify features and compilation options.
 
+NOTE: If you change environment setting, be sure to remove
+	any config.cache before running ./configure.
+
 Supported Environmental Variables
-	CC			C Compiler		(cc, ecgs)
-	CFLAGS		C Flags			(-ansi)
-	CPPFLAGS	CPP Flags		(-I/path/include -Ddef)
-	LDFLAGS		LDFLAGS			(-L/path/lib -llib)
+	CC			C compiler		(cc, egcc)
+	CFLAGS		C flags			(-ansi)
+	CPPFLAGS	cpp flags		(-I/path/include -Ddef)
+	LDFLAGS		ld flags		(-L/usr/local/lib)
+	LIBS		libraries		(-llib)
 	PATH		command path	/usr/local/bin:/usr/bin:/bin
 
 * Including alternative compilers
@@ -132,13 +175,13 @@ Supported Environmental Variables
 	use a specific compiler.  For example, to use ecgs
 	instead of the compiler configure choose, use:
 
-	[env] CC=ecgs ./configure 
+	[env] CC=egcc ./configure 
 
 	You can also use CC use specific flags with the
 	specified compiler.  For example, to require strict
 	ANSI C using the GNU C Compiler, use:
 
-	[env] CC="gcc -ansi -predantic" ./configure
+	[env] CC="gcc -ansi -pedantic" ./configure
 
 	(you can use CFLAGS to specify compiler flags)
 
@@ -174,7 +217,9 @@ Supported Environmental Variables
 
 HINTS
 
-* use software under installed in /usr/local/{include,lib}
+* Platform specific hints are available in doc/install/hints.
+
+* Use software under installed in /usr/local/{include,lib}
 	[env] \
 		CPPFLAGS="-I/usr/local/include" \
 		LDFLAGS="-L/usr/local/lib" \