bugGNUstep - Bugs: bug #42641, Use makeinfo --html to generate...


You are not allowed to post comments on this tracker with your current authentication level.

bug #42641: Use makeinfo --html to generate HTML manuals from .texi documents

Submitted by:  Yavor Doganov <yavor>
Submitted on:  Sun 29 Jun 2014 04:08:06 PM UTC  
Category:  Makefiles Severity:  3 - Normal
Item Group:  Change Request Status:  Fixed
Privacy:  Public Assigned to:  None
Open/Closed:  Closed

Wed 22 Nov 2017 04:44:23 PM UTC, comment #1:

This bug can be closed as a stripped version of the proposed patch has been applied (commit:d69117e).

Yavor Doganov <yavor>
Sun 29 Jun 2014 04:08:06 PM UTC, original submission:

I propose to switch to makeinfo for producing HTML variants of the Texinfo manuals. Rationale:

  • texi2html is no longer developed
  • the main texi2html author has been working on texinfo since quite some time and the general advice is to migrate to texinfo (see [1])
  • modern texinfo implements (almost) all the texi2html features
  • texi2html is likely to be removed from some distros in the not-so-distant future (see [2])
  • makeinfo is more likely to be installed on a system
  • one dependency less is generally a good thing

Cons: As makeinfo is more strict than texi2html, some documents which previously built with texi2html will fail with makeinfo --html, just like they are currently failing when building the .info file(s). Since gnustep-make by design ignores such errors, they are not fatal. But I don't think that documents with invalid Texinfo syntax are a valid reason to stick with texi2html; they should be fixed instead.

[1] http://www.nongnu.org/texi2html/
[2] http://lists.debian.org/debian-devel/2013/05/msg01516.html

Please find attached the proposed patch implementing the switch. texi2html as a possibility is retained and can be used if required by the user. I have tested all four combinations (makeinfo/texi2html/split/monolithic) for the common targets all/clean/install/uninstall.

Yavor Doganov <yavor>


Attached Files
file #31632:  makeinfo-html.patch added by yavor (6KiB - 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 FredKiefer (Updated the item)
  • -email is unavailable- added by yavor (Submitted the item)

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.




    Follow 3 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2017-11-22 FredKiefer StatusNone => Fixed
        Open/ClosedOpen => Closed
    2014-06-29 yavor Attached File- => Added makeinfo-html.patch, #31632

    Back to the top

    Powered by Savane 3.3