===================================================================
RCS file: /cvs/pod2mdoc/pod2mdoc.1,v
retrieving revision 1.9
retrieving revision 1.13
diff -u -p -r1.9 -r1.13
--- pod2mdoc/pod2mdoc.1	2014/04/03 10:17:14	1.9
+++ pod2mdoc/pod2mdoc.1	2014/04/07 11:46:03	1.13
@@ -1,4 +1,4 @@
-.\"	$Id: pod2mdoc.1,v 1.9 2014/04/03 10:17:14 kristaps Exp $
+.\"	$Id: pod2mdoc.1,v 1.13 2014/04/07 11:46:03 kristaps Exp $
 .\"
 .\" Copyright (c) 2014 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: April 3 2014 $
+.Dd $Mdocdate: April 7 2014 $
 .Dt POD2MDOC 1
 .Os
 .Sh NAME
@@ -101,6 +101,12 @@ Specifically, within each paragraph of the SYNOPSIS se
 following occur:
 .Bl -bullet
 .It
+If any number of
+.Li #include <foo.h>
+lines are found at the start of a verbatim paragraph, they're rendered
+with
+.Sq \&In .
+.It
 An initial
 .Li B<>
 format code is rendered as
@@ -182,6 +188,10 @@ manpage in section 3P if containing double-colons or s
 otherwise.
 The section may be overriden as
 .Li L<foo(5)> .
+If only a section appears, such as in
+.Li </section> ,
+the link is rendered with
+.Sq \&Sx .
 .Sh EXIT STATUS
 .Ex -std
 .Sh EXAMPLES
@@ -231,7 +241,7 @@ was written by
 By way of being a presentational language, POD is not well-represented
 by
 .Xr mdoc 7 .
-Semantic content will be necessarily lost.
+Semantic content must be inferred and may be wrong.
 .Pp
 .Nm
 only supports the named
@@ -248,3 +258,7 @@ will cause the second space to be lost.
 The
 .Li S<>
 escape is discarded.
+.Pp
+Unless solely a section link, the text and section parts of
+.Li L<text|link/section>
+are discarded.