Mailing-List: contact cygwin-developers-help AT sourceware DOT cygnus DOT com; run by ezmlm
List-Subscribe: <mailto:cygwin-developers-subscribe AT sources DOT redhat DOT com>
List-Archive: <http://sources.redhat.com/ml/cygwin-developers/>
List-Post: <mailto:cygwin-developers AT sources DOT redhat DOT com>
List-Help: <mailto:cygwin-developers-help AT sources DOT redhat DOT com>, <http://sources.redhat.com/ml/#faqs>
Sender: cygwin-developers-owner AT sources DOT redhat DOT com
Delivered-To: mailing list cygwin-developers AT sources DOT redhat DOT com
Date: Sun, 19 Nov 2000 16:13:36 EST
X-Mailer: Virtual Access by Atlantic Coast PLC, http://www.atlantic-coast.com/va
Message-Id: <VA.00000566.00403b88@thesoftwaresource.com>
To: cygwin-developers <cygwin-developers AT sourceware DOT cygnus DOT com>
Subject: Problems with texi2html, docbook-tools, and building Cygwin Doc???
From: Brian Keener <bkeener AT thesoftwaresource DOT com>
Reply-To: bkeener AT thesoftwaresource DOT com

When I build cygwin from the cvs updates I always get the errors at the 
end of the build regarding db2html and texi2html.  So I decided to do 
something about it and try to get them installed - just to learn and do 
away with the errors.

I am curious before I start this - when was the last time someone tried 
to build texi2html and docbook-tools and the cygwin documentation from 
scratch - does it still work??  It is probably just something in my 
configuration (and my inexperience) but this did seem extremely more 
difficult and troublesome than some of the other things I have tried.

Following the FAQ instructions I went to the appropriate cvs servers for 
texi2html and docbook-tools and did a cvs checkout on them. I also 
downloaded a perl-5 binary package from its appropriate location.  I got 
the perl installed no sweat and then moved on to texi2html.

I did my configure and then went to do the make.  Right off the bat the 
make complains about @command, @acronym, an out of place @end ifnottex 
and several other items as well as out of place braces which were 
obviously related to the above bad commands.  Of course next time you do 
a make you don't get these errors because make thinks it has already done 
it and finishes the make.  Now if you do a make install on texi2html then 
it makes the appropriate directories and tries to run the install 
executable from vim (which doesn't seem to do what it is supposed to) and 
fails.  Once I figured this out I used the install from /usr/bin and got 
the texi2html files installed in /usr/local where they go by default.  I 
accomplished this through the command line and not actually modifying any 
scripts.

Next I did a make on my cygwin build and it's make files for the 
documentation don't seem to be correct.  I had to change an option for 
texi2html -Isrcdir to texi2html -I=srcdir and also there was another 
reference to -split-chapter which should be -split=chapter.  I have my 
changes on this and I assume I could provide a diff for the maintainer if 
needed.  I finally got it to the point where it wanted to run and then 
complained that the file sites.texinfo was missing.

I also attempted to get the docbook-tools installed, but could only find 
installation instructions for building as an rpm and putting on the web 
(not sure why this would be here??).  I looked in several subdirectories 
and really found nothing referring to configure or makefiles.

I am interested in any additional information and or suggestions anyone 
can provide and also has anyone else run into these same problems and how 
were they resolved.  I'll even accept give it up ;-).