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

[GRASS GIS]

#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         |  
------------------------+---------------------------------------------------

Comment(by wenzeslaus):

 Replying to [comment:4 mlennert]:
 > without erasing the <> around the variable names. This said, do we
 really need those ?

 I would say no. We are still following man pages formatting in HTML and I
 don't think that `<` and `>` are part of it. For example, this is my `man
 grep`:

 {{{
 grep [OPTIONS] PATTERN [FILE...]
 grep [OPTIONS] [-e PATTERN | -f FILE] [FILE...]
 }}}

 By the way, I'm still not sure if parsing whole HTML pages is a good idea.
 If I would start from scratch I would probably use module's HTML stub and
 XML interface description because XML is easier to parse than HTML tag
 soup (but since we already have the parsing and Makefiles are also
 designed for parsing whole HTML it is probably not worth trying).

 ''Even more by the way, Moritz, you can mark and escape inline code here
 using backticks {{{`#forexample`}}} or even `{{{` and `}}}` should work
 inline. New Trac has automatic preview, so we have hope
 ([http://trac.edgewall.org/ticket/8855] and
 [http://trac.edgewall.org/ticket/8721]).''

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