bugGNU Octave - Bugs: bug #45530, generate_package_html, texinfo 4,...

 
 

bug #45530: generate_package_html, texinfo 4, function docs with only 1 deftypefn: empty html doc

Submitter:  Olaf Till <i7tiol>
Submitted:  Sun 12 Jul 2015 02:12:44 PM UTC
   
 
Category:  Octave Package Severity:  3 - Normal
Priority:  5 - Normal Item Group:  Incorrect Result
Status:  Fixed Assigned to:  None
Originator Name:  Open/Closed:  * Closed
Release:  * dev Operating System:  * GNU/Linux
Fixed Release:  None Planned Release:  None
* Mandatory Fields

Add a New Comment Rich Markup
   

Thu 16 Jul 2015 06:11:51 AM UTC, comment #5: 

This bug report can be closed.

Julien Bect <jbect>
Mon 13 Jul 2015 04:06:46 PM UTC, comment #4: 

@Olaf: I have pushed your patch, and then another one that removes one more useless capturing group. It should be ok now.

Julien Bect <jbect>
Sun 12 Jul 2015 07:13:08 PM UTC, comment #3: 

Mh, it should occur with any function which has only @deftypefn and no following @deftypefnx ...

It occured for the functions I just added in the last commits of the parallel package, e.g. inst/rfeval.m ...

Olaf

Olaf Till <i7tiol>
Group Member
Sun 12 Jul 2015 06:48:55 PM UTC, comment #2: 

Hello Olaf,

Thanks for the patch.

Can you point me to an example of a function where the problem occurs ?

@++
Julien

Julien Bect <jbect>
Sun 12 Jul 2015 04:07:28 PM UTC, comment #1: 

Adding package maintainer to CC

Carnë Draug <carandraug>
Group Member
Sun 12 Jul 2015 02:12:44 PM UTC, original submission:  

With texinfo 4, for functions with only 1 '@deftypefn..' in their documentation, generate_package_html produces html with an empty body of function documentation.

The reason is that in a regexpression in texi2html.m one pair of the grouping paratheses should be made non-capturing, otherwise the captured token seems to be dropped if the token produced by the surrounding parantheses is equal to it ((...deftypefn...)+).

Patch is attached.

Olaf Till <i7tiol>
Group Member

 

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

Attach Files:
   
   
Comment:
   

Attached Files
file #34427:  changeset.patch added by i7tiol (903B - text/x-patch)

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by jbect (Posted a comment)
  • -email is unavailable- added by carandraug (Julien Bect - maintainer of generate_html package)
  • -email is unavailable- added by i7tiol (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
    2015-07-16 carandraug StatusNone Fixed
        Open/ClosedOpen Closed
    2015-07-12 carandraug Carbon-Copy- Added -email is unavailable-
    2015-07-12 i7tiol Attached File- Added changeset.patch, #34427

    Back to the top

    Powered by Savane 3.13-caa5.
    Corresponding source code