[GRASS-dev] Re: [GRASS GIS] #612: g.html2man: parsing leads to man page errors

[GRASS GIS]

#612: g.html2man: parsing leads to man page errors
--------------------------+-------------------------------------------------
  Reporter:  hamish       |       Owner:  grass-dev at 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-
 devel at 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>