[prev in list] [next in list] [prev in thread] [next in thread] 

List:       gnuplot-info-beta
Subject:    Re: Recent problem with auto-generation of documentation
From:       Hans-Bernhard Broeker <broeker () physik ! rwth-aachen ! de>
Date:       2002-08-28 8:24:48
[Download RAW message or body]

On Tue, 27 Aug 2002, Ethan Merritt wrote:

> gd.trm contains both the new PNG driver and the new JPEG
> driver. The problem is that docs/Makeilfe picks up the file in 
> alphabetical order (G for gd.trm instead of J for jpeg and P for
> PNG) and extracts only the PNG documentation.

The fact that the jpeg docs weren't extracted point towards a problem in
gd.trm itself.  It may be caused by having more than one START_HELP in a
single .trm file.  

The order of appearance in the list will be fixed for the online .gih-type
docs by the sorting done by help.c.  I.e. the problem only exists in the
other documentation formats (printed, windows .hlp, ...) A better fix may
be to move this sorting into termdoc.c, where all output formats could
profit from it.

> For the moment I have added a place-holder file term/jpeg.trm that
> causes gd.trm to be scanned a second time, but maybe there is a
> better way to do this?  

If such a dummy .trm is needed at all, move the jpeg help node into that
file, too.  And maybe the TERM_ENTRY section, too It won't have to contain
anything else, as long as its guaranteed that gd.trm will always be
included if this jpeg.trm is, by appropriate #if bracketing in term.h.

-- 
Hans-Bernhard Broeker (broeker@physik.rwth-aachen.de)
Even if all the snow were burnt, ashes would remain.


[[[[ unsubscribe from info-gnuplot-beta via majordomo@dartmouth.edu ]]]]

[prev in list] [next in list] [prev in thread] [next in thread]