[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH] Implement doctest utility as guild script

From: Dmitry Bogatov
Subject: Re: [PATCH] Implement doctest utility as guild script
Date: Sun, 29 Sep 2013 21:07:18 +0400
User-agent: mu4e; emacs 24.3.1

Ludovic Courtès <address@hidden> 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 <address@hidden>,
Free Software supporter and netiquette guardian.
        git clone git:// --depth 1
        GPG: 54B7F00D
Html mail and proprietary format attachments are forwarded to /dev/null.

Attachment: pgpB0Ww2Jf4H4.pgp
Description: PGP signature

reply via email to

[Prev in Thread] Current Thread [Next in Thread]