From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Andy Wingo Newsgroups: gmane.lisp.guile.user Subject: Re: macro documentation? (was: Re: Req for help on objects and environments) Date: Tue, 07 Sep 2004 20:40:23 +0200 Sender: guile-user-bounces+guile-user=m.gmane.org@gnu.org Message-ID: <1094582424.3785.301.camel@lark> References: <1094123345.4412.5.camel@kuzgun> <20040902115316.GB30187@www> <1094238653.3785.68.camel@lark> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1094660806 25660 80.91.224.253 (8 Sep 2004 16:26:46 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 8 Sep 2004 16:26:46 +0000 (UTC) Cc: Guile Users Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Wed Sep 08 18:26:28 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1C54kG-0003u1-00 for ; Wed, 08 Sep 2004 17:52:28 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1C54pX-0003ep-Il for guile-user@m.gmane.org; Wed, 08 Sep 2004 11:57:55 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1C54pT-0003ea-Nm for guile-user@gnu.org; Wed, 08 Sep 2004 11:57:51 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1C54pR-0003eO-Ur for guile-user@gnu.org; Wed, 08 Sep 2004 11:57:51 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1C54pR-0003eL-Rt for guile-user@gnu.org; Wed, 08 Sep 2004 11:57:49 -0400 Original-Received: from [216.166.232.203] (helo=johnson-resources.com) by monty-python.gnu.org with esmtp (TLSv1:DES-CBC3-SHA:168) (Exim 4.34) id 1C54jg-0002g1-9F for guile-user@gnu.org; Wed, 08 Sep 2004 11:51:52 -0400 Original-Received: from localhost (mantis.schoolnet.na [::ffff:196.44.140.238]) (AUTH: LOGIN wingo) by johnson-resources.com with esmtp; Wed, 08 Sep 2004 11:51:44 -0400 id 001201C4.413F2A92.0000459A Original-Received: from wingo by lark with local (Exim 3.36 #1 (Debian)) id 1C4ktO-0008Fh-00; Tue, 07 Sep 2004 20:40:34 +0200 Original-To: Richard Todd In-Reply-To: X-Mailer: Evolution 1.5.93 X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: General Guile related discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-user-bounces+guile-user=m.gmane.org@gnu.org Xref: main.gmane.org gmane.lisp.guile.user:3442 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.user:3442 Hey Richard, On Mon, 2004-09-06 at 17:34 -0500, Richard Todd wrote: > On Sep 3, 2004, at 2:10 PM, Andy Wingo wrote: > > > > On Thu, 2004-09-02 at 13:53 +0200, tomas@fabula.de wrote: > >> (Note as well that the properties get attached to the *value*, not to > >> the > >> *variable*): > > A similar problem appears when trying to document syncase macros... > they all (display) as: > > # > > When I apply the 'documentation property to one of these macros, all > the sudden ALL my syncase macros have this documentation. That's what you get for using syncase ;-) Seriously though, this is a problem. Perhaps we can make define-with- docs set the object-property on the _variable_ rather than (in addition to?) the value: (define-macro-with-docs (define-with-docs sym docs val) "Define a variable with documentation." `(begin (define ,sym ,val) (set-object-property! (module-variable ,sym) 'documentation ,docs) *unspecified*)) Of course with the proper checks, etc. Then when we implement Marius's Grand New Help Scheme (GNHS), we can make `help' look for documentation on the variable first. In any case, we implement it in (texinfo reflection). > How does this sc-macro entity know which transformation to make? Presumably because it is passed the whole expression, including the name of the macro, which would then be looked up in the lexical environment or in the global macro-table. Regards, -- Andy Wingo http://ambient.2y.net/wingo/ _______________________________________________ Guile-user mailing list Guile-user@gnu.org http://lists.gnu.org/mailman/listinfo/guile-user