diff -r 78357d58b7ab -r fba288d59662 man.rst
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/man.rst	Mon Feb 22 12:46:36 2016 +0200
@@ -0,0 +1,97 @@
+.. -*- coding: utf-8; -*-
+.. include:: HEADER.rst
+
+===========
+ Man pages
+===========
+.. contents::
+   :local:
+
+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>
+
+Viewing inside 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
+=============
+
+Plain text::
+
+  $ man foo | col -b >.foo.txt
+
+PostScript::
+
+  $ groff -Tps foo >foo.ps
+
+DVI::
+
+  $ groff -Tdvi foo >foo.dvi
+