[Bug 1973] Convert from texi2www to texi2html

[bugzilla-daemon at rtems.org]

https://www.rtems.org/bugzilla/show_bug.cgi?id=1973

--- Comment #9 from Joel Sherrill <joel.sherrill at oarcorp.com> 2011-12-06 08:23:31 CST ---
(In reply to comment #7)
> (In reply to comment #3)
> > How that? None of the standard autoconf nor automake macros utilize texi2html,
> > as can be shown by a brute force grep:
> 
> OK, now I see what you did. You replaced one non-standard tool (texi2www) with
> another one (texi2html)

It is non-GNU but included in the Fedora and CentOS repositories.  It is
certainly way more standard than texi2www.  And it is what texi2any in the next
texinfo is intending to be compatible with.  This isn't a final step. It is
just a big step forward.

A transitional texi2html will be in the next texinfo release. The long term
goal is to switch to texi2any.  When this patch is committed and we are happy
with it using texi2html, it may make sense to try to install a texinfo
development version and try it.  Detect presence of texi2any and use that. Then
when the texinfo version with texi2any (and the transitional texi2html version)
shows up in distributions, we will just prefer it.

We were just the last user on texi2www and needed to jump.  Unfortunately, we
hit a window where texi2html is merging into texinfo and transforming into
texi2any.

> (In reply to comment #5)
> > I suspect that it is easier to commit this and fix anything spotted after that.
> 
> Agreed.

I should have done a make install and a build inside and outside the tree. It
is a lot of changes just to get the docs to build at all.

> > But I will fix anything caught in review now.
> 
> I am facing plenty of problems.
> 
> The only thing that seems close to be working is in-source-tree building.
> In-source-tree "make install" fails.
> 
> VPATH-building raises dozens of "Can't find *.texi" and Unknown node" warnings.

I am adding your patch to add -I. to the TEXI2HTML_ARGS.

More on other patches in a reply to that.

> > I am sure there is follow up clean up to do since going to the standard
> > texi2html tool may make it easier to do things where we previously had
> > conditionals.
> Again, texi2html is not a "standard info tool" - It's an entirely separate and
> independent package of it's own right.
> 
> Unlike "makeinfo" (http://www.gnu.org/software/texinfo), texi2html is not even
> a gnu package (http://www.nongnu.org/texi2html)

Agreed.  It is still a very large step up from texi2www.  makeinfo --html does
not take exactly the same input from what I could tell. More importantly, the
output from texi2html is nice.  I will try makeinfo again once this is
committed to verify it wasn't something else I was seeing.  But the texi2html
input syntax and markup commands are what will be the set in texi2any.

-- 
Configure bugmail: https://www.rtems.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are watching all bug changes.