Bug 913274

Summary: texinfo-5.0 regression processing .texinfo files (sbcl)
Product: [Fedora] Fedora Reporter: Rex Dieter <rdieter>
Component: texinfoAssignee: Vitezslav Crhonek <vcrhonek>
Status: CLOSED WONTFIX QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 19CC: alekcejk, pertusus, vcrhonek
Target Milestone: ---Keywords: Regression
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-09-30 16:07:27 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 913718    
Attachments:
Description Flags
simple document makeinfo no longer processes none

Description Rex Dieter 2013-02-20 19:38:22 UTC
Created attachment 700187 [details]
simple document makeinfo no longer processes

f18's texinfo-4.13a-18.fc18 processed sbcl .texinfo content without warning or error, now it doesn't get very far at all.

Failed build,
http://koji.fedoraproject.org/koji/taskinfo?taskID=5037628

Attached is even a minimal sbcl.texinfo file with all the @include statements removed.

$ makeinfo sbcl.texinfo
sbcl.texinfo:10: warning: multiple @settitle
sbcl.texinfo:55: @macro requires a name
sbcl.texinfo:58: @macro requires a name
sbcl.texinfo:61: @macro requires a name
sbcl.texinfo:64: @macro requires a name
sbcl.texinfo:67: @macro requires a name

Comment 1 Rex Dieter 2013-02-20 19:51:58 UTC
gcc experienced similar breakage, but looks like they're actively fixing/working-around the problem,
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=56258

Comment 2 Patrice Dumas 2013-02-20 21:35:59 UTC
I (as the upstream GNU Texinfo texi2any/makeinfo developper) had a look, and as far as I can tell all the warnings and errors are indeed because of dubious or wrong Texinfo.  In the @macro case, the error comes from the fact that & is used in a @macro name which is incorrect.  I had a look at the sbcl manual, I can't see why those user @macro are defined.

The @macro error could use a better error message, though, I'll try to fix that.

Comment 3 Rex Dieter 2013-02-20 22:31:13 UTC
fyi, maxima ftbfs now too:
http://koji.fedoraproject.org/koji/buildinfo?buildID=397154

Comment 4 Patrice Dumas 2013-02-20 22:52:56 UTC
(In reply to comment #3)
> fyi, maxima ftbfs now too:
> http://koji.fedoraproject.org/koji/buildinfo?buildID=397154

I had a look, all the errors and warnings seems to point to real issues that should be corrected in the manual.

For the errors like

./to_poly_solve.texi:341: warning: @itemize has text but no @item

there could be indeed a missing @item, but the authors may also want to indent the text, for that there is a new @-command, @indentedblock.  But since it quite recent, bearing with the warning could also be the way to go.

Comment 5 Rex Dieter 2013-02-21 14:03:29 UTC
Spot tested a few other texinfo/makeinfo using packages, hit anaother failure
wget:  http://koji.fedoraproject.org/koji/taskinfo?taskID=5039621
(another @item-related problem).

also a few successes (mostly to show to myself not *all* packages fail): 
grep
gzip
mtools
tar

Comment 6 Patrice Dumas 2013-02-21 20:20:34 UTC
(In reply to comment #5)
> Spot tested a few other texinfo/makeinfo using packages, hit anaother failure
> wget:  http://koji.fedoraproject.org/koji/taskinfo?taskID=5039621
> (another @item-related problem).

Indeed, all the @itemx flagged by makeinfo as incorrect are indeed incorrect.

> also a few successes (mostly to show to myself not *all* packages fail): 
> grep
> gzip
> mtools
> tar

All could have failed, as much more errors are caught now...

Comment 7 Rex Dieter 2013-03-10 23:39:39 UTC
Another casualty, enblend,
https://koji.fedoraproject.org/koji/taskinfo?taskID=5104184

Comment 8 Rex Dieter 2013-03-15 13:17:08 UTC
If serious headway cannot be made to resolve these problems soon, I humbly suggest pushing reverting back to texinfo-4.x for f19 and pushing texinfo-5.x back to f20.

Comment 9 Patrice Dumas 2013-03-16 19:03:23 UTC
(In reply to comment #2)

> The @macro error could use a better error message, though, I'll try to fix
> that.

In 5.1 the error message should be better.

(In reply to comment #7)
> Another casualty, enblend,
> https://koji.fedoraproject.org/koji/taskinfo?taskID=5104184

This one is much more tricky.  First it unveiledd an important bug in 5.1.  The remaining issues are also more complicated to solve.  I did send a mail to some enblend list (or group, I don't really found a traditional mailing list) with a possible solution and example code.

(In reply to comment #8)
> If serious headway cannot be made to resolve these problems soon, I humbly
> suggest pushing reverting back to texinfo-4.x for f19 and pushing
> texinfo-5.x back to f20.

enblend set aside, I think that package managers could report to upstream the issues and maybe prepare patches, although upstream could certainly figure out the simplest cases that are clearly incorrect.  I can step in, but I don't think that it's the best course.

That being said, keeping the new Texinfo a bit longer in rawhide only is certainly the way to go, at least that's what I would have advocated in my Fedora days.

Comment 10 Fedora End Of Life 2013-04-03 17:56:53 UTC
This bug appears to have been reported against 'rawhide' during the Fedora 19 development cycle.
Changing version to '19'.

(As we did not run this process for some time, it could affect also pre-Fedora 19 development
cycle bugs. We are very sorry. It will help us with cleanup during Fedora 19 End Of Life. Thank you.)

More information and reason for this action is here:
https://fedoraproject.org/wiki/BugZappers/HouseKeeping/Fedora19

Comment 11 Rex Dieter 2013-09-30 16:07:27 UTC
Marking WONTFIX, I guess the way forward now is just to trudge through fixing probject's texinfo files to be compatible.