[GRASS-dev] [GRASS GIS] #2087: grass64 man page: missing words

Thu Sep 26 17:28:12 PDT 2013

#2087: grass64 man page: missing words
------------------------+---------------------------------------------------
 Reporter:  hamish      |       Owner:  grass-dev@…              
     Type:  defect      |      Status:  new                      
 Priority:  critical    |   Milestone:  6.4.4                    
Component:  Docs        |     Version:  6.4.3                    
 Keywords:  g.html2man  |    Platform:  Linux                    
      Cpu:  All         |  
------------------------+---------------------------------------------------
 Hi,

 the current build of GRASS 6.x is losing important information in the man
 page due to a g.html2man error.

 the source file is lib/init/grass6.html

 the html looks like:
 {{{
 <h2>SYNOPSIS</h2>

 <b>grass64</b> [<b>-</b>] [<b>-v</b>] [<b>-h | -help | --help</b>]
     [<b>-text | -gui | -tcltk | -oldtcltk | -wxpython | -wx]</b>]
     [[[<b><GISDBASE>/</b>]<b><LOCATION_NAME>/</b>]
         <b><MAPSET></b>]
 }}}

 the resulting man page looks like:
 {{{
 .SH SYNOPSIS
 \fBgrass64\fR [\fB-\fR] [\fB-v\fR] [\fB-h | -help | --help\fR]
 [\fB-text | -gui | -tcltk | -oldtcltk | -wxpython | -wx]\fR]
 [[[\fB/\fR]\fB/\fR]
 \fB\fR]
 }}}

 i.e. html:
 {{{
 SYNOPSIS

 grass64 [-] [-v] [-h | -help | --help] [-text | -gui | -tcltk | -oldtcltk
 | -wxpython | -wx]] [[[<GISDBASE>/]<LOCATION_NAME>/] <MAPSET>]
 }}}

 and man:
 {{{
 SYNOPSIS
        grass65  [-]  [-v] [-h | -help | --help] [-text | -gui | -tcltk |
        -oldtcltk | -wxpython | -wx]] [[[/]/] ]
 }}}

 ... the `[[<GISDBASE>/]<LOCATION_NAME>/] <MAPSET>]` part has lost its
 words even though >, < were used and not something which could be
 mistaken for a <html tag>. Is the `DoEscape` subroutine converting '>'
 to '<' before any unknown html tags are thrown away? If so it should be
 moved to after that; see lines 136 and 141:

 https://trac.osgeo.org/grass/browser/grass/branches/develbranch_6/tools/g.html2man/g.html2man#L110

 ?

 thanks,
 Hamish

-- 
Ticket URL: <https://trac.osgeo.org/grass/ticket/2087>
GRASS GIS <http://grass.osgeo.org>