[Octave-bug-tracker] [bug #38862] HTML manual "seealso" links do not work

[Mike Miller]

URL:
  <http://savannah.gnu.org/bugs/?38862>

                 Summary: HTML manual "seealso" links do not work
                 Project: GNU Octave
            Submitted by: mtmiller
            Submitted on: Tue 30 Apr 2013 11:45:19 PM EDT
                Category: Documentation
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: Documentation
                  Status: None
             Assigned to: None
         Originator Name: 
        Originator Email: 
             Open/Closed: Open
         Discussion Lock: Any
                 Release: dev
        Operating System: Any

    _______________________________________________________

Details:

The "seealso" links from one function to another in the HTML manual do not
link to the correct target. The links from the "Function Index" do work
correctly. The pdf and info manuals work correctly.

I have narrowed this down to a bug in texinfo 4.x that has been fixed in 5.0
and higher. The links generated between the @anchor and @ref tags are not
consistent in 4.x if they contain non-alphanumeric characters (ours are
"doc-FUNCTION").

For example:

0 browse to
http://www.gnu.org/software/octave/doc/interpreter/Utility-Functions.html
0 click on "round" in ceil's seealso list
0 observe the resulting wrong anchor in the address bar and page has not
scrolled to the round function

The anchor target should be "#doc_002dround" but the link ends up going to
"#doc%2dround".

Now that bug #38392 is fixed, one way to fix this would be to just make sure
the official Octave releases and the manual published to the web site are
always built with texinfo >= 5.0.

Or change munge-texi.pl to remove the "-" from function anchors and texinfo
4.x should be happy as well.




    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?38862>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/