Imported Upstream version 1.8.7
[debian/sudo] / README
diff --git a/README b/README
index 4986b56aaf2ab72f4d14eb73e2fb6e7e2b7de50e..e6b67df0086198fa551eb26409715dfb2659dbef 100644 (file)
--- a/README
+++ b/README
@@ -1,5 +1,3 @@
-This is Sudo version 1.6.9
-
 The sudo philosophy
 ===================
 Sudo is a program designed to allow a sysadmin to give limited root privileges
@@ -9,49 +7,32 @@ privileges as possible but still allow people to get their work done.
 Where to find sudo
 ==================
 Before you try and build sudo, *please* make sure you have the current
-version.  The latest sudo may always be gotten via anonymous ftp
-from ftp.sudo.ws in the directory /pub/sudo/.
-The distribution is sudo-M.m.tar.gz where `M' is the major
-version number and `m' is the minor version number.
-BETA versions of sudo may also be available.  If you join
-the `sudo-workers' mailing list you will get the BETA announcements
-(see the `Mailing lists' section below).
+version.  The latest sudo may always be gotten via anonymous ftp from
+ftp.sudo.ws in the directory /pub/sudo/ or from the sudo web site,
+http://www.sudo.ws/
+
+The distribution is sudo-M.m.tar.gz where `M' is the major version
+number and `m' is the minor version number.  BETA versions of sudo may
+also be available.  If you join the `sudo-workers' mailing list you
+will get the BETA announcements (see the `Mailing lists' section below).
 
 What's new
 ==========
-For a history of sudo please see the HISTORY file that came with this
-release.
-
-For a complete list of changes, see the CHANGES file.  For a summary,
-see the web page, http://www.sudo.ws/sudo/.
+See the NEWS file for a list of major changes in this release.
+For a complete list of changes, see the ChangeLog file.  For a
+summary of major changes to the current stable release, see the web
+page, http://www.sudo.ws/sudo/stable.html.
 
 If you are upgrading from an earlier version of Sudo, please see
-the UPGRADE file.
+the UPGRADE file in the doc directory.
 
-NOTE: Starting with sudo 1.5.7 the configuration method has changed
-      significantly as compared to previous versions.  All options
-      are now set via the configure script.  See the `INSTALL' file
-      for a list of all the configure options.
-
-System requirements
-===================
-To build sudo from the source distribution you need a machine running
-UN*X (most flavors of BSD, SYSV, or POSIX will do), a working C
-compiler, and the make utility.
-
-If you wish to modify the parser then you will need flex version
-2.5.2 or later and either bison or byacc (sudo comes with a pre-flex'd
-tokenizer and pre-yacc'd grammar parser).  You'll also have to
-uncomment a few lines from the Makefile or run configure with the
---with-devel option.  You can get flex via anonymous ftp from
-ftp://ftp.ee.lbl.gov/pub/flex* as well as any GNU mirror.  You can
-get GNU bison from ftp://ftp.gnu.org/pub/gnu/bison/ or any GNU
-mirror.
+For a history of sudo please see the HISTORY file in the doc directory.
+You can find a list of contributors to sudo in the doc/CONTRIBUTORS file.
 
 Building the release
 ====================
-Please read the installation guide in the `INSTALL' file before
-trying to build sudo.
+Please read the installation guide in the `INSTALL' file before trying to
+build sudo.  Pay special attention to the "OS dependent notes" section.
 
 Copyright
 =========
@@ -70,6 +51,10 @@ sudo-users   This list is for questions and general discussion about sudo.
 sudo-workers   This list is for people working on and porting sudo.
                http://www.sudo.ws/mailman/listinfo/sudo-workers
 
+sudo-commits   This list receives a message for each commit made to
+               the sudo source repository.
+               http://www.sudo.ws/mailman/listinfo/sudo-commits
+
 To subscribe to a list, visit its url (as listed above) and enter
 your email address to subscribe.  Digest versions are available but
 these are fairly low traffic lists so the digest versions are not
@@ -80,17 +65,16 @@ for the appropriate links.
 
 Web page
 ========
-There is a sudo `web page' at http://www.sudo.ws/sudo/
-that contains an overview of sudo as well as pointers to BETA versions
-and other useful info.
+There is a sudo web page at http://www.sudo.ws/ that contains an
+overview of sudo, documentation, downloads, a bug tracker, information
+about beta versions and other useful info.
 
 Bug reports
 ===========
-A list of known bugs may be found in the `BUGS' file.  If you have
-found what you believe to be a bug, you can file a bug report with
-the sudo bug database, on at web at http://www.sudo.ws/bugs/.
+If you have found what you believe to be a bug, you can file a bug
+report in the sudo bug database, on the web at http://www.sudo.ws/bugs/.
 
-Please read over the `TROUBLESHOOTING' file *before* submitting a
-bug report.  When reporting bugs, please be sure to include the
-version of sudo you are using as well as the platform you are running
+Please read over the `TROUBLESHOOTING' file in the doc directory *before*
+submitting a bug report.  When reporting bugs, please be sure to include
+the version of sudo you are using as well as the platform you are running
 it on.