[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: SXML documentation
From: |
Andy Wingo |
Subject: |
Re: SXML documentation |
Date: |
Fri, 16 Dec 2011 15:33:22 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/23.3 (gnu/linux) |
On Fri 16 Dec 2011 11:52, Ian Price <address@hidden> writes:
> Hi guilers,
>
> The documentation for this in the manual is pretty sparse. Is it
> possible to lift the documentation for the procedures in the source up
> to the manual where people who don't read the source can find it?
>
> As an example, the function 'find-string-from-port?' in (sxml ssax
> input-parse) has the signature
> find-string-from-port? _ _ . _
> which is not particularly meaningful. Or how would I know what the
> 'ssax:xml->sxml' argument 'namespace-prefix-assig' is if I didn't know
> already?
It probably needs to be rewritten. It was part of an experiment to do
literate documentation, and it's pretty illiterate in the end.
Any patches to improve this situation are most welcome.
Andy
--
http://wingolog.org/