#612: g.html2man: parsing leads to man page errors
--------------------------+-------------------------------------------------
Reporter: hamish | Owner: grass-dev@lists.osgeo.org
Type: defect | Status: new
Priority: normal | Milestone: 6.5.0
Component: Docs | Version: 6.4.0 RCs
Resolution: | Keywords: g.html2man
Platform: Unspecified | Cpu: All
--------------------------+-------------------------------------------------
Comment (by glynn):
Replying to [ticket:612 hamish]:
> tools/g.html2man has a number of parsing problems.
>
> there are a few like cairodriver.1 which happen to start lines with ".",
which gets parsed incorrectly by the man program. e.g. in cairodriver it
lists ouput formats, and the '.pn' of .png gets hijacked and all those
image types end up missing from the resulting man page.
I've committed some fixes in r37386. Apart from escaping dots and single
quotes at the beginning of a line, it doesn't remove leading whitespace
from pre-formatted text and doesn't insert line breaks within .IP "..."
(this last one only affected d.graph).
> another popular one is <OL><LI> becoming ..IP instead of .IP (e.g.
pngdriver.1 just after "Example")
>
> and yet another is g.parser.1 where #%multiple: gets eaten.
I can't reproduce these.
>
> detailed list of errors is here: (scroll down to 'grass-doc')
> http://lintian.debian.org/maintainer/pkg-grass-
de...@lists.alioth.debian.org.html#grass
Note that the "bad whatis" entries correspond to an HTML file which lacks
a description in the NAME section. This generally only occurs with HTML
files which aren't generated from --html-description.
--
Ticket URL: <https://trac.osgeo.org/grass/ticket/612#comment:1>
GRASS GIS <http://grass.osgeo.org>
_______________________________________________
grass-dev mailing list
grass-dev@lists.osgeo.org
http://lists.osgeo.org/mailman/listinfo/grass-dev
