Re: Re: [SIP-devel] XML help files

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

> First, I'll try to accommodate some inexistent manual sections under
> DESCRIPTION_ITEM tags. Other sections will be treated like this:
> 
> - we'll use/distribute our own XSL and DTD to translate and define new
> tags. I suggest generic SECTION and SUBSECTION tags, and the name of
> the section as a sub-tag NAME of these.

	Hello Ricardo,

	I think these are "clean" solutions. The additional problem is to 
generate and maintaing our own XSL and DTD, but, made it, I think the 
problems of "different" tags are solved.
	If you want, I can write a little manual to explain "where to put what" 
to help developers to generate they help files.

> - we propose these XSL and DTD to Scilab group, but we continue to
> use/maintain our own versions of these. xmltohtml enables us to specify
> our own XSL.

	Good. But what it means in fact? These new files could be part of 
Scilab distribution and changes in xmltohtml would be made too?

> I'm just saying that we could have used formatman to translate our old
> man to xml just like you did in PERL, but this doesn't matter anymore.

	Ok. Right.

> Now I'm sure. Here's an excerpt from http://www.w3schools.com/xml/xml_cdata.asp:
> "Everything inside a CDATA section is ignored by the parser.
>  If your text contains a lot of "<" or "&" characters - as program
>  code often does - the XML element can be defined as a CDATA section."
> 
>  So invalid characters in code examples inside CDATA don't need to be escaped.

	Thanks.

> This will certainly be fixed by patching "xmltohtml.sci".
> 
> So most problems seems to be solved in theory now,
> I'll be implementing the solution tomorrow.
> Any comments are welcome.

	Excelent job. If you need any specific help, feel free to contact me 
directly. I have no so much time, but would be glad to help you.
	Greetings,

	Vitor
	vi...@cn...