[cl-debian] Bug#450783: cl-s-xml: example in documentation does not work, undefined function: trace-xml-log

[Luca Capello]

Hi Brian!

On Sat, 10 Nov 2007 15:18:23 +0100, Brian Kudowski wrote:
> the sax parser example code in the documentation calls the function
> trace-xml-log(), which seems not to be included in the s-xml package
> (i loaded s-xml via asdf as described in the readme.debian file).

Actually, the function `trace-xml-log' is not loaded by s-xml.asd, which
resulted in not being available through ASDF.  This because all which is
in $s-xml/test/ are tests and examples, thus not covered by s-xml.asd.

> I see 2 possibilites to improve the docs at this point:
>
> #1: use an example without trace-xml-log().
> #2: point the user to the file $s-xml/test/tracer.lisp, which does
> include trace-xml-log() and also the complete sax parser example
> code. No copy and paste needed, if we point the user to the
> tracer.lisp file.

I still think that the solution would be to provide an ASDF test suite
(as well an example one), as I suggested in the upstream mailing list a
long time ago [1].

Can you try again the sax parser example code after having loaded
/usr/share/common-lisp/source/s-xml/tracer.lisp?  This should solve your
problem.

I'm working on providing two new ASDF systems, s-xml.examples and
s-xml.test, which you can then load if you want to try the examples or
testing your installation.

Thx, bye,
Gismo / Luca

Footnotes: 
[1] http://common-lisp.net/pipermail/s-xml-devel/2006-May/000027.html