docutils/test/functional/expected/standalone_rst_manpage.man

   1 .\" Man page generated from reStructuredText.
   2 .
   3 .
   4 .nr rst2man-indent-level 0
   5 .
   6 .de1 rstReportMargin
   7 \\$1 \\n[an-margin]
   8 level \\n[rst2man-indent-level]
   9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
  10 -
  11 \\n[rst2man-indent0]
  12 \\n[rst2man-indent1]
  13 \\n[rst2man-indent2]
  14 ..
  15 .de1 INDENT
  16 .\" .rstReportMargin pre:
  17 . RS \\$1
  18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
  19 . nr rst2man-indent-level +1
  20 .\" .rstReportMargin post:
  21 ..
  22 .de UNINDENT
  23 . RE
  24 .\" indent \\n[an-margin]
  25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
  26 .nr rst2man-indent-level -1
  27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
  28 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
  29 ..
  30 .TH "RST2MAN" 1 "2006-10-22" "0.1" "text processing"
  31 .SH NAME
  32 rst2man \- generate unix manpages from reStructured text
  33 .\" TODO: authors and author with name <email>
  34 .
  35 .SH SYNOPSIS
  36 .INDENT 0.0
  37 .INDENT 3.5
  38 rst2man inputfile outputfile
  39 .UNINDENT
  40 .UNINDENT
  41 .SH DESCRIPTION
  42 .sp
  43 rst2man transforms a reStructured text document into a unix man page.
  44 .sp
  45 In theory any valid reStructured text document should be processable,
  46 in reality this is
  47 .INDENT 0.0
  48 .IP \(bu 2
  49 a goal, that is not met yet
  50 .IP \(bu 2
  51 a goal that might never be met, because only few constructs are
  52 used in man pages \fIand\fP because the common text file does not adhere
  53 to man page requirements.
  54 .sp
  55 For example a unix man page belongs into a numbered section, 1 is
  56 user commands, 8 contains administrator commands and the headlines
  57 of all manpages are collected into a database, queryable with the
  58 programm \fBapropos\fP, therefore the headline should contain a short
  59 text describing into which group this command belongs.
  60 .sp
  61 These informations are collected from title, subtitle and the
  62 docinfo, see this document as an example.
  63 .UNINDENT
  64 .SH OPTIONS
  65 .INDENT 0.0
  66 .TP
  67 .BI \-\-config\fB= <file>
  68 Read configuration settings from <file>, if it exists.
  69 .TP
  70 .B  \-\-version\fP,\fB  \-V
  71 Show this program\(aqs version number and exit.
  72 .TP
  73 .B  \-\-help\fP,\fB  \-h
  74 Show this help message and exit.
  75 .UNINDENT
  76 .sp
  77 And a lot more standard docutils options.
  78 .SH FILES
  79 .sp
  80 None yet.
  81 .SH SEE ALSO
  82 .sp
  83 docutils <https://docutils.sourceforge.io>
  84
  85 linux man page howto <http://tldp.org/HOWTO/Man-Page/>
  86
  87 .sp
  88 and \fBman man\fP also \fBman 7 man\fP
  89 .SH BUGS
  90 .INDENT 0.0
  91 .IP 1. 3
  92 Format options are included as they are required.
  93 .IP 2. 3
  94 bullet lists
  95 .IP 3. 3
  96 number lists
  97 .IP 4. 3
  98 math: The LaTeX source is shown, e.g. \fBn! + \esin(x_n^2)\fP\&.
  99 .UNINDENT
 100 .sp
 101 Discussion is still open.
 102 .SH AUTHOR
 103 grubert@users.sourceforge.net
 104 .SH COPYRIGHT
 105 public domain
 106 .\" Generated by docutils manpage writer.
 107 .