[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 0.9.9.5; 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://kaction.name/rc-files.git --depth 1
GPG: 54B7F00D
Html mail and proprietary format attachments are forwarded to /dev/null.
pgpB0Ww2Jf4H4.pgp
Description: PGP signature