texi2html vs texi2any

texi2html vs texi2any

[Jun T.]

texi2html has been discontinued around 2010/2011,
and it seems they recommend to use texi2any, which is
the main conversion script introduced in texinfo-5.

I tried texi2any and found that it is almost compatible
with texi2html.

If you have texinfo-5 installed in your system, then
please try the following:

$ export TEXI2HTML='/path/to/texi2any -c TEXI2HTML=1'
$ ./configure --options ...
$ make html
and open Doc/index.html by your browser.

I have noticed a few minor differences between the html's
generated by texi2html and texi2any (see the list below).
If these are acceptable, and if no other problems are found,
I will patch configure.ac and Doc/Makefile.in to use
texi2any if it is available.


[1] Top page
(1-1) name of the top page file:
      zsh.html (texi2html), index.html (texi2any)
(1-2) index.html (texi2any) contains the copyright notice,
      which comes from the texititlepage() in zsh.yo

I feel these are OK, but I guess we can `fix' (1-2) if necessary.

[2] Foot note (at the bottom of each page)
In the html's generated by texi2any, the foot note is just
'This document was generated on ... using texi2html 1.82.'
i.e., two info are missing:
(2-1) name of the user who has generated the html is missing.
      I guess this can't be fixed easily.

(2-1) zsh version info 'Zsh version ..., released on ...'
      is missing. I can fix this.

[3] output from yodl example() macro.
For example, see the following example in Invocation.html#Invocation:
    zsh -x -o shwordsplit scr

The amount of indentation, and the spaces before/after the example
are different. I feel the one generated by texi2any is *better*.

[4] Navigation menu (at the top of each chapter/section)
texi2html:
[ < ][ > ]   [ << ][ Up ][ >> ]   [Top][Contents][Index][ ? ]
texi2any:
[ << ][ < ][ Up ][ > ][ >> ]   [Top][Contents][Index][ ? ]

I don't know whether this can be configured in texi2any.

Re: texi2html vs texi2any/makeinfo

[Axel Beckert]

Hi,

On Thu, May 21, 2015 at 01:55:23AM +0900, Jun T. wrote:
> texi2html has been discontinued around 2010/2011,

Debian's zsh package no more uses texi2html since 2013 and replaced
texi2html with makeinfo from texinfo.

Back then I forwarded our patch[1] to zsh-workers in 31667
(http://www.zsh.org/mla/workers/2013/msg00708.html). There was some
discussion, but no patch satisfying all objections.

[1] https://anonscm.debian.org/cgit/collab-maint/zsh.git/tree/debian/patches/replace-texi2html-with-makeinfo

		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.nonhtmlmail.org/campaign.html | abe@noone.org (Mail+Jabber)
/ \  I love long mails: http://email.is-not-s.ms/ | http://abe.noone.org/ (Web)

Re: texi2html vs texi2any/makeinfo

[Jun T.]

If texinfo-4.x is in use, I think 'makeinfo --html' can not be
used as a replacement of texi2html.

With texinfo-5.x, 'texi2any --html' works but the output is
somewhat different from that produced by texi2html.
'texi2any -c TEXI2HTML=1' is *almost* compatible with texi2html.

For those who are not yet using texinfo-5.x, I temporarily
uploaded the html files produced by 'texi2any -c TEXI2HTML=1'
and 'texi2html' to the following url for comparison:
http://www7a.biglobe.ne.jp/~takimoto/zsh-doc/

I will patch configure.ac so that 'texi2any -c TEXI2HTML=1'
is used if texi2any is found (texi2any is new in texinfo-5),
and texi2html otherwise. Is this OK?

Jun

Re: texi2html vs texi2any/makeinfo

[Peter Stephenson]

On Thu, 21 May 2015 20:13:54 +0900
Jun T. <takimoto-j@kba.biglobe.ne.jp> wrote:
> I will patch configure.ac so that 'texi2any -c TEXI2HTML=1'
> is used if texi2any is found (texi2any is new in texinfo-5),
> and texi2html otherwise. Is this OK?

That sounds like it ought to be OK --- I'll look at the output I get.

pws

Re: texi2html vs texi2any/makeinfo

[Axel Beckert]

Hi,

On Thu, May 21, 2015 at 08:13:54PM +0900, Jun T. wrote:
> If texinfo-4.x is in use, I think 'makeinfo --html' can not be
> used as a replacement of texi2html.

Possible, yes.

> I will patch configure.ac so that 'texi2any -c TEXI2HTML=1'
> is used if texi2any is found (texi2any is new in texinfo-5),
> and texi2html otherwise. Is this OK?

Sounds like a sane solution. Looking forward to it, so I can drop the
mentioned patch in Debian's zsh package. :-)

Thanks!

		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.nonhtmlmail.org/campaign.html | abe@noone.org (Mail+Jabber)
/ \  I love long mails: http://email.is-not-s.ms/ | http://abe.noone.org/ (Web)