bugGNU Octave - Bugs: bug #38540, generate_html package:...

 
 

bug #38540: generate_html package: html_help_text fails with embedded TeX under Octave 3.7

Submitter:  Mike Miller <mtmiller>
Submitted:  Mon 18 Mar 2013 02:14:25 PM UTC
   
 
Category:  Octave Package Severity:  3 - Normal
Priority:  5 - Normal Item Group:  Incorrect Result
Status:  Wont Fix Assigned to:  mtmiller
Originator Name:  Open/Closed:  * Closed
Release:  * dev Operating System:  * Any
Fixed Release:  None Planned Release:  None
* Mandatory Fields

Add a New Comment Rich Markup
   

Fri 14 Feb 2014 02:08:33 AM UTC, comment #3: 

This bug does not affect me anymore. I think because I removed @iftex and @end iftex around @tex blocks in accordance with the docstring tips here:

https://www.gnu.org/software/octave/doc/interpreter/Documentation-Tips.html

I have been able to use generate_package_html in Octave 3.8.0 without this error. I'm going to close this as not a problem, but feel free to reopen if this still affects anyone else.

Mike Miller <mtmiller>
Group Member
Fri 22 Mar 2013 11:58:04 AM UTC, comment #2: 

Thanks Carlo, I see what you're saying about those markers being used to search for particular points in the makeinfo output.

I've got a potential fix now that I see what's going on, I just want to do some more testing to make sure the results look the same as before with Octave 3.6.

Mike Miller <mtmiller>
Group Member
Mon 18 Mar 2013 06:16:32 PM UTC, comment #1: 

try the following:


__makeinfo__ (" ##### OCTAVE START ##### \n  @deftypefn  {Function File} {[@var{retval}, @var{status}] =} __makeinfo__ (@var{text}, @var{output_type}) \n  @deftypefnx {Function File} {[@var{retval}, @var{status}] =} __makeinfo__ (@var{text}, @var{output_type}, @var{see_also}) \n Undocumented internal function.  @end deftypefn \n ##### OCTAVE STOP ##### ", "html")


you will see that _makeinfo_ automatically adds its default header and footer to the docstring.
The "start" and "stop" strings are sort of bookmarks added so that the default header and footer can be replaced by those chosen in the the package options

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

c.

Carlo de Falco <cdf>
Group Member
Mon 18 Mar 2013 02:14:25 PM UTC, original submission:  

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 `@end 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.

Mike Miller <mtmiller>
Group Member

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by cdf (Posted a comment)
  • -email is unavailable- added by mtmiller (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only group members can vote.

     

    Follow 4 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2014-02-14 mtmiller StatusIn Progress Wont Fix
        Open/ClosedOpen Closed
    2013-03-22 mtmiller StatusNone In Progress
        Assigned toNone mtmiller

    Back to the top

    Powered by Savane 3.13-f8d8.
    Corresponding source code