[translations] Re: Links to manuals

[Francisco Vila <paconet.org@xxxxxxxxx>]

2011/3/30 Francisco Vila <paconet.org@xxxxxxxxx>:
> Hello all,
>
> I am doing a round on web links to manuals to see if I make any sense
> from correspondence of @ref to @node.  It is a bit mysterious;

Now it's the turn of
NOTATION MANUAL. I am talking about offline compiled manuals here;
presumably those which will be online when 2.14 launches.

There is no top @node for Notation in either language.


language - link in ll/web/manuals.itexi -  leads to HTML page:

[en] - @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
- notation/index.html#top

cs -   @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Začátek,Notový
zápis}} - notation/zacatek.cs.html#za_010d_00e1tek *404

de -   @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
- notation/index.de.html#top

es -   @ifWebLinks{@manualStableNotationSplitNoName-es,@rusernamed{Top,Notación}}
- notation/arriba.es.html *404

fr -   @ifWebLinks{@manualStableNotationSplitNoName-fr,@rusernamed{Top,Notation}}
- notation/index.fr.html#top

hu -   @ifWebLinks{@manualStableNotationSplitNoName-hu,@rusernamed{Top,Kottaírás}}
- notation/index.hu.html#top

it -   @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
- notation/su.it.html *404

ja -   @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,記譜法}}
- notation/index.ja.html#top

nl -   @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notatie}}
- notation/index.nl.html#top

zh -   @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
- notation/index.zh.html#top

Targets marked (* 404) are wrong. We have three of these, for cs/, es/
and it/. Comments follow:

cs - One could think that Target is taken from 1st arg to @rusernamed,
but that contradicts es/ and it/ cases, both of which have Top here.
es - macro call ends in -es, but so do fr/ and hu/
it - macro call does not end in -it but we have a broken link nevertheless.

It could be that Target base name for HTML is taken from top @node in
ll/web.texi?? Compare my previous message.  All three broken cases
here, namely cs/es/it had @node Začátek/Ariba/Su in web.texi,
respectively.  Does this make sense?

Could it be that Documentation/po/xx.po files are used to translate
these targets?

For me, the cryptic mechanism that produces all those long macro names
is too prone to this type of errors.  One can not grep for node names
or link targets.

web/macros.itexi files look OK.  Help!
-- 
Francisco Vila. Badajoz (Spain)
www.paconet.org , www.csmbadajoz.com