unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#57937: 29.0.50; Improve doc of (interactive current-prefix-arg ...)
@ 2022-09-19 16:12 Stefan Kangas
  2022-09-19 16:33 ` Eli Zaretskii
  0 siblings, 1 reply; 4+ messages in thread
From: Stefan Kangas @ 2022-09-19 16:12 UTC (permalink / raw)
  To: 57937

Severity: wishlist

I think the explanation in (info "(elisp) Using Interactive") could
include a pointer to `current-prefix-arg', which AFAICT is only
documented much later in (info "(elisp) Prefix Command Arguments").

Perhaps something could be added also to
(info "(elisp) Interactive Examples")?





^ permalink raw reply	[flat|nested] 4+ messages in thread

* bug#57937: 29.0.50; Improve doc of (interactive current-prefix-arg ...)
  2022-09-19 16:12 bug#57937: 29.0.50; Improve doc of (interactive current-prefix-arg ...) Stefan Kangas
@ 2022-09-19 16:33 ` Eli Zaretskii
  2022-09-19 19:35   ` Stefan Kangas
  0 siblings, 1 reply; 4+ messages in thread
From: Eli Zaretskii @ 2022-09-19 16:33 UTC (permalink / raw)
  To: Stefan Kangas; +Cc: 57937

> From: Stefan Kangas <stefankangas@gmail.com>
> Date: Mon, 19 Sep 2022 12:12:52 -0400
> 
> Severity: wishlist
> 
> I think the explanation in (info "(elisp) Using Interactive") could
> include a pointer to `current-prefix-arg', which AFAICT is only
> documented much later in (info "(elisp) Prefix Command Arguments").

There is already such a pointer there:

   There are three possibilities for the argument ARG-DESCRIPTOR:

   • It may be omitted or ‘nil’; then the command is called with no
     arguments.  This leads quickly to an error if the command requires
     one or more arguments.

   • It may be a string; its contents are a sequence of elements
     separated by newlines, one for each argument(1).  Each element
     consists of a code character (*note Interactive Codes::) optionally
     followed by a prompt (which some code characters use and some
     ignore).  Here is an example:

          (interactive "P\nbFrobnicate buffer: ")

     The code letter ‘P’ sets the command’s first argument to the raw
     command prefix (*note Prefix Command Arguments::).





^ permalink raw reply	[flat|nested] 4+ messages in thread

* bug#57937: 29.0.50; Improve doc of (interactive current-prefix-arg ...)
  2022-09-19 16:33 ` Eli Zaretskii
@ 2022-09-19 19:35   ` Stefan Kangas
  2022-09-20  2:27     ` Eli Zaretskii
  0 siblings, 1 reply; 4+ messages in thread
From: Stefan Kangas @ 2022-09-19 19:35 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 57937

Eli Zaretskii <eliz@gnu.org> writes:

> There is already such a pointer there:
>
>    There are three possibilities for the argument ARG-DESCRIPTOR:
>
>    • It may be omitted or ‘nil’; ...
>    • It may be a string; ...

I was thinking of this item:

   • It may be a Lisp expression that is not a string; ...

Here, I'd like to see an example like:

          (interactive current-prefix-arg)

and a brief pointer to `(elisp) Prefix Command Arguments'.





^ permalink raw reply	[flat|nested] 4+ messages in thread

* bug#57937: 29.0.50; Improve doc of (interactive current-prefix-arg ...)
  2022-09-19 19:35   ` Stefan Kangas
@ 2022-09-20  2:27     ` Eli Zaretskii
  0 siblings, 0 replies; 4+ messages in thread
From: Eli Zaretskii @ 2022-09-20  2:27 UTC (permalink / raw)
  To: Stefan Kangas; +Cc: 57937

> From: Stefan Kangas <stefankangas@gmail.com>
> Date: Mon, 19 Sep 2022 15:35:12 -0400
> Cc: 57937@debbugs.gnu.org
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> > There is already such a pointer there:
> >
> >    There are three possibilities for the argument ARG-DESCRIPTOR:
> >
> >    • It may be omitted or ‘nil’; ...
> >    • It may be a string; ...
> 
> I was thinking of this item:
> 
>    • It may be a Lisp expression that is not a string; ...
> 
> Here, I'd like to see an example like:
> 
>           (interactive current-prefix-arg)
> 
> and a brief pointer to `(elisp) Prefix Command Arguments'.

That comes _after_ the above-mention place, which already points to
that node, so what would be the point and the importance of repeating
the reference?  Using current-prefix-arg in a Lisp expression is not
different from using any other Lisp variable.





^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2022-09-20  2:27 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2022-09-19 16:12 bug#57937: 29.0.50; Improve doc of (interactive current-prefix-arg ...) Stefan Kangas
2022-09-19 16:33 ` Eli Zaretskii
2022-09-19 19:35   ` Stefan Kangas
2022-09-20  2:27     ` Eli Zaretskii

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).