Re: [gobo-eiffel-develop] Serializer example

[Colin P. A. <co...@co...>]

>>>>> "Eric" == Eric Bezault <er...@go...> writes:

    Eric> Hi Colin, Would it be possible that you add a Readme.txt
    Eric> file in your serializer example explaining what it is and
    Eric> how to use it? All examples should come with a Readme file.

It's not really finished yet (although it is working), as I am still
refactoring the XSLT serialization (and fixing bugs). I intend to
provide documentation on the serializer as part of the XSLT
documentation (although I will add a separate link to it from the main
XML documentation page, to draw attention to it), and I will refer to
the example in that, I think. 
So the Readme.txt will probably just point to the documentation.

    Eric> Also, it would be nice if you could update the test class
    Eric> $GOBO/test/example/xml/xm_etest_serializer.e to provide some
    Eric> input sample and check the output, as it is done in other
    Eric> tests such as the one for the schematron or for the argument
    Eric> library example.

What to test? It's a general XML serializer, with many options
affecting the way serialization is performed.
If it's just to check that the example compiles, then I could
serialize <doc/> with options to specify that it comes out as <doc/>.
Serialization in general is tested within the XSLT tests.

    Eric> Finally, don't forget to update the file $GOBO/History.txt
    Eric> from time to time.

I will do that too when I have finished refactoring.
-- 
Colin Adams
Preston Lancashire