Makefile.in: location of *.html

David Kastrup

2005-02-03 23:49:10 UTC

Post by Reiner Steib
this change...
,----
| --- Makefile.in 12 Jan 2005 14:28:13 -0000 1.75
| +++ Makefile.in 12 Jan 2005 14:45:54 -0000 1.76
| [...]
| cp ChangeLog $(FTPDIR)
| - cp doc/*.html $(WWWDIR)/doc
| + cp doc/auctex/*.html $(WWWDIR)/doc
| chmod -R go-w+rX auctex-$(TAG)
| [...]
`----
... breaks building of the snapshots on my system (Thanks to Christian
Schlauer for pointing this out). Probably the default output location
of texi2html has changed.

Probably, since it looks like it was a "fly by" change I did to get
the last release to compile. I am using a rather experimental Fedora
setup, so my executables should be pretty up to date. To wit:

Name : tetex Relocations: (not relocatable)
Version : 2.0.2 Vendor: Red Hat, Inc.
Release : 30 Build Date: Wed 19 Jan 2005 11:41:34
AM CET
Install Date: Fri 21 Jan 2005 01:20:52 AM CET Build Host: decompose.build.r
edhat.com
Group : Applications/Publishing Source RPM: tetex-2.0.2-30.src.rpm
Size : 35425577 License: distributable
Signature : (none)
Packager : Red Hat, Inc. <http://bugzilla.redhat.com/bugzilla>
URL : http://www.tug.org/teTeX/
Summary : The TeX text formatting system.

Uh, I mean, so my executables should be ancient as petrified reptile
droppings. Whatever.

I needed that change to get the _standard_ Fedora build succeed. So
we better find a solution that will work with both older and newer
setups. The Fedora texi2html says:

Usage: texi2html [OPTIONS] TEXINFO-FILE
Translates Texinfo source documentation to HTML.
Option Type Default Description
-debug=i 0 output HTML with debuging information
-expand=s info Expand info|tex|none section of texinfo source
-help:i print help and exit
-I=s append $s to the @include search path
-init_file=s load init file $s
-l2h! if set, uses latex2html for @math and @tex
-lang=s use $s as document language (ISO 639 encoding)
-menu! 1 ouput Texinfo menus
-number! 1 use numbered sections
-out_file=s if set, all HTML output goes into file $s
-prefix=s use as prefix for output files, instead of <docname>
-sec_nav! 1 output navigation panels for each section
-short_ext! 0 use "htm" extension for output HTML files
-short_ref! if set, references are without section numbers
-split=s split document on section|chapter else no splitting
-subdir=s put HTML files in directory $s, instead of $cwd
-toc_file=s use $s as ToC file, instead of <docname>_toc.html
-top_file=s use $s as top file, instead of <docname>.html
-Verbose! print progress info to stdout
-version print version and exit
Note: 'Options' may be abbreviated. 'Type' specifications mean:
<none>| ! no argument: variable is set to 1 on -foo (or, to 0 on -nofoo)
=s | :s mandatory (or, optional) string argument
=i | :i mandatory (or, optional) integer argument

Post by Reiner Steib
We should either specify the output directory explicitly (1) in
doc/Makefile.in or add something like (2) in Makefile.in.
(1)
--8<---------------cut here---------------start------------->8---
--- Makefile.in 29 Nov 2004 16:34:12 +0100 1.21
+++ Makefile.in 03 Feb 2005 16:28:27 +0100
@@ -21,10 +21,10 @@
all: auctex.dvi tex-ref.dvi auctex.info
dist: auctex.info INSTALL INSTALL.windows README CHANGES TODO FAQ \
- auctex_toc.html auctex.ps auctex.pdf tex-ref.ps tex-ref.pdf
+ auctex/auctex_toc.html auctex.ps auctex.pdf tex-ref.ps tex-ref.pdf
-auctex_toc.html: auctex.texi
- $(TEXI2HTML) -split_node auctex.texi
+auctex/auctex_toc.html: auctex.texi
+ $(TEXI2HTML) -subdir=auctex -split_node auctex.texi
tex-ref.dvi: tex-ref.tex
$(TEX) tex-ref
--8<---------------cut here---------------end--------------->8---

That looks like it could work.

However, the TeXlive2003 texi2html offers only options:

/usr/TeX/bin/i386-linux/texi2html -subdir=auctex xxx.texi
This is texi2html 1.56k
To convert a Texinfo file to HMTL: /usr/TeX/bin/i386-linux/texi2html [options] file
where options can be:
-expandinfo : use @ifinfo sections, not @iftex
-glossary : handle a glossary
-invisible name: use 'name' as an invisible anchor
-Dname : define name like with @set
-I dir : search also for files in 'dir'
-menu : handle menus
-monolithic : output only one file including ToC
-number : number sections
-split_chapter : split on main sections
-split_node : split on nodes
-usage : print usage instructions
-verbose : verbose output
To check converted files: /usr/TeX/bin/i386-linux/texi2html -check [-verbose] files

and TeXlive2004:

Usage: texi2html [OPTIONS] TEXINFO-FILE
Translates Texinfo source documentation to HTML.
Option Type Default Description
--css-include=s use css file $s
--debug=i 0 output HTML with debuging information
--help:i print help and exit
--I=s append $s to the @include search path
--ifhtml! expand ifhtml and html sections
--ifinfo! expand ifinfo
--ifplaintext! expand ifplaintext sections
--iftex! expand iftex and tex sections
--ifxml! expand ifxml and xml sections
--init-file=s load init file $s
--l2h! if set, uses latex2html for @math and @tex
--lang=s use $s as document language (ISO 639 encoding)
--macro-expand=s output macro expanded source in <file>
--menu! 1 output Texinfo menus
--no-expand=s Don't expand the given section of texinfo source
--no-validate! 0 suppress node cross-reference validation
--node-files! 0 produce one file per node for cross references
--number! 1 use numbered sections
--output=s output goes to $s (directory if split)
--P=s prepend $s to the @include search path
--prefix=s use as prefix for output files, instead of <docname>
--sec-nav! 1 output navigation panels for each section
--short-ext! 0 use "htm" extension for output HTML files
--short-ref! if set, references are without section numbers
--split=s
split document on section|chapter|node else no splitting
--toc-file=s use $s as ToC file, instead of <docname>_toc.html
--toc-links! 0 create links from headings to toc entries
--top-file=s use $s as top file, instead of <docname>.html
--use-nodes! 0 use nodes for sectionning
--Verbose! print progress info to stdout
--version print version and exit
Note: 'Options' may be abbreviated. 'Type' specifications mean:
<none>| ! no argument: variable is set to 1 on -foo (or, to 0 on -nofoo)
=s | :s mandatory (or, optional) string argument
=i | :i mandatory (or, optional) integer argument

Post by Reiner Steib
I think (1) is preferable. Opinions?

The -subdir= option seems to be not well-supported. While it will
work with a tetex-2.0.2 Fedora setup, it will neither work with
TeXlive2003 or TeXlive2004.

So I am afraid that (1) does not look like a winner here.

--
David Kastrup, Kriemhildstr. 15, 44793 Bochum