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
   

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.

http://hg.savannah.gnu.org/hgweb/octave/rev/12b31cb1d6b7

 Mike Miller <mtmiller>
Group Member
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>
Group 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>
Group Member
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>
Group Member
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>
Group administrator

 

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

Attach Files:
   
   
Comment:
   

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 group 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

    Copyright © 2024 Free Software Foundation, Inc.
    Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.
    The Levitating, Meditating, Flute-playing Gnu logo is a GNU GPL'ed image provided by the Nevrax Design Team.
    Page source code

    Powered by Savane 3.13-df36.
    Corresponding source code