[Octave-bug-tracker] [bug #38540] generate_html package: html_help_text fails with embedded TeX under Octave 3.7

[Mike Miller]

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

                 Summary: generate_html package: html_help_text fails with
embedded TeX under Octave 3.7
                 Project: GNU Octave
            Submitted by: mtmiller
            Submitted on: Mon 18 Mar 2013 10:14:25 AM EDT
                Category: Octave Forge Package
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: Incorrect Result
                  Status: None
             Assigned to: None
         Originator Name: 
        Originator Email: 
             Open/Closed: Open
         Discussion Lock: Any
                 Release: dev
        Operating System: Any

    _______________________________________________________

Details:

The html_help_text function used for building Octave Forge packages fails
under Octave 3.7 on any functions with embedded @tex with errors like the
following:

/tmp/octave-help-uMx4YA:176: Expected `
@end iftex'.
/tmp/octave-help-uMx4YA:73: No matching address@hidden deftypefn'.
error: html_help_text: couln't parse file 'xcorr'
error: called from:
error:   /home/mike/octave/generate_html-0.1.5/html_help_text.m at line 77,
column 9

The reason is because html_help_text inserts a header and footer on the
function help text before passing it in to __makeinfo__:

https://sourceforge.net/p/octave/code/11750/tree/trunk/octave-forge/extra/generate_html/inst/html_help_text.m#l61

This makes the help text formatting inconsistent and breaks with the new
__makeinfo__ function.

Is there any use for this header and footer addition to the help text? If no
one sees any purpose for it it should be deleted since it causes problems
going forward.




    _______________________________________________________

Reply to this item at:

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

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