SVG RNGs

Hi

Yesterday I tried
http://www.w3.org/Graphics/SVG/1.1/rng/ ,
here's some feedback:

1. .zip

It would be great if there would be a .zip, .tar.gz or tar.bz2 
containing all files, for all current and future SVG schemas 
(DTD/RNG/WXS) if they contain more than one file.

2. Doctype

Jing: "fatal: file not found: /[...]/relaxng.dtd
(No such file or directory)"

I suggest to delete
  <!DOCTYPE grammar SYSTEM "../relaxng.dtd">
from all files; you can use an RNG [rngrng] to validate the RNGs :).
Not referencing a DTD but instead having truly standalone documents will 
also speed up RNG validation in most cases (or specify standalone:yes).

3. Documentation

I hope that the documentation will be more elaborate in future versions 
of the 1.1, 1.2, and 2.0 RNGs.
Tools like
http://www.pinkjuice.com/ruby/jelly/
can then extract this embedded documentation and enclose it in the docs 
for the generated lib.

Here are some example based on
http://www.w3.org/TR/2002/WD-SVG11-20020108/SVG.xsd
:
http://www.pinkjuice.com/ruby/jelly/samples/pre_alpha/y2002m04d11/docs/classes/PresentationAttributes_LightingEffects.html
"The following presentation attributes apply to 'feDiffuseLighting' and 
'feSpecularLighting' elements"
http://www.pinkjuice.com/ruby/jelly/samples/pre_alpha/y2002m04d11/docs/classes/XlinkRefAttrs.html
"For most uses of URI referencing: standard XLink attributes other than 
xlink:href"
http://www.pinkjuice.com/ruby/jelly/samples/pre_alpha/y2002m04d11/docs/classes/TestAttrs.html
"Common attributes to check for system capabilities"

The 1.2 and 2.0 RNGs could feature even more useful documentation :)

Tobi

[rngrng]
http://www.thaiopensource.com/relaxng/relaxng.rng

-- 
http://www.pinkjuice.com/

Received on Sunday, 27 July 2003 05:25:55 UTC