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

Group
 
 

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

Submitter:  Yavor Doganov <yavor>
Submitted:  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
* Mandatory Fields

Add a New Comment Rich Markup
   

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>

 

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

Attach Files:
   
   
Comment:
   

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)
  •  

    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 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.13-f8d8.
    Corresponding source code