From: Evan Prodromou <evan@glug.org>
Subject: Re: how authors of add-on modules can package documentation
Date: Sun, 17 Mar 2002 18:04:40 -0800 [thread overview]
Message-ID: <877koa3a2v.fsf@gaff.bad-people-of-the-future.san-francisco.ca.us> (raw)
In-Reply-To: <m3r8mikbt6.fsf@laruns.ossau.uklinux.net> (Neil Jerram's message of "17 Mar 2002 23:35:17 +0000")
>>>>> "NJ" == Neil Jerram <neil@ossau.uklinux.net> writes:
NJ> I believe the consensus at the end of those threads preferred
NJ> docs as strings rather than as comments; i.e.
NJ> (define (xxx arg) "Do something" ...)
NJ> rather than
NJ> ;;; Do something
NJ> (define (xxx arg) ...)
OK, but as I mentioned before, there doesn't seem to be much provision
for doc'ing variables, classes, methods, etc. with docstrings.
~ESP
--
Evan Prodromou
evan@glug.org
_______________________________________________
Guile-devel mailing list
Guile-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/guile-devel
next prev parent reply other threads:[~2002-03-18 2:04 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2002-03-17 4:18 how authors of add-on modules can package documentation Neil W. Van Dyke
2002-03-17 16:41 ` Evan Prodromou
2002-03-17 23:35 ` Neil Jerram
2002-03-17 23:45 ` Neil Jerram
2002-03-18 2:04 ` Evan Prodromou [this message]
2002-04-03 5:29 ` Thien-Thi Nguyen
2002-04-03 3:52 ` Thien-Thi Nguyen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/guile/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=877koa3a2v.fsf@gaff.bad-people-of-the-future.san-francisco.ca.us \
--to=evan@glug.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).