doc: update README

README

@@ -29,9 +29,7 @@ What will chrony run on?
 
 The software is known to work on Linux, FreeBSD, NetBSD, macOS and
 Solaris.  Closely related systems may work too.  Any other system will
-likely require a porting exercise.  You would need to start from one
+likely require a porting exercise.
-of the existing system-specific drivers and look into the quirks of
-certain system calls and the kernel on your target system.
 
 How do I set it up?
 ===================
@@ -55,24 +53,20 @@ Where are new versions announced?
 =================================
 
 There is a low volume mailing list where new versions and other
-important news relating to chrony is announced.  You can join this list
+important news relating to chrony are announced.  You can join this list
 by sending mail with the subject "subscribe" to
 
 chrony-announce-request@chrony.tuxfamily.org
 
-These messages will be copied to chrony-users (see below).
-
 How can I get support for chrony?
-and where can I discuss new features, possible bugs etc?
+=================================
-========================================================
 
-There are 3 mailing lists relating to chrony.  chrony-announce was
+There are two other mailing lists relating to chrony.  chrony-users is a
-mentioned above.  chrony-users is a users' discussion list, e.g. for
+discussion list for users, e.g. for questions about chrony configuration
-general questions and answers about using chrony.  chrony-dev is a more
+and bug reports.  chrony-dev is a more technical list for developers,
-technical list, e.g. for discussing how new features should be
+e.g. for submitting patches and discussing how new features should be
-implemented, exchange of information between developers etc.  To
+implemented.  To subscribe to either of these lists, send a message with
-subscribe to either of these lists, send a message with the subject
+the subject "subscribe" to
-"subscribe" to
 
 chrony-users-request@chrony.tuxfamily.org
 or
@@ -80,12 +74,6 @@ chrony-dev-request@chrony.tuxfamily.org
 
 as applicable.
 
-When you are reporting a bug, please send us all the information you can.
-Unfortunately, chrony has proven to be one of those programs where it is very
-difficult to reproduce bugs in a different environment. So we may have to
-interact with you quite a lot to obtain enough extra logging and tracing to
-pin-point the problem in some cases. Please be patient and plan for this!
-
 License
 =======
 
@@ -100,12 +88,13 @@ Miroslav Lichvar <mlichvar@redhat.com>
 Acknowledgements
 ================
 
-In writing the chronyd program, extensive use has been made of RFC 1305
+In writing the chronyd program, extensive use has been made of the NTPv3 (RFC
-and RFC 5905, written by David Mills. The source code of the NTP reference
+1305) and NTPv4 (RFC 5905) specification.  The source code of the xntpd/ntpd
-implementation has been used to check the details of the protocol.
+implementation written by Dennis Fergusson, Lars Mathiesen, David Mills, and
+others, has been used to check the details of the protocol.
 
 The following people have provided patches and other major contributions
-to the program :
+to chrony:
 
 Lonnie Abelbeck <lonnie@abelbeck.com>
 Benny Lyne Amorsen <benny@amorsen.dk>
@@ -121,6 +110,7 @@ Bryan Christianson <bryan@whatroute.net>
 Juliusz Chroboczek <jch@pps.jussieu.fr>
 Christian Ehrhardt <christian.ehrhardt@canonical.com>
 Paul Elliott <pelliott@io.com>
+Robert Fairley <rfairley@redhat.com>
 Stefan R. Filipek <srfilipek@gmail.com>
 Mike Fleetwood <mike@rockover.demon.co.uk>
 Alexander Gretencord <arutha@gmx.de>