Links to manuals

classic Classic list List threaded Threaded
3 messages Options
Reply | Threaded
Open this post in threaded view
|

Links to manuals

Francisco Vila
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; let's
take links to web first:

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

[en] - @ref{Top, Web} - @node Top - web/index.html#top
cs -   @ref{Začátek,Web} - @node Začátek - web/index.cs.html
de -   @ref{Top,Web} - @node Top - web/index.de.html#top
es -   @ref{Web} - @node Arriba - web/web.es.html *
fr -   @ref{Web} - @node Top - web/web.fr.html *
hu -   @ref{Top, Web} - @node Top - web/index.hu.html#top
it -   @ref{Top, Web} - @node Su - web/index.it.html
ja -   @ref{Top, Web} - @node Top - web/index.ja.html#top
nl -   @ref{Top, Web} - @node Top - web/index.nl.html#top
zh -   @ref{Top, Web} - @node Top - web/index.zh.html#top

Targets marked (*) are wrong. Comments follow:

cs - 1st arg to @ref matches @node. Target lacks #top
es - no match, wrong target
fr - no match, wrong target
it - no match, Target lacks #top <--?? Intriguing



I have changed @ref{Web} to @ref{Top,Web} in es/web/manuals.itexi and
will see what happens in offline docs.

--
Francisco Vila. Badajoz (Spain)
www.paconet.org , www.csmbadajoz.com


Reply | Threaded
Open this post in threaded view
|

Re: Links to manuals

Francisco Vila
2011/3/30 Francisco Vila <[hidden email]>:
> 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


Reply | Threaded
Open this post in threaded view
|

Re: Links to manuals

Francisco Vila
2011/3/30 Francisco Vila <[hidden email]>:

> 2011/3/30 Francisco Vila <[hidden email]>:
>> 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.

....

> 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?

Looks crazy but it's true: a single translated node in es/web.texi
which should not be translated, caused all my links to manuals from
manuals.html to be broken.

--
Francisco Vila. Badajoz (Spain)
www.paconet.org , www.csmbadajoz.com