* bug#9668: 24.0.50; doc of `declare' (non-CL version)
@ 2011-10-04 16:23 Drew Adams
2012-01-07 5:48 ` Lars Magne Ingebrigtsen
0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2011-10-04 16:23 UTC (permalink / raw)
To: 9668
`(elisp) Defining Macros says' that `declare' works only for `debug' and
`indent'. But the Emacs Lisp source code has lots of occurrences of
`doc-string', and `ignore' as well. Seems like the doc is not
up-to-date? (I'm not counting occurrences of CL's `declare special'.)
(And the `declare' doc string just refers to the manual - does not
describe the SPECS that it mentions at all. That's probably OK.)
In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
of 2011-09-19 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt'
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#9668: 24.0.50; doc of `declare' (non-CL version)
2011-10-04 16:23 bug#9668: 24.0.50; doc of `declare' (non-CL version) Drew Adams
@ 2012-01-07 5:48 ` Lars Magne Ingebrigtsen
2012-01-07 15:35 ` Drew Adams
0 siblings, 1 reply; 5+ messages in thread
From: Lars Magne Ingebrigtsen @ 2012-01-07 5:48 UTC (permalink / raw)
To: Drew Adams; +Cc: 9668
"Drew Adams" <drew.adams@oracle.com> writes:
> `(elisp) Defining Macros says' that `declare' works only for `debug' and
> `indent'. But the Emacs Lisp source code has lots of occurrences of
> `doc-string', and `ignore' as well. Seems like the doc is not
> up-to-date? (I'm not counting occurrences of CL's `declare special'.)
The only instances of `ignore' I could find weren't in `defmacro' forms,
which probably means that it has no effect whatsoever.
But I've now added `doc-string' to the manual.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog http://lars.ingebrigtsen.no/
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#9668: 24.0.50; doc of `declare' (non-CL version)
2012-01-07 5:48 ` Lars Magne Ingebrigtsen
@ 2012-01-07 15:35 ` Drew Adams
2012-01-25 23:58 ` Lars Ingebrigtsen
0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2012-01-07 15:35 UTC (permalink / raw)
To: 'Lars Magne Ingebrigtsen'; +Cc: 9668
> The only instances of `ignore' I could find weren't in
> `defmacro' forms, which probably means that it has no effect whatsoever.
>
> But I've now added `doc-string' to the manual.
Thanks. I don't have your fix in front of me. Hope you also corrected the last
sentence of the node: "It only affects secondary features: indentation and
Edebug."
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#9668: 24.0.50; doc of `declare' (non-CL version)
2012-01-07 15:35 ` Drew Adams
@ 2012-01-25 23:58 ` Lars Ingebrigtsen
2012-01-26 0:22 ` Drew Adams
0 siblings, 1 reply; 5+ messages in thread
From: Lars Ingebrigtsen @ 2012-01-25 23:58 UTC (permalink / raw)
To: Drew Adams; +Cc: 9668
"Drew Adams" <drew.adams@oracle.com> writes:
> Thanks. I don't have your fix in front of me. Hope you also
> corrected the last sentence of the node: "It only affects secondary
> features: indentation and Edebug."
No, because I didn't think that was wrong. Does `doc-string' do
anything other than alter the indentation of the doc string?
Hm... I guess `autoload' also uses it. I'll fix up that paragraph,
too.
--
(domestic pets only, the antidote for overdose, milk.)
http://lars.ingebrigtsen.no * Sent from my Rome
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#9668: 24.0.50; doc of `declare' (non-CL version)
2012-01-25 23:58 ` Lars Ingebrigtsen
@ 2012-01-26 0:22 ` Drew Adams
0 siblings, 0 replies; 5+ messages in thread
From: Drew Adams @ 2012-01-26 0:22 UTC (permalink / raw)
To: 'Lars Ingebrigtsen'; +Cc: 9668
> > Thanks. I don't have your fix in front of me. Hope you also
> > corrected the last sentence of the node: "It only affects secondary
> > features: indentation and Edebug."
>
> No, because I didn't think that was wrong. Does `doc-string' do
> anything other than alter the indentation of the doc string?
>
> Hm... I guess `autoload' also uses it. I'll fix up that paragraph,
> too.
Huh? It's not about what `doc-string' affects. It's about what `declare'
affects.
The sentence says that `declare' is only for `indent' and `debug', but it is
also for `doc-string'. That's the point.
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2012-01-26 0:22 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-10-04 16:23 bug#9668: 24.0.50; doc of `declare' (non-CL version) Drew Adams
2012-01-07 5:48 ` Lars Magne Ingebrigtsen
2012-01-07 15:35 ` Drew Adams
2012-01-25 23:58 ` Lars Ingebrigtsen
2012-01-26 0:22 ` Drew Adams
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
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).