bugGNU Octave - Bugs: bug #48001, @qcode macro in docs expanding...


bug #48001: @qcode macro in docs expanding with newlines on stable, no newlines on default

Submitter:  Rik <rik5>
Submitted:  Tue 24 May 2016 06:56:02 PM UTC
Category:  Documentation Severity:  4 - Important
Priority:  5 - Normal Item Group:  Regression
Status:  Fixed Assigned to:  None
Originator Name:  Open/Closed:  * Closed
Release:  * 4.0.2 Operating System:  * Any
Fixed Release:  None Planned Release:  None
* Mandatory Fields

Add a New Comment (Rich Markup)

Comment Type & Canned Response:


Tue 07 Jun 2016 11:07:10 PM UTC, comment #4: 

Fixed on stable by updating gnulib-hg to the same revision that we updated to recently on default. One minor change was needed due to an API change in gnulib last year, builds and tests cleanly for me, and the PDF looks correct now.


Mike Miller <mtmiller>
Project Administrator
Tue 07 Jun 2016 05:56:16 PM UTC, comment #3: 

That fix sounds fine to me.  Can you make it so on the stable branch?

Rik <rik5>
Project Administrator
Tue 07 Jun 2016 05:26:52 PM UTC, comment #2: 

I forgot to mention, confirmed by copying the texinfo.tex from default into build-aux, replacing the symlink into gnulib-hg that is normally there.

Mike Miller <mtmiller>
Project Administrator
Tue 07 Jun 2016 05:26:20 PM UTC, comment #1: 

I can confirm that this is a bug that has been fixed in gnulib's texinfo.tex macros file. This is a file that is part of GNU Texinfo, but also distributed along with automake and gnulib and copied into the project's build-aux directory as needed. We also used to maintain our own hand-updated copy of texinfo.tex, but now allow it to be copied in from gnulib when ./bootstrap is run.

The updated gnulib on the default branch has a texinfo.tex that fixes this problem and the older one on stable does not. Since this file is not part of our repository, we can't easily patch it or backport it, we could just update the gnulib revision on the stable branch.

Mike Miller <mtmiller>
Project Administrator
Tue 24 May 2016 06:56:02 PM UTC, original submission:  

The documentation for stable seems to have suffered a regression.  The @qcode macro is now introducing a newline before it in the PDF version of the manual.  Interestingly, this is only on the stable branch.  The default branch still renders things correctly.

I am attaching two images which show part of the docstring for the sum function on both the stable and default branch.  It's pretty easy to spot the difference.

At least the current pdf manual on the Octave website does not have this problem.

Rik <rik5>
Project Administrator


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

Attach Files:

Attached Files
file #37250:  sum.stable.png added by rik5 (97KiB - image/png)
file #37251:  sum.dev.png added by rik5 (82KiB - image/png)


Depends on the following items: None found

Items that depend on this one: None found


Carbon-Copy List
  • -email is unavailable- added by mtmiller (Posted a comment)
  • -email is unavailable- added by rik5 (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 project members can vote.





    Follow 5 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2016-06-07 mtmiller StatusConfirmed Fixed
        Open/ClosedOpen Closed
    2016-06-07 mtmiller StatusNone Confirmed
    2016-05-24 rik5 Attached File- Added sum.stable.png, #37250
        Attached File- Added sum.dev.png, #37251

    Back to the top

    Powered by Savane 3.9