bugGNU Octave - Bugs: bug #39178, comm package (v. 1.1.1): Fail to...

 
 

bug #39178: comm package (v. 1.1.1): Fail to build the doc (raising section level)

Submitter:  Rafael Laboissière <rlaboiss>
Submitted:  Thu 06 Jun 2013 04:14:04 PM UTC
   
 
Category:  Octave Package Severity:  3 - Normal
Priority:  5 - Normal Item Group:  Build Failure
Status:  Fixed Assigned to:  carandraug
Originator Name:  Open/Closed:  * Closed
Release:  * other Operating System:  * GNU/Linux
Fixed Release:  None Planned Release:  None
* Mandatory Fields

Add a New Comment Rich Markup
   

Fri 07 Jun 2013 04:52:33 PM UTC, comment #4: 

I do not know.  Perhaps the reason is to have the "Functions Reference" chapter starting right way with the menu of functions, in order to improve the navigability, otherwise the user would have to scroll down until she gets to the menu.

Rafael Laboissière <rlaboiss>
Fri 07 Jun 2013 04:38:40 PM UTC, comment #3: 

Ah! I see what's happening now. The generated texi is removing the "Functions by category" section when generating the Info file. Do you know why it's doing that at all?

Carnë Draug <carandraug>
Group Member
Fri 07 Jun 2013 04:06:01 PM UTC, comment #2: 

I think that the logic behind the original code in mktexi was to remove the "Functions Alphabetically" section title in the info form of the documentation, since it was the only section in the "Function Reference" chapter, what is somehow redundant information.  I think that this was a sensible design and
it worked with texinfo << 5.0.  However, it seems that having a @subsection following immediately a @chapter is not allowed in texinfo 5.1.

Rafael Laboissière <rlaboiss>
Fri 07 Jun 2013 03:39:07 PM UTC, comment #1: 

At least when building the PDF, the section "Functions Alphabetically" does exist under the section "Function Reference" (Debian Wheezy with texinfo 4.13). So I'm guessing you fixed not only a compatibility with new texinfo versions, but also a bug on the documentation.

Patch applied on SVN with r11944.

Carnë Draug <carandraug>
Group Member
Thu 06 Jun 2013 04:14:04 PM UTC, original submission:  

I used to be able to build the comm package from source, but I am having now the following error message:


Making info comms.info
comms.texi:2821: raising the section level of @subsection which is too low
make[1]: *** [comms.info] Error 1


I suspect that this happens now because I upgraded texinfo to version 5.1 in my system.

I tracked down the problem and could fix it by patching the doc/mktexi file. I guess that the comm package gets this file from the admin/ directory, so I am attaching to this bug report a patch to admin/mktexi.  The only drawback of this patch is that  section title "Functions Alphabetically" will appear in the chapter "Function Reference" of the info documentation, which did not exist before.

Rafael Laboissière <rlaboiss>

 

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

Attach Files:
   
   
Comment:
   

Attached Files
file #28272:  avoid-makeinfo-section-raising-error.diff added by rlaboiss (429B - text/x-patch - Patch for admin/mktexi)

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by rlaboiss (Submitted the item)
  • -email is unavailable- added by rlaboiss
  •  

    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 5 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2013-06-07 carandraug StatusNone Fixed
        Assigned toNone carandraug
        Open/ClosedOpen Closed
    2013-06-06 rlaboiss Attached File- Added avoid-makeinfo-section-raising-error.diff, #28272
        Carbon-Copy- Added rlaboiss

    Back to the top

    Powered by Savane 3.13-758e.
    Corresponding source code