Hello,

I would like to have a good support of translated manuals with
recommendations for all the related subjects.  I have split the
discussion in 3 mails.

The first issue is about leaving untranslated (in most cases, english)
nodes and anchors.

The options I gathered are:

1) node/anchor/float identifier remains untranslated
2) an anchor with the untranslated name is added for each node
   (and anchor and float)
3) there is a mention in the Texinfo code of the untranslated name,
   without any effect on the output (for example ignored macro argument).
4) no untranslated name at all.

I think that option 1) is not in line with the Texinfo format design,
where nodes can often appear in the output.

Option 2) should be practical in a transitory period for external manuals
linking to partially translated manuals.
3) allows to do some grepping and similar (untranslated name could also
be obtained from the Texinfo tree using source marks) for maintainance,
and allows english speaking people to understand where in the manual one
is, but is otherwise similar to 4).

What we could recommend:

My proposal is to recommend to use 2) in the short term, and to switch
to 3) or 4) (depending on the need) in the long term when the
translation is complete enough and has been complete for some time.  2)
could also be used in the long term, but there is no clear use case
(except maybe for the lilypond manual).

Remarks, thoughts?

References on past discussions more or less related:

https://lists.gnu.org/archive/html/bug-texinfo/2008-07/msg00005.html
https://lists.gnu.org/archive/html/bug-texinfo/2025-02/msg00079.html
https://lists.gnu.org/archive/html/bug-texinfo/2025-02/msg00080.html

-- 
Pat

Reply via email to