Control: clone -1 -2
Control: reassign -2 man2html-base 1.6g-11
Control: affects -2 xymon src:xymon
Control: severity -2 normal
Control: retitle -1 Regenerate HTML documentation at buildtime
Control: severity -1 wishlist

Hi,

Axel Beckert wrote:
> If I copy and paste the [disk] example from
> /usr/share/hobbit/help/manpages/man5/hobbitgraph.cfg.5.html like below

JFTR: Since the renaming of hobbit to xymon the HTML file is
/usr/share/xymon/help/manpages/man5/graphs.cfg.5.html and the relevant
man page is graph.cfg(5) from the xymon package.

> and then request the according graph, I get the following error message
> in HTML instead of an image:
> 
>   Invalid request
>   I don't understand ': %5.1lf (cur)' in command: 'GPRINT:p0:LAST: : %5.1lf 
> (cur)'.
> 
> Copy & Paste from HTML documentation:
> 
> [disk]
>         FNPATTERN disk(.*).rrd
>         TITLE Disk Utilization
>         YAXIS % Full
>         DEF:p@RRDIDX@=@RRDFN@:pct:AVERAGE
>         LINE2:p@RRDIDX@#@COLOR@:@RRDPARAM@
>         -u 100
>         -l 0
>         GPRINT:p@RRDIDX@:LAST: : %5.1lf (cur)
>         GPRINT:p@RRDIDX@:MAX: : %5.1lf (max)
>         GPRINT:p@RRDIDX@:MIN: : %5.1lf (min)
>         GPRINT:p@RRDIDX@:AVERAGE: : %5.1lf (avg)
> 
> Copy & paste from the man page:
> 
>       [disk]
>                FNPATTERN disk(.*).rrd
>                TITLE Disk Utilization
>                YAXIS % Full
>                DEF:p@RRDIDX@=@RRDFN@:pct:AVERAGE
>                LINE2:p@RRDIDX@#@COLOR@:@RRDPARAM@
>                -u 100
>                -l 0
>                GPRINT:p@RRDIDX@:LAST:  %5.1lf (cur)
>                GPRINT:p@RRDIDX@:MAX:  %5.1lf (max)
>                GPRINT:p@RRDIDX@:MIN:  %5.1lf (min)
>                GPRINT:p@RRDIDX@:AVERAGE:  %5.1lf (avg)
> 
> The differences are the amount of colons in the GPRINT lines. I expect a
> broken format conversion.

Despite the HTML files mentioned here are pre-generated, coming from
xymon's upstream tar ball and are not (yet) regenerated during the
build of the xymon package, this issue is nevertheless actually a bug
in /usr/bin/man2html from the man2html-base package. Hence cloning
this issue as man2html-base bug which affects xymon.

Because if I manually rebuild these HTML files from man pages, the
only things which change are:

* The HTML header (spelling changes and "<!DOCTYPE …" added)
* The time stamps
* The "http://localhost"; is no more present in the hyperlinks.

How to reproduce:

* Install git and man2html-base.
* run these commands:
  $ git clone https://salsa.debian.org/debian/xymon.git
  $ cd xymon
  $ build/makehtml.sh 4.3.28
* Showing that nothing changed with regards to this issue:
  $ git diff docs/manpages/man5/graphs.cfg.5.html
  $ $BROWSER docs/manpages/man5/graphs.cfg.5.html

On the other hand, latest when this is fixed in man2html, we should
start to regenerate the HTML files from the Xymon man pages at build
time. Hence not just reassigning the bug to man2html-base but keeping
it open against Xymon to be reminded of this TODO.

                Regards, Axel
-- 
 ,''`.  |  Axel Beckert <a...@debian.org>, https://people.debian.org/~abe/
: :' :  |  Debian Developer, ftp.ch.debian.org Admin
`. `'   |  4096R: 2517 B724 C5F6 CA99 5329  6E61 2FF9 CD59 6126 16B5
  `-    |  1024D: F067 EA27 26B9 C3FC 1486  202E C09E 1D89 9593 0EDE

Reply via email to