README: Update generally

* Reflect fact that project ships pages in sections 1-8.

    * Resync documentation of the basic Makefile targets with what they
      actually do at present.  Slighly simplify discussion.

    * Put the man page overlaps into a table.
      + Drop references to overlaps with the old a.out ld.so, long dead.

    * Update reference to Announce file to use current naming convention.
      + Send people looking for copyright information there rather than
        duplicating some of it here.

    * Direct reader to the top-level homepage instead of more deeply to the
      "Contributing" page.

    * Reflow paragraphs to 72 columns.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
G. Branden Robinson 2017-05-10 18:39:58 -04:00 committed by Michael Kerrisk
parent e01dc26ae7
commit 836a436804
1 changed files with 30 additions and 26 deletions

56
README
View File

@ -1,33 +1,37 @@
This package contains Linux man pages for sections This package contains Linux man pages for sections 1 through 8. Some
2, 3, 4, 5, and 7. Some more information is given in the more information is given in the 'man-pages-x.y.Announce' file.
`Announce' file.
Install by copying to your favourite location. Installing and uninstalling
"make install" will just copy them to /usr/share/man/man[1-8]. ===========================
To install to a path different from /usr use "make install" will copy these man pages to /usr/share/man/man[1-8].
To install to a path different from /usr, use
"make install prefix=/install/path". "make install prefix=/install/path".
"make" will move the pages from this package that are older than
the already installed ones to a subdirectory `not_installed',
then remove old versions (compressed or not),
compress the pages, and copy them to /usr/share/man/man[1-8].
"make remove" or "make uninstall" will remove any man page in this
distribution from its destination. Use with caution, and remember to
use "prefix" if desired, as with the "install" target.
Note that you may have to remove preformatted pages. "make" or "make all" will perform "make uninstall" followed by "make
install".
Note that sometimes these pages are duplicates of pages Man page overlap and duplication
also distributed in other packages. This has been reported ================================
about dlclose.3, dlerror.3, dlopen.3, dlsym.3 (found in ld.so), Note that sometimes these pages are duplicates of pages also distributed
about resolver.3, resolv.conf.5 (found in bind-utils), in other packages. This has been reported about:
and about passwd.5, and mailaddr.7. Be careful not to
overwrite more up-to-date versions.
Reports on further duplicates are welcome.
Formerly present and now removed duplicates:
exports.5 (found in nfs-server-2.2*),
fstab.5, nfs.5 (found in util-linux-2.12*),
lilo.8, lilo.conf.5 (found in lilo-21.6*).
Copyrights: These man pages come under various copyrights. man page also found in
All pages are freely distributable when the nroff source is included. -------------------------------------
resolver.3 bind-utils, bind9utils
resolv.conf.5 "
passwd.5 shadow, passwd
mailaddr.7 ?
If you have corrections and additions to suggest, see Copyrights
http://www.kernel.org/doc/man-pages/contributing.html ==========
See the 'man-pages-x.y.Announce' file.
Homepage
========
For much more about the Linux man-pages project, see
< http://www.kernel.org/doc/man-pages/index.html >.