--- a/man.rst Sat Feb 20 15:20:24 2016 +0200
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,88 +0,0 @@
--*- mode: outline; coding: utf-8; -*-
-
-* Man sections.
-
- 1 Executable programs or shell commands.
- 2 System calls (functions provided by the kernel).
- 3 Library calls (functions within program libraries).
- 4 Special files (usually found in /dev).
- 5 File formats and conventions eg /etc/passwd.
- 6 Games.
- 7 Miscellaneous (including macro packages and conventions).
- 8 System administration commands (usually only for root).
-
-* Invoking man.
-
-** Search for prog, func, conf file.
-
- $ man [<section>] <item>
-
-** Search by specific keywords.
-
- $ man -k <keywords>
-
-** Throw Emacs.
-
- M-x man RET [<section>] <item>
-
- M-x man RET -k SPACE <keywords>
-
-* Sections order.
-
-NAME - brief prog description
-SYNOPSIS (USAGE) - command line options in BNF
-DESCRIPTION - long prog description
-OPTIONS - long option descriptions
-... misc sections ...
-EXAMPLES
-EXIT STATUS
-ENVIRONMENT
-AVAILABILITY - whare search source, where home page
-FILES - list of files that has effect on program working
-AUTHORS
-COPYRIGHT
-SEE ALSO
-BUGS - know issue, how report bug
-HISTORY
-
-* Man page showing.
-
-TODO
-Bolt by print char, back one char and print same char.
-Underscore by printing undescore, back one char and print char.
-
-* Development tools.
-
-To preview local man page:
-
- $ groff -man -Tascii foo.1 # 7-bit char
- $ groff -man -Tlatin1 foo.1 # 8-bit char
- $ groff -man -Tlatin1 foo.1 | less
- $ groff -a -mandoc -Tlatin1 e.1
- $ groff -man -Tutf8 foo.1
-
- $ man ./foo.1 # if slashes in path - use file
-
- $ mkdir man1
- $ cp foo.1 man1
- $ man -M . 1 foo # without slashes search in MANPATH item
- # and add /man1 to each item
-
-* Output format.
-
-** .txt.
-
- $ man foo | col -b >.foo.txt
-
-** .ps.
-
- $ groff -Tps foo >foo.ps
-
-** .ps.
-
- $ groff -Tps foo >foo.ps
-
-** .dvi.
-
- $ groff -Tdvi foo >foo.dvi
-