[SIP-devel] XML/HTM help files

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

	Hello,

	Finally I "finished" the parser. I could translate all files of my SIP 
version (2004 1 15). Some corrections I had to do by hand, even in cat 
files and xml files. So, the perl file will not generate those files I'm 
sending.
	
	Problems:

	The Fabbri's tags bellow weren't matched with the DTD file. It's 
completely possible, but I didn't know how to do it. I have to 
understand completely the Scilab DTD file and I'm just starting with XML 
and Perl.

	REMARKS
	BUSG AND SHORTCOMINGS
	AVAILABILITY
	KNOWN PROBLEMS
	FILE FORMATS
	ARGV FILES
	IMAGE SEGMENTATION

	(mogrify and im* function suffers more with the absense of this tags).
	The TAG REFERENCES, I think can be matched with BIBLIO tag in the 
Scilab DTD file. I forgot to include it and it can be simple, I think.
	All files has the same date (February 2004) because I didn't want to do 
two passes ore deal with seeks/rewinds in file.
	The symbols I had to deal are the HTML not allowed: '. &, >, etc. 
Sometimes I removed, sometimes changed by the corresponding escape 
caracter by hand.

	Generating:

	The examples I followed are very much simple and are located in 
/scilab-x.x/examples/man-examples-xml/. I followed the clues in the 
directory above and dealing with few erros, I could generate the HTM files.

	Using:

	I don't know another way to do, so, just copy the HTM file in the 
silab-x.x/contrib/sip/man directory.

	Tests:

	I didn't tested it, but only took a look in few files. It was enough to 
detect the SEE ALSO clear, with spaces. I don't know why, but I think it 
can be simple to deal. The worst thing is don't have a XML help file 
from a Scilab less simple function.

	I'm sending the two tar.gz files and the pl file.
	Thanks a lot and was a pleasure to help you. Hope to learn more to help 
you (and me) to create/maintein the help files ok.
	Now it's time to spend some time with my M.Sc. :-) Of course, using SIP 
and Scilab.
	Regards,

	Vitor

p.s.: As always, sorry my english.