Re: documentation: are the .txi files the ones to edit?

[David Bateman]

Daprès boud <address@hidden> (le 27/05/2003):
> hi help-octave,
>   Are the *.txi files in the octave distribution, e.g.
> 
> octave-2.1.48/doc/interpreter/*.txi
> 
> the correct files to edit in order to work on Polish translations
> of the main octave documentation:
> http://www.octave.org/doc/octave_toc.html   ?


Humm, yes and no.... "Yes" if you translate the .txi files they will
appear in the documentation built with texinfo, etc. "No" in that the
.txi files include the inbuilt help from the function definitions (see
the file DOCSTRINGS and the @DOCSTRING directive in the .txi files) to
build the .texi files. So if you do translate you get the text you
changed translated, but also get all of the inlined help from the
functions in English. As well you won't get translated versions of the
function help (eg "help sin").

If you really want Polish translations, the best place to start would
be to propose a replacement for the octave on-line help system that
includes i8n features.... Perhaps also i8n for the error/warning 
messages too... This is a big task. The only other alternative you 
have is to take the .texi (not the .txi files) files can translate 
a document that you maintainer seperately from octave.

Note that matlab doesn't have internationalization either.... That this
isn't really a reason for octave not to...

Also this is not the first time this topic has come up. You should see 
the thread

http://www.octave.org/octave-lists/archive/octave-maintainers.2003/msg00122.html

Cheers
David

-- 
David Bateman                                address@hidden
Motorola CRM                                 +33 1 69 35 25 00 (Ph)
Espace Technologique, Commune de St Aubin    +33 1 69 35 25 01 (Fax)
91193 Gif-Sur-Yvette FRANCE

The information contained in this communication has been classified as: 

[x] General Business Information 
[ ] Motorola Internal Use Only 
[ ] Motorola Confidential Proprietary



-------------------------------------------------------------
Octave is freely available under the terms of the GNU GPL.

Octave's home on the web:  http://www.octave.org
How to fund new projects:  http://www.octave.org/funding.html
Subscription information:  http://www.octave.org/archive.html
-------------------------------------------------------------