md2man.1 in md2man-1.2.0

- old
+ new

@@ -1,6 +1,6 @@
-.TH MD2MAN 1 "2012\-02\-02" "1.1.0"
+.TH MD2MAN 1 2012\-02\-06 1.2.0
 .SH NAME
 .PP
 md2man \- convert 
 .BR markdown (7) 
 into 
@@ -16,26 +16,23 @@
 converts 
 .BR markdown (7) 
 input from the given \fIFILE\fP into 
 .BR roff (7) 
 using
-Redcarpet2
+Redcarpet
 .UR https://github.com/tanoku/redcarpet
 .UE
 and then prints the result to the standard output stream.  If
 \fIFILE\fP is not given, then the standard input stream is read in its place.
-.SS Document Format
+.SS Document format
 .PP
-The following additional semantics are attached to 
-.BR markdown (7):
+md2man extends 
+.BR markdown (7) 
+syntax in the following ways, as provisioned in the
+\fB\fCMd2Man::Document\fR module and defined in its derivative \fB\fCMd2Man::Roff\fR module:
 .RS
 .IP \(bu 2
-There can be at most one top\-level heading (H1).  It is emitted as \fB\fC.TH\fR
-in the 
-.BR roff (7) 
-output, specifying the UNIX man page's header and footer.
-.IP \(bu 2
 Paragraphs whose lines are all uniformly indented by two spaces are
 considered to be "indented paragraphs".  They are unindented accordingly
 before emission as \fB\fC.IP\fR in the 
 .BR roff (7) 
 output.
@@ -44,18 +41,28 @@
 indented by two spaces are considered to be a "tagged paragraphs".  They
 are unindented accordingly before emission as \fB\fC.TP\fR in the 
 .BR roff (7) 
 output.
 .RE
-.SS Markdown Extensions
 .PP
-The following Redcarpet2
+md2man extends 
+.BR markdown (7) 
+semantics in the following ways:
+.RS
+.IP \(bu 2
+There can be at most one top\-level heading (H1).  It is emitted as \fB\fC.TH\fR
+in the 
+.BR roff (7) 
+output, defining the UNIX manual page's header and footer.
+.RE
+.SS Markdown extensions
+.PP
+The following Redcarpet
 .UR https://github.com/tanoku/redcarpet
 .UE
-extensions for 
-.BR markdown (7) 
-are enabled:
+extensions are enabled while processing 
+.BR markdown (7):
 .RS
 .IP \(bu 2
 tables
 .IP \(bu 2
 autolink
@@ -69,11 +76,10 @@
 fenced_code_blocks
 .RE
 .SH OPTIONS
 .TP
 \fB\fC-h\fR, \fB\fC--help\fR
-Display this help manual using 
-.BR man (1).
+Show this help manual.
 .SH SEE ALSO
 .PP
 .BR markdown (7), 
 .BR roff (7)
\ No newline at end of file