[Po4a-devel] [help-texinfo] @xref best practices for i18n/l10n

[Gavin Smith]

On Fri, Sep 22, 2017 at 06:48:18AM +0900, Jean-Christophe Helary wrote:
> I'm working on a manual written in texinfo and I found a string similar to this:
> 
> @xref{node name} and following.
> 
> Once compiled, the document becomes ???See "node name" and following???.
> 
> When translating to a language that puts the verb at the end, like Japanese (and I guess German and others would have the same issue) the final document must be rendered as:
> 
> ???"node name" and following See???
> 
> My understanding of @xref is that it is not possible, so we should avoid to put stuff after "node name".

Use @ref instead of @xref if you need to be flexible with the word 
order.

> Also, does makeinfo use "translation tables" to create the proper localized string for such devices as xref?

Yes, that's right. Use the @documentlanguage command for this.