[GRASS-dev] make html2pdfdoc

[Markus Neteler]

On Mon, Nov 20, 2006 at 08:53:30PM +1300, Hamish wrote:
> "make html2pdfdoc" needs the "htmldoc" software.
> 
> debian/sarge included version 1.8.23, and AFAICT the --referer option
> wasn't introduced until ~ 1.8.25. Removing the --referer option
> generates the PDF correctly.

OK, I have removed the --referer option.
 
> Debian/etch will include ver. 1.8.27.
> 
> 
> 
> "make html2pdfdoccomplete" doesn't use the --referer, but I get an
> error:
> $ make html2pdfdoccomplete 
> Complete PDF document from modules' HTML documentation
> (cd /usr/local/src/grass/grass63/dist.i686-pc-linux-gnu/docs/html ; htmldoc --footer d.1 --webpage database.html db.*.html -f /usr/local/src/grass/grass63/dist.i686-pc-linux-gnu/docs/pdf/grass63database.pdf)
> ERR014: Preformatted text on page 15 too long - truncation or overlapping may occur!
> PAGES: 24
> BYTES: 52500                                                           
> make: *** [html2pdfdoccomplete] Error 1
>
> then it stops.

Using htmldoc-1.8.25 on Mandriva 2007 this works. It seems to be
version dependent (so >= 1.8.25 is fine).

 
> If I try "display" by hand:
> ERR014: Text on page 27 too large - truncation or overlapping may occur!
> ERR014: Image on page 90 too large - truncation or overlapping may occur!
> ERR014: Text on page 96 too large - truncation or overlapping may occur!
> ERR014: Text on page 106 too large - truncation or overlapping may occur!
> ERR014: Text on page 137 too large - truncation or overlapping may occur!
> ERR014: Text on page 141 too large - truncation or overlapping may occur!
> PAGES: 152
> BYTES: 669792
> 
> 
> maybe these bugs are fixed in the new version of htmldoc?
> (does it work for you?)

Yes & yes.
 
> Image error on p90 is d.polar. Break into two images & display side by
> side?

If that modification helps for downward compatibility, why not...

More important: tools/build_html_index.sh needs a modification to
not repeat the intro pages section on all pages (as they won't be
linked into to document anyway).


Markus