Re: [PATCH] Implement doctest utility as guild script

[Dmitry Bogatov <KAction@gnu.org>]

[-- Attachment #1: Type: text/plain, Size: 1063 bytes --]


Ludovic Courtès <ludo@gnu.org> writes:

> I share Ian Price’s concerns regarding the fundamental idea behind
> doctest.  Namely, writing code in strings means that syntax errors can
> only be detected very late, and that the code in there cannot easily
> refer to anything outside;
What do you mean outside? I think it encourages pure function.

Am I understand right, that you would like to check such tests on
`make all`, and not on `make check`?

> furthermore, that pollutes docstrings, whose
> goal is to provide a help string for users.
Definitely right. At current state. But it is possible to separate
actual english documentation string and doctests. Displaying them
in (help function-name) may be turned off or, imho (since I like examples
in documentation), better, made optional.

--
Best regards, Dmitry Bogatov <KAction@gnu.org>,
Free Software supporter and netiquette guardian.
	git clone git://kaction.name/rc-files.git --depth 1
	GPG: 54B7F00D
Html mail and proprietary format attachments are forwarded to /dev/null.

[-- Attachment #2: Type: application/pgp-signature, Size: 835 bytes --]