pod2mdoc/pod2mdoc.1 - diff

Return to pod2mdoc.1 CVS log

Up to [cvsweb.bsd.lv] / pod2mdoc

Diff for /pod2mdoc/pod2mdoc.1 between version 1.3 and 1.4

-version 1.3, 2014/03/23 13:00:24
+version 1.4, 2014/03/23 23:23:38
 Line 98  is not specified and the suffix for
 Line 98  is not specified and the suffix for
 Line 98  is not specified and the suffix for
  .Ar file
  is
  .Li .pm ,
- infer a manual section of 3p, not 3.
+ .Nm
+ infers a manual section of 3p, not 3, as stipulated in
+ .Xr perlpod 1 .
+ .Pp
+ If
+ .Nm
+ encounters an
+ .Li =item
+ without the necessary
+ .Li =over ,
+ it will pretend that a prior
+ .Li =over
+ was invoked.
+ However, it will do so silently and not, as
+ .Xr pod2man 1
+ does, append a POD ERRORS section in the output manpage saying so.
  .Sh SEE ALSO
- .Xr perlpod 1
+ .Xr perlpod 1 ,
  .Xr pod2man 1
  .Sh AUTHORS
  .Nm
-Line 108  was written by
+Line 123  was written by
 Line 108  was written by
 Line 123  was written by
  .Ar Kristaps Dzonsons ,
  .Mt kristaps@bsd.lv .
  .Sh CAVEATS
- By way of being a presentational language, POD translates poorly to
+ By way of being a presentational language, POD is not well-represented
+ by
  .Xr mdoc 7 .
  Semantic content will be necessarily lost.
  .Pp
  .Nm
- does not currently support the following:
+ only supports the named
- .Bl -enum
+ .Li E<xxx>
- .It
+ escapes.
- escapes that are htmlnames or numbers
+ HTML names and numbers are silently discarded.
- .It
+ .Pp
- probably many other things
+ Although most white-space requests in character encodings are properly
- .El
+ carried to output, adjacent character escapes with the specific
+ whitespace sequence
+ .Qq Li "B<2>B< 3>"
+ will cause the second space to be lost.
+ .Pp
+ The
+ .Li S<>
+ escape is discarded.

CVSweb