===================================================================
RCS file: /cvs/pod2mdoc/pod2mdoc.1,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -p -r1.5 -r1.6
--- pod2mdoc/pod2mdoc.1	2014/03/24 01:07:30	1.5
+++ pod2mdoc/pod2mdoc.1	2014/03/24 01:43:42	1.6
@@ -1,4 +1,4 @@
-.\"	$Id: pod2mdoc.1,v 1.5 2014/03/24 01:07:30 kristaps Exp $
+.\"	$Id: pod2mdoc.1,v 1.6 2014/03/24 01:43:42 kristaps Exp $
 .\"
 .\" Copyright (c) 2014 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"
@@ -91,6 +91,14 @@ uses
 .El
 .Sh EXIT STATUS
 .Ex -std
+.Sh EXAMPLES
+To pipe a POD document
+.Pa foo.pod
+through
+.Xr mandoc 1
+and a pager:
+.Pp
+.Dl % pod2mdoc foo.pod | mandoc | more
 .Sh COMPATIBILITY
 If
 .Fl s
@@ -99,7 +107,7 @@ is not specified and the suffix for
 is
 .Li .pm ,
 .Nm
-infers a manual section of 3p, not 3, as stipulated in
+infers a manual section of 3p, not 3 as stipulated in
 .Xr perlpod 1 .
 Furthermore, all links in the format of
 .Li L<Foo::Bar>
@@ -119,7 +127,8 @@ However, it will do so silently and not, as
 does, append a POD ERRORS section in the output manpage saying so.
 .Sh SEE ALSO
 .Xr perlpod 1 ,
-.Xr pod2man 1
+.Xr pod2man 1 ,
+.Xr mdoc 7
 .Sh AUTHORS
 .Nm
 was written by