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

 
 

You are not allowed to post comments on this tracker with your current authentification 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: MakefilesSeverity: 3 - Normal
Item Group: Change RequestStatus: None
Privacy: PublicAssigned to: None
Open/Closed: Open

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 (6kB - text/x-patch)

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -unavailable- added by yavor (Submitted the item)
  •  

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

    Only logged-in users can vote.

     

    Please enter the title of George Orwell's famous dystopian book (it's a date):

     

     

    Follows 1 latest change.

    Date Changed By Updated Field Previous Value => Replaced By
    Sun 29 Jun 2014 04:08:06 PM UTCyavorAttached File-=>Added makeinfo-html.patch, #31632

    Back to the top


    Powered by Savane 3.1-cleanup