zsh-workers
 help / color / mirror / code / Atom feed
From: Axel Beckert <abe@deuxchevaux.org>
To: zsh-workers@zsh.org
Subject: Replace deprecated "texi2html" with recommended "makeinfo --html"?
Date: Mon, 26 Aug 2013 11:35:49 +0200	[thread overview]
Message-ID: <20130826093549.GK19439@sym.noone.org> (raw)

Hi,

according to https://wiki.debian.org/Texi2htmlTransition and
http://www.nongnu.org/texi2html/, texi2html is deprecated and should
be replaced with makeinfo and appropriate options.

For Debian's zsh package, I've added the following patch for now:

Index: zsh/Doc/Makefile.in
===================================================================
--- zsh.orig/Doc/Makefile.in    2013-01-14 01:49:37.000000000 +0100
+++ zsh/Doc/Makefile.in 2013-08-26 08:25:54.468926080 +0200
@@ -40,7 +40,7 @@
 MAKEINFO = makeinfo
 TEXI2DVI = texi2dvi
 DVIPS = dvips
-TEXI2HTML = @TEXI2HTML@ --output . --ifinfo --split=chapter --node-files
+TEXI2HTML = makeinfo --html --output . --ifinfo --split=chapter --node-files
 
 .SUFFIXES: .yo .1

This is the minimal variant to get the HTML docs being built without
texi2html, but I suspect there could be adapted variable names and the
check for texi2html could be removed from configure.ac.

In general, the move from the standalone texi2html to texinfo's
makeinfo for HTML generation would mean that the list of build
dependencies could be reduced without losing any functionality or
having to add another build dependency -- because makeinfo is already
needed for building other variants of Zsh's documentation.

		Kind regards, Axel
-- 
/~\  Plain Text Ribbon Campaign                   | Axel Beckert
\ /  Say No to HTML in E-Mail and News            | abe@deuxchevaux.org  (Mail)
 X   See http://www.asciiribbon.org/              | abe@noone.org (Mail+Jabber)
/ \  I love long mails: http://email.is-not-s.ms/ | http://noone.org/abe/ (Web)


             reply	other threads:[~2013-08-26  9:43 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2013-08-26  9:35 Axel Beckert [this message]
2013-08-26 14:14 ` Bart Schaefer
2013-08-26 14:35   ` Bart Schaefer
2013-08-26 16:07     ` Axel Beckert
2013-08-26 14:29 ` Bart Schaefer

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20130826093549.GK19439@sym.noone.org \
    --to=abe@deuxchevaux.org \
    --cc=zsh-workers@zsh.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.vuxu.org/mirror/zsh/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).