X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=README;h=1e0f924e213f7861f2cc97999122b1e3d2a77963;hb=598b7473fea63177f65d94a354a9336c6d136097;hp=58d9dd856b726459d7cfe6b51c2196ae30e6a176;hpb=f514d287f7ae4c8d778201d679e4898c63cecca9;p=openldap

diff --git a/README b/README
index 58d9dd856b..1e0f924e21 100644
--- a/README
+++ b/README
@@ -1,76 +1,89 @@
-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 Release README
 	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/
+
+
+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)
+
+	LDAPD:
+		ISODE compatible X.500 distribution
+
+	CLIENTS/CONTRIB ware:
+		Depends on package.  See per package README.
+		
 
 MAKING AND INSTALLING THE DISTRIBUTION
+	Please see the INSTALL file for details.
 
-    You should be able to make and install the distribution with a pretty
-    standard default configuration by typing the following commands
-
-	% cp Make-common.dist to Make-common
-		Note: if using gmake, instead copy Make-common.gmake to Make-common
-		Edit Make-common as desired.
-	% make 
-		this will build the system
-	% su
-	# make install
-
-    in this directory.  This should produce something that basically
-    works.
-
-    You will probably want to do a little configuration to suit your
-    site, though.  There are two files you might want to edit:
-
-	Make-common.dist
-		contains distribution defaults.  This file is used to
-		contruct Make-common and should not be edited except to
-		add new features/options to the distribution.
-	
-	Make-common.gmake
-		contains distribution defaults (with GNU make compatibility).
-		This file can be used to contruct Make-common and should not
-		be edited except to add new features/options to the distribution.
-
-	Make-common
-		contains default definitions for where things will be
-		installed, where to find various things, etc.  These defaults
-		are used in absense of platform-specific defaults.  You may
-		hardcode settings in Make-common if you desire.  You will
-		need to edit this file to enable optional features.
-
-	build/*/Make-platform
-		contains platform-specific defaults.
-
-	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/