bugGNU Octave - Bugs: bug #39423, Section with comma in title...

 
 

bug #39423: Section with comma in title inaccessible in info manual

Submitter:  Mike Miller <mtmiller>
Submitted:  Sun 07 Jul 2013 08:17:10 PM UTC
   
 
Category:  Documentation Severity:  3 - Normal
Priority:  5 - Normal Item Group:  Documentation
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
   

Mon 08 Jul 2013 03:36:53 PM UTC, comment #3: 

I like it.  I pushed your changeset here (http://hg.savannah.gnu.org/hgweb/octave/rev/5d08a2ec7edb).  Closing report.

Rik <rik5>
Group administrator
Mon 08 Jul 2013 01:22:11 PM UTC, comment #2: 

This section also includes the fill and surface functions. Reading through the plotting sections, it seems a little out of place, stuck between "Multiple Plot Windows" and "Manipulation of Plot Windows".

Since these functions are about creating graphics objects directly, would it make more sense to merge it into "@node Graphics Objects" as a new subsubsection? How about the attached changeset?

(file #28512)

Mike Miller <mtmiller>
Group Member
Sun 07 Jul 2013 11:57:01 PM UTC, comment #1: 

We should probably just re-title this node.  In fact, the current title is wrong as the 'axis' function is not documented here.  It is the 'axes' function which is.  Can you think of a suitable name?  "Other Graphic Objects" seems a little bit opaque.

Rik <rik5>
Group administrator
Sun 07 Jul 2013 08:17:10 PM UTC, original submission:  

The section "Use of axis, line, and patch Functions" is inaccessible in the Info manual, running from the current development build. Building and viewing with GNU texinfo 5.1.

For example, attempting to go to the node directly from the top-level menu shows the error:

Use of axis, line, and patch Functions: No such file or directory


And attempting to go to the next node from "Multiple Plot Windows" shows the error:

Cannot find node `(./doc/interpreter/octave.info)Use of axis'.


This is the only node in the entire manual with a comma in the title, and I think that is the problem. In fact, the GNU texinfo manual describes that this will not work. My reading of the manual [1] is that you can escape the comma to force the Texinfo processor to handle it, but that the Info reader will still not parse it correctly.

[1] https://www.gnu.org/software/texinfo/manual/texinfo/html_node/Node-Line-Requirements.html

Mike Miller <mtmiller>
Group Member

 

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

Attach Files:
   
   
Comment:
   

Attached Files
file #28512:  plot-txi.patch added by mtmiller (2KiB - 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 rik5 (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 5 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2013-07-08 rik5 StatusPatch Submitted Fixed
        Open/ClosedOpen Closed
    2013-07-08 mtmiller Attached File- Added plot-txi.patch, #28512
        StatusConfirmed Patch Submitted
    2013-07-07 rik5 StatusNone Confirmed

    Back to the top

    Powered by Savane 3.13-02a9.
    Corresponding source code