From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Evan Prodromou Newsgroups: gmane.lisp.guile.devel Subject: Re: how authors of add-on modules can package documentation Date: Sun, 17 Mar 2002 18:04:40 -0800 Organization: GLUG (Guile Lovers Use Guile) http://www.glug.org/ Sender: guile-devel-admin@gnu.org Message-ID: <877koa3a2v.fsf@gaff.bad-people-of-the-future.san-francisco.ca.us> References: <15508.6444.70455.739266@winona.neilvandyke.org> <87zo17f8pr.fsf@tyrell.bad-people-of-the-future.san-francisco.ca.us> NNTP-Posting-Host: localhost.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1016417188 17747 127.0.0.1 (18 Mar 2002 02:06:28 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Mon, 18 Mar 2002 02:06:28 +0000 (UTC) Original-Received: from fencepost.gnu.org ([199.232.76.164]) by main.gmane.org with esmtp (Exim 3.33 #1 (Debian)) id 16mmXc-0004c9-00 for ; Mon, 18 Mar 2002 03:06:28 +0100 Original-Received: from localhost ([127.0.0.1] helo=fencepost.gnu.org) by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian)) id 16mmXG-000160-00; Sun, 17 Mar 2002 21:06:06 -0500 Original-Received: from dsl092-188-167.sfo2.dsl.speakeasy.net ([66.92.188.167] helo=gaff.bad-people-of-the-future.san-francisco.ca.us) by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian)) id 16mmVw-0000wU-00 for ; Sun, 17 Mar 2002 21:04:44 -0500 Original-Received: from evan by gaff.bad-people-of-the-future.san-francisco.ca.us with local (Exim 3.34 #1 (Debian)) id 16mmVt-0004WN-00 for ; Sun, 17 Mar 2002 18:04:41 -0800 Original-To: guile-devel@gnu.org X-PGP-Fingerprint: 1366 538C 1E7D 0093 C45B 1A50 A33C 1E7C 700A 0551 X-Revolutionary-Date: Septidi, 27 Vento^se 210 7:51:18 -37500 In-Reply-To: (Neil Jerram's message of "17 Mar 2002 23:35:17 +0000") Original-Lines: 20 User-Agent: Gnus/5.090005 (Oort Gnus v0.05) Emacs/21.1 (i386-debian-linux-gnu) Errors-To: guile-devel-admin@gnu.org X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.0.5 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Developers list for Guile, the GNU extensibility library List-Unsubscribe: , List-Archive: Xref: main.gmane.org gmane.lisp.guile.devel:105 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.devel:105 >>>>> "NJ" == Neil Jerram 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