Re: [SIP-devel] XML and HTML help files - again

[Vitor V. A. S. <vi...@cn...>]

> Hi Vitor,
> As I'm trying to learn xml to write help pages for new functions in SIP, I 
> wondered why you use <ALINK> rather than <LINK> ?

	Hello.
	The answer is: because "they" said to. I took a look in the man help 
page, and the example used the <ALINK> tag. As a matter of fact are 
recomended to use the <LINK> tag.
> 
> The Scilab help page for man says to use LINK, but here are the lines that 
> follow:
>  <SEE_ALSO>
>            <SEE_ALSO_ITEM> <ALINK>man</ALINK> </SEE_ALSO_ITEM>
>            <SEE_ALSO_ITEM> <ALINK>apropos</ALINK> </SEE_ALSO_ITEM>
>          </SEE_ALSO>
> 
	As I wrote. I did like.
	
> Both LINK and ALINK seem to work. Strange...

	Well, I prefer to say: they don't work. Both. Even for me. When I call 
the help page, the SEE ALSO don't link to another function.
	To give you an anwer: in my opinion, the <LINK> tag is the correct one. 
Sorry don't be helpful, but this is one of the problems I couldn't solve 
in the help translation until now.

> Best regards
> Jocelyn

	I think is a great ideia write the help files directly in XML format.
	Thanks for asking and good work. Please, let me know if you find any 
better answer or solution.
	Keep in touch,

	Vitor