Subject: Troubles with make/install for localized info
From: Vadim V. Zhytnikov
Date: Wed, 14 Dec 2005 23:58:07 +0300
Hi!
Trying to incorporate Spanish and Portuguese
documentation into standard Maxima make/install
procedure I run into some trouble. The main
troublemaker is .info files and too rigid
(or shall I say too automatic) automake/autoconf
procedure for .info installation.
At present Maxima texinfo source directory
schematically looks as follows:
/doc/maxima.texi
/doc/es/maxima.texi
/doc/pt/maxima.texi
Three subdirs are English, Spanish, and
Portuguese translations respectively.
There is no trouble with .html documentation.
Make/install produces
/maxima.html
/es/maxima.html
/pt/maxima.html
This is what we need and in fact this
is standard scheme for localized .html
documentation - each language goes into
corresponding subdirectory.
Unfortunately similar approach doesn't work
for .info. The main trouble is that there
is no standard scheme for localized .info
documentation placement. Usually info keeps all
.info files in one directory. So if we'll try
install maxima info's as follows
/usr/share/info/maxima.info
/usr/share/info/es/maxima.info
/usr/share/info/pt/maxima.info
then documentation in /es and /pt will not
be visible to info command. Even more
automake machinery doesn't allow to install
different info files in different directories.
All infos automatically go into one target
directory and I don't see any way to override
this behavior.
OK. What about
/usr/share/info/maxima.info
/usr/share/info/maxima_es.info
/usr/share/info/maxima_pt.info
But with automake this is impossible to implement
without renaming source .texi files
/doc/maxima.texi
/doc/es/maxima_es.texi
/doc/pt/maxima_pt.texi
The trouble is that automake overrides makeinfo's
--output option and always produces maxima.info
from maxima.texi.
At present I see only one scheme which
can be implemented with automake/autoconf:
Sources:
/doc/maxima.texi
/doc/es/maxima_es.texi
/doc/pt/maxima_pt.texi
Info:
/maxima.info
/maxima_es.info
/maxima_pt.info
HTML:
/maxima.html
/es/maxima_es.html
/pt/maxima_pt.html
Notice extra _es and _pt in .html
file names. This is not the thing I'd like to
see but may be considered as acceptable trade-off.
Maybe somebody can suggest a better scheme?
Any ideas?
--
Vadim V. Zhytnikov