]> git.sur5r.net Git - openldap/blobdiff - README
Update for 2.2.beta3
[openldap] / README
diff --git a/README b/README
index ae7880fa74e3ee3e61dcbc669192fdda02caa143..ffe2e5837a64798832d9bbe8dcce4851bce8b12b 100644 (file)
--- a/README
+++ b/README
@@ -1,89 +1,96 @@
-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.
+OpenLDAP 2.2 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.
 
-       Additional developer documents are available in doc/devel,
-               todo list
-               guidelines for developers
+    This is 2.2 release, it includes significant changes from
+    prior releases.
 
-       Client developers seeking a stable development platform
-       should use -stable or the latest OpenLDAP release.
-
-       The OpenLDAP Developer's FAQ is available at:
-               http://www.openldap.org/faq/index.cgi?file=4
-
-
-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.
+REQUIRED SOFTWARE
+    Build OpenLDAP requires a number of software packages to be
+    preinstalled.  Additional information regarding prerequisite
+    software can be found in the OpenLDAP Administrator's Guide.
 
-       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.
+    Base system (libraries and tools):
+        Standard C compiler (required)
+        Cyrus SASL 2.1.16+ (recommended)
+        OpenSSL 0.9 (recommended)
+        POSIX REGEX software (required)
 
-       For more information:
-               http://www.OpenLDAP.org/software/
+    SLAPD:
+        BDB backend requires Sleepycat Berkeley DB 4.2
+        LDBM backend requires a compatible database manager
+            [Berkeley DB, GDBM, etc.]
 
+    SLURPD:
+        LTHREAD compatible thread package
+            [POSIX threads, Mach Cthreads, select others]
 
-REQUIRED SOFTWARE
-       Build OpenLDAP requires the following software components:
+    CLIENTS/CONTRIB ware:
+        Depends on package.  See per package README.
 
-       Base system (libraries and tools):
-               Standard C compiler, headers, and libraries
-               POSIX REGEX headers and libraries
 
-       SLAPD:
-               LDBM compatible datastore
-                       (Sleepycat Berkeley DB 2.7.5 or GDBM)
+MAKING AND INSTALLING THE DISTRIBUTION
+    Please see the INSTALL file for basic instructions.  More
+    detailed instructions can be found in the OpenLDAP
+    Admnistrator's Guide (see DOCUMENTATION section).
 
-       SLURPD:
-               LTHREAD compatible thread package
-                       (POSIX pthreads, MIT pthreads, Mach Cthreads or Sun LWP)
 
-       CLIENTS/CONTRIB ware:
-               Depends on package.  See per package README.
-               
+DOCUMENTATION
+    There are man pages for most programs in the distribution and
+    routines in the various libraries.  See ldap(3) for details.
 
-MAKING AND INSTALLING THE DISTRIBUTION
-       Please see the INSTALL file for details.
+    The OpenLDAP website is available and contains the latest LDAP
+    news, releases announcements, pointers to other LDAP resources,
+    etc..  It is located at:
+        http://www.OpenLDAP.org/
 
+    The OpenLDAP Administrator's Guide and other documentation
+    is available at:
+        http://www.openldap.org/doc/
 
-DOCUMENTATION
-       There are man pages for most programs in the distribution and
-       routines in the various libraries.  See ldap(3) for details.
+    The OpenLDAP Software FAQ is available at:
+        http://www.openldap.org/faq/index.cgi
 
-       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/
+SUPPORT / FEEDBACK / PROBLEM REPORTS / DISCUSSIONS
+    OpenLDAP is user supported.  If you have problems, please
+    review the OpenLDAP FAQ <http://www.openldap.org/faq/> and
+    archives of the OpenLDAP-software and OpenLDAP-bugs mailing
+    lists <http://www.openldap.org/lists/>.  If you cannot find
+    the answer, please enquire on the OpenLDAP-software list.
 
-       The OpenLDAP Software FAQ is available at:
-               http://www.openldap.org/faq/index.cgi?file=2
+    Issues, such as bug reports, should be reported using our
+    our Issue Tracking System <http://www.OpenLDAP.org/its/>.
+    Do not use this system for software enquiries.  Please
+    direct these to an appropriate mailing list.
 
 
-FEEDBACK / PROBLEM REPORTS / DISCUSSIONS
-       We would appreciate any feedback you can provide.  If you have
-       problems, report them using our Issue Tracking System:
+CONTRIBUTING
+    See <http://www.openldap.org/devel/contributing.html> for
+    information regarding how to contribute code or documentation
+    to the OpenLDAP Project for inclusion in OpenLDAP Software.
+    While you are encouraged to coordinate and discuss the
+    development activities on the <openldap-devel@openldap.org>
+    mailing list prior to submission, it is noted that
+    contributions must be submitted using the Issue Tracking
+    System <http://www.openldap.org/its/> to be considered.
 
-               http://www.OpenLDAP.com/its/
+---
+$OpenLDAP$
 
-       or by sending e-mail to:
+This work is part of OpenLDAP Software <http://www.openldap.org/>.
 
-               OpenLDAP-its@OpenLDAP.org
+Copyright 1998-2003 The OpenLDAP Foundation.
+All rights reserved.
 
-       Additional mailing lists are available.  Please see:
+Redistribution and use in source and binary forms, with or without
+modification, are permitted only as authorized by the OpenLDAP
+Public License.
 
-               http://www.OpenLDAP.com/lists/
+A copy of this license is available in the file LICENSE in the
+top-level directory of the distribution or, alternatively, at
+<http://www.OpenLDAP.org/license.html>.
 
+OpenLDAP is a registered trademark of the OpenLDAP Foundation.