Your message dated Tue, 23 Jan 2007 07:02:03 +0000
with message-id <[EMAIL PROTECTED]>
and subject line Bug#403973: fixed in cl-utilities 1.2.4-2
has caused the attached Bug report to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere. Please contact me immediately.)
Debian bug tracking system administrator
(administrator, Debian Bugs database)
--- Begin Message ---
Package: cl-utilities
Version: 1.2.4-1
Severity: minor
Tags: patch
The documentation for the once-only macro should be written instead of
pointing to a newsgroup discussion describing it. Here is a patch that
adds the relevant description:
Index: Source/doc/once-only.html
===================================================================
--- Source.orig/doc/once-only.html 2006-08-06 23:22:30.480823552 +0200
+++ Source/doc/once-only.html 2006-08-06 23:33:13.696039976 +0200
@@ -11,29 +11,57 @@
<p>
-<p><b>once-only</b> <i>(name*) form*</i>
+<p><b>once-only</b> <i>(name*) body-form*</i>
<p>
<p><b>Arguments and Values:</b><p>
<p>
<i>name</i>---a <a
href="http://www.lispworks.com/documentation/HyperSpec/Body/glo_s.html#symbol";><i>symbol</i></a></a>.
<p>
-<i>form</i>---a <a
href="http://www.lispworks.com/documentation/HyperSpec/Body/glo_f.html#form";><i>form</i></a></a>.
<p>
+<i>body-form</i>---a <a
href="http://www.lispworks.com/documentation/HyperSpec/Body/glo_f.html#form";><i>form</i></a></a>.
<p>
<p>
<p><b>Description:</b><p>
<p>Meant to be used in macro code, <b>once-only</b> guards against
-multiple evaluation of its arguments in macroexpansion code. Any
-concise description would be far too vague to grasp, but <a
-href="http://groups.google.com/group/comp.lang.lisp/browse_frm/thread/1783554653afad7f/f6357129c8c1c002?rnum=1&_done=%2Fgroup%2Fcomp.lang.lisp%2Fbrowse_frm%2Fthread%2F1783554653afad7f%2F940b6ebd2d1757f4%3F#doc_f6357129c8c1c002";>this
-thread on comp.lang.lisp</a> does a decent job of explaining what
-<b>once-only</b> does.
-
-<p><p><b>Notes:</b></p>
-
-<p>The description here is frustratingly non-descriptive, and I
-apologize for that. If you understand <b>once-only</b> and can give a
-better explanation, I would be very grateful—not to mention
-completely awed.
+multiple evaluation of its arguments in macroexpansion code.</p>
+
+<p><b>once-only</b> generates a Lisp form that evaluates each lexical
+variable named by the symbols given as <i>name</i> arguments to
+once-only, and evaluates the body forms in a lexical environment where
+these results are bound to their respective originating symbol.</p>
+
+<p>That is, if the only <i>name</i> argument were the single 'alpha
+symbol, the body forms would be evaluated in a lexical environment
+where 'alpha is bound to the result of the evaluation of alpha in the
+lexical environment of the generated Lisp form.</p>
+
+<p>Example:</p>
+
+<p>With the following 3x macro:</p>
+
+<pre>(defmacro 3x (x)
+ `(+ ,x ,x ,x))</pre>
+
+<p>These three forms evaluate to the same result because the form
+given as <i>x</i> argument is referencially transparent (i.e. it
+yields the same result each time it's evaluated):</p>
+
+<pre>(3x 2) === 6
+(3x (1+ 1)) === 6
+(let ((a 1)) (3x (1+ a))) === 6</pre>
+
+<p>But the following form has an argument that has side-effects and has
different results for each of the three
+times it will be evaluated:</p>
+
+<pre>(let ((a 1)) (3x (incf a))) === 9</pre>
+
+<p>The problem is solved by protecting the body of the macro with
+once-only:</p>
+
+<pre>(defmacro 3x (x)
+ (once-only (x)
+ `(+ ,x ,x ,x)))
+
+(let ((a 1)) (3x (incf a))) === 6</pre>
<p class="footer"><hr><a href="index.html">Manual Index</a></p>
It applies to 1.2.4-1.
-- System Information:
Debian Release: 4.0
APT prefers testing
APT policy: (990, 'testing'), (501, 'stable'), (500, 'unstable'), (500,
'stable')
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/bash
Kernel: Linux 2.6.17-2-k7
Locale: [EMAIL PROTECTED], [EMAIL PROTECTED] (charmap=ISO-8859-15)
Versions of packages cl-utilities depends on:
ii common-lisp-controller 6.8 This is a Common Lisp source and c
cl-utilities recommends no packages.
-- no debconf information
--
[EMAIL PROTECTED]
OpenPGP 0xD9D50D8A
signature.asc
Description: Digital signature
--- End Message ---
--- Begin Message ---
Source: cl-utilities
Source-Version: 1.2.4-2
We believe that the bug you reported is fixed in the latest version of
cl-utilities, which is due to be installed in the Debian FTP archive:
cl-utilities_1.2.4-2.diff.gz
to pool/main/c/cl-utilities/cl-utilities_1.2.4-2.diff.gz
cl-utilities_1.2.4-2.dsc
to pool/main/c/cl-utilities/cl-utilities_1.2.4-2.dsc
cl-utilities_1.2.4-2_all.deb
to pool/main/c/cl-utilities/cl-utilities_1.2.4-2_all.deb
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to [EMAIL PROTECTED],
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Peter Van Eynde <[EMAIL PROTECTED]> (supplier of updated cl-utilities package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [EMAIL PROTECTED])
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Format: 1.7
Date: Mon, 22 Jan 2007 14:18:57 +0100
Source: cl-utilities
Binary: cl-utilities
Architecture: source all
Version: 1.2.4-2
Distribution: unstable
Urgency: low
Maintainer: Peter Van Eynde <[EMAIL PROTECTED]>
Changed-By: Peter Van Eynde <[EMAIL PROTECTED]>
Description:
cl-utilities - a Common Lisp library of common functions
Closes: 403973
Changes:
cl-utilities (1.2.4-2) unstable; urgency=low
.
* Added XS-X-Vcs-Darcs header
* modified S-X-Vcs-Darcs to XS-Vcs-Darcs field
* Included better documentation for once-only (Closes: #403973)
Files:
ca7294767ea1ba05152ea1b02e38fdd5 695 devel optional cl-utilities_1.2.4-2.dsc
439c4ff6c9a6b9df642d82276068d60c 3200 devel optional
cl-utilities_1.2.4-2.diff.gz
4e6045873abfa974e952232666d47a2e 26002 devel optional
cl-utilities_1.2.4-2_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
iD8DBQFFtLoL11ldN0tyliURAoIZAJ0SeRF2amgwLXHyZ+kWLIk7aRZu0ACgpQYa
meWzjXaa+3AqgxBSynUjLkw=
=HgxL
-----END PGP SIGNATURE-----
--- End Message ---
