]> git.sur5r.net Git - openldap/blobdiff - README
Prepare for release
[openldap] / README
diff --git a/README b/README
index fb8dd8ab366791e60ce7022fad46c7347166590a..b507a5f180cc36554188d7191225136e76369da8 100644 (file)
--- a/README
+++ b/README
@@ -1,59 +1,96 @@
-UM-LDAP 3.3 README file
+OpenLDAP 2.3 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.
 
-    This is the UM-LDAP version 3.3 distribution.  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 and install the distribution, see the
-    INSTALL file in this directory.  For more information on making and
-    installing slapd, see the "SLAPD and SLURPD Administrator's Guide"
-    in the doc/guides/ directory.
+    This is 2.3 release, it includes significant changes from prior
+    releases.
 
-MAKING AND INSTALLING THE DISTRIBUTION
+REQUIRED SOFTWARE
+    Building OpenLDAP Software requires a number of software packages
+    to be preinstalled.  Additional information regarding prerequisite
+    software can be found in the OpenLDAP Administrator's Guide.
 
-    You should be able to make and install the distribution with a pretty
-    standard default configuration by typing the following commands
+    Base system (libraries and tools):
+        Standard C compiler (required)
+        Cyrus SASL 2.1.18+ (recommended)
+        OpenSSL 0.9.7+ (recommended)
+        POSIX REGEX software (required)
 
-       % make
-       % su
-       # make install
+    SLAPD:
+        BDB and HDB backends require Oracle Berkeley DB 4.2, 4.4,
+        or 4.5.  It is highly recommended to apply the patches
+        from Oracle for a given release.
 
-    in this directory.  This should produce something that basically
-    works.
+    SLURPD:
+        LTHREAD compatible thread package
+            [POSIX threads, Mach Cthreads, select others]
 
-    You will probably want to do a little configuration to suit your
-    site, though.  There are two files you might want to edit:
+    CLIENTS/CONTRIB ware:
+        Depends on package.  See per package README.
 
-       Make-common                This file contains definitions for
-                                  where things will be installed, where
-                                  to find various things, etc.  If you
-                                  want to build an ldap server, you'll
-                                  definitely need to edit this file
 
-       include/ldapconfig.h.edit  This file contains #defines used
-                                  by many parts of the distribution.
-                                  You'll at least want to change
-                                  DEFAULT_BASE.
+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).
 
-    See the INSTALL file in this directory for more information.
 
 DOCUMENTATION
+    The OpenLDAP Administrator's Guide is available in the
+    guide.html file in the doc/guide/admin directory.  The
+    guide and a number of other documents are available at
+    <http://www.openldap.org/doc/admin/guide.html>.
+
+    The distribution also includes manual pages for most programs
+    and library APIs.  See ldap(3) 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 Software FAQ is available at
+    <http://www.openldap.org/faq/>.
+
+
+SUPPORT / FEEDBACK / PROBLEM REPORTS / DISCUSSIONS
+    OpenLDAP Software 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.
+
+    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.
+
 
-    There are man pages for most programs in the distribution and
-    routines in the various libraries.  See ldap(3) for details.
+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.
 
-    There is a postscript version of an administrator's guide for
-    slapd in doc/guides/slapd.ps.
+---
+$OpenLDAP$
 
-    There is an LDAP homepage available that contains the latest
-    LDAP news, releases announcements, pointers to other LDAP resources,
-    etc. You can access it at this URL:
+This work is part of OpenLDAP Software <http://www.openldap.org/>.
 
-       http://www.umich.edu/~rsug/ldap/
+Copyright 1998-2007 The OpenLDAP Foundation.
+All rights reserved.
 
-FEEDBACK / PROBLEM REPORTS
+Redistribution and use in source and binary forms, with or without
+modification, are permitted only as authorized by the OpenLDAP
+Public License.
 
-    We would appreciate any feedback you can provide.  If you have
-    problems, report them to this address:
+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>.
 
-       ldap-support@umich.edu
+OpenLDAP is a registered trademark of the OpenLDAP Foundation.