mirror of https://github.com/mkerrisk/man-pages
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:
parent
e01dc26ae7
commit
836a436804
56
README
56
README
|
@ -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 >.
|
||||||
|
|
Loading…
Reference in New Issue