Menu

#2577 Meaningless crossref generation for the HTML manual

None
closed-wont-fix
nobody
None
2023-01-31
2023-01-02
No

With gnuplot 5.4.4 under Debian, /usr/share/doc/gnuplot/htmldocs/node7.html contains:

 See <B>overflow (p.&nbsp;<A HREF="node366.html#overflow"><IMG  ALT="[*]" SRC="crossref.png"></A>)<A ID="114"></A></B>.

but a reference to a page with no information does not make sense. It seems that the cause is that the HTML manual is built from the generated LaTeX version with latex2html. But the LaTeX version is designed for an output with pages and page numbers, while this is meaningless in HTML. For instance, the generated gnuplot.tex file contains:

 See {\bf overflow (p.~\pageref{overflow})\index{overflow}}.

and this is what is converted to HTML by latex2html.

Discussion

  • Ethan Merritt

    Ethan Merritt - 2023-01-02
    • status: open --> pending-wont-fix
    • Group: -->
    • Priority: -->
     
  • Ethan Merritt

    Ethan Merritt - 2023-01-02

    Won't fix.

    The latex->html pathway stopped working correctly a long time ago. html documentation for Windows is generate by a separate program doc2html., For linux it has been replaced going forward by a new program doc2web.

     
  • Vincent Lefevre

    Vincent Lefevre - 2023-01-02

    I can't see any reference to doc2web in gnuplot 5.4.4. Do you mean that it will be in the next gnuplot release? (This is actually a way to make the issue disappear.)

     
    • Ethan Merritt

      Ethan Merritt - 2023-01-02

      Yes. It is in the git repository. It was used to to produce the html docementation on the web site: http://gnuplot.info/docs_5.5/gnuplot5.html

       
  • Ethan Merritt

    Ethan Merritt - 2023-01-31
    • status: pending-wont-fix --> closed-wont-fix
     

Log in to post a comment.