X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=README;h=3751f6918d7ac0d8a28ada9e8007103fa5c2f6a3;hb=4e733cf0248a8e0c876365893f9af5eed8910289;hp=1236676d417fc2aeeaa1c350cb0828e6c85f2778;hpb=2a869f5a99f537b246ba8640502e2a86117cb6e8;p=openldap

diff --git a/README b/README
index 1236676d41..3751f6918d 100644
--- a/README
+++ b/README
@@ -1,33 +1,61 @@
-OpenLDAP 1.0 README
+OpenLDAP Devel README
+	OpenLDAP -devel is for the development of OpenLDAP.  As such,
+	it changes often.  These changes include changes in functionality
+	and unproven bug fixes.  Many of these changes will cause
+	previous working programs to fail.
 
-    This is the OpenLDAP version 1.0 distribution.
+	Additional developer documents are available in doc/devel,
+		todo list
+		guidelines for developers
+
+	Client developers seeking a stable development platform
+	should use -stable or the latest OpenLDAP release.
+
+
+OpenLDAP 1.1.1 README
+	This is the OpenLDAP Release 1.1.1.
 
 	For a description of what this distribution contains, see the
 	ANNOUNCEMENT file in this directory.  For a description of
 	changes from previous releases, see the CHANGES file in this
-	directory.  For a more detailed description of how to make an
-	install the distribution, see the INSTALL file in this directory.
+	directory.
+
+	For a more detailed description of how to make an install the
+	distribution, see the INSTALL file in this directory.  Additional
+	installation information, such as per platform hints can be found
+	in the doc/install directory.
 
 	For more information:
-		http://www.OpenLDAP.org/
+		http://www.OpenLDAP.org/software/
 
-MAKING AND INSTALLING THE DISTRIBUTION
 
-    You should be able to make and install the distribution with a pretty
-    standard default configuration by typing the following commands
+REQUIRED SOFTWARE
+	Build OpenLDAP requires the following software components:
+
+	Base system (libraries and tools):
+		Standard C compiler, headers, and libraries
+		POSIX REGEX headers and libraries
+
+	SLAPD:
+		LDBM compatible datastore
+			(Sleepycat Berkeley DB 2.3.16 or GDBM)
+
+	SLURPD:
+		LTHREAD compatible thread package
+			(POSIX pthreads, MIT pthreads, Mach Cthreads or Sun LWP)
 
-	% ./configure --help
-		This will list the available options.
-		The configure script will also use your environmental
-		variables for determining compiler/linker options.
-		These environment variables are used:
-			CC			C compiler	(cc, ecgs)
-			CFLAGS		C Flags		(-ansi)
-			CPPFLAGS	CPP Flags	(-I -D)
-			LDFLAGS		LDFLAGS		(-L -l)
+	LDAPD:
+		ISODE compatible X.500 distribution
 
-	% [env settings] ./configure [options]
-		this will configure the build system
+	CLIENTS/CONTRIB ware:
+		Depends on package.  See per package README.
+		
+
+MAKING AND INSTALLING THE DISTRIBUTION
+	This is a quick guide.  For details, see the INSTALL file.
+
+	% ./configure
+		configure OpenLDAP for current platform
 
 	% make depend
 		this will create dependency information
@@ -38,33 +66,43 @@ MAKING AND INSTALLING THE DISTRIBUTION
 	% su
 	# make install
 
-    in this directory.  This should produce something that basically
-    works.
+	in this directory.  This should produce something that basically
+	works.  You can "cd tests; make" to verify the build.
 
-    You will probably want to do a little configuration to suit your
-    site, though.  There are one file you might want to edit:
+	See the INSTALL file in this directory for more information.
 
-	include/ldapconfig.h.edit
-		This file contains #defines used by many parts of the
-		distribution.  You'll at least want to change DEFAULT_BASE.
-
-    See the INSTALL file in this directory for more information.
 
 DOCUMENTATION
+	There are man pages for most programs in the distribution and
+	routines in the various libraries.  See ldap(3) for details.
+
+	Additional documentation can be found in the doc directory.
+		doc/devel   Developer Information
+		doc/drafts  LDAP-related IETF drafts
+		doc/install Installation and Integration
+		doc/man     Raw man(1) pages
+		doc/rfcs    LDAP-related Request for Comments
+
+	There is an OpenLDAP home page available that contains the latest
+	LDAP news, releases announcements, pointers to other LDAP resources,
+	etc..  It is located at:
+		http://www.OpenLDAP.org/
 
-    There are man pages for most programs in the distribution and
-    routines in the various libraries.  See ldap(3) for details.
-
-    There is an OpenLDAP homepage available that contains the latest
-    LDAP news, releases announcements, pointers to other LDAP resources,
-    etc. You can access it at this URL:
+	The OpenLDAP Software FAQ is available at:
+		http://www.openldap.org/faq/index.cgi?file=2
 
-	http://www.OpenLDAP.org/
 
 FEEDBACK / PROBLEM REPORTS / DISCUSSIONS
+	We would appreciate any feedback you can provide.  If you have
+	problems, report them using our Issue Tracking System:
+
+		http://www.OpenLDAP.com/its/
+
+	or by sending e-mail to:
+
+		OpenLDAP-its@OpenLDAP.org
 
-    We would appreciate any feedback you can provide.  If you have
-    problems, report them to this address:
+	Additional mailing lists are available.  Please see:
 
-	OpenLDAP-bugs@OpenLDAP.org
+		http://www.OpenLDAP.com/lists/