[Top][All Lists]

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

Re: How to write documentation comments for procedures?

From: Arne Babenhauserheide
Subject: Re: How to write documentation comments for procedures?
Date: Tue, 21 Aug 2018 23:41:09 +0200
User-agent: mu4e 1.0; emacs 25.3.1

Arun Isaac <address@hidden> writes:

>> It still makes the second and later lines not indented though
>> (starting at position 0, while the first line is indented, not
>> starting at 0).
> Looking at the guile source code, the lack of indentation in the second
> and later lines seems to be the convention. So, I don't think this is a
> problem. Something like the following is fine.
> (define (foo arg)
>   "This is the first line.
> This is the second line."
>   #t)

This is what I do, too.

Note also that you can add *data* to the procedure, too, by adding a
literal array after the docstring. I use that for the equivalent of
Python doctests, but without the brittleness of writing stringly code:

    (define (example)
       "Testing doctests"
       #((tests ('mytest
              (test-assert #t)
              (test-assert #f))))

- Example:
- Doctest-runner:

Best wishes,
Unpolitisch sein
hei├čt politisch sein
ohne es zu merken

Attachment: signature.asc
Description: PGP signature

reply via email to

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