(interactive "rP") valid?

(interactive "rP") valid?

[Thorsten Jolitz]

Hi List, 

function 'org-table-convert-region' uses (interactive "rP") and has the
following signature:

,---------------------------------------------------------
| (org-table-convert-region BEG0 END0 &optional SEPARATOR)
`---------------------------------------------------------

Non-interactively, the function works as expected:
different behaviour conditional on SEPARATOR being nil, an integer, '(4)
or '(16).

However, used interactively, SEPARATOR is always nil when 'C-u <digit>
M-x' is used.

Is (interactive "rP") not a valid combination?
Or is this a bug in Emacs?

-- 
cheers,
Thorsten

Re: (interactive "rP") valid?

[Andreas Röhler]

Am 28.05.2013 13:15, schrieb Thorsten Jolitz:
>
> Hi List,
>
> function 'org-table-convert-region' uses (interactive "rP") and has the
> following signature:
>
> ,---------------------------------------------------------
> | (org-table-convert-region BEG0 END0 &optional SEPARATOR)
> `---------------------------------------------------------
>
> Non-interactively, the function works as expected:
> different behaviour conditional on SEPARATOR being nil, an integer, '(4)
> or '(16).
>
> However, used interactively, SEPARATOR is always nil when 'C-u <digit>
> M-x' is used.
>
> Is (interactive "rP") not a valid combination?
> Or is this a bug in Emacs?
>

needs a newline:

(interactive "r\nP")

Re: (interactive "rP") valid?

[Thorsten Jolitz]

Andreas Röhler <andreas.roehler@easy-emacs.de> writes:

> Am 28.05.2013 13:15, schrieb Thorsten Jolitz:
>>
>> Hi List,
>>
>> function 'org-table-convert-region' uses (interactive "rP") and has the
>> following signature:
>>
>> ,---------------------------------------------------------
>> | (org-table-convert-region BEG0 END0 &optional SEPARATOR)
>> `---------------------------------------------------------
>>
>> Non-interactively, the function works as expected:
>> different behaviour conditional on SEPARATOR being nil, an integer, '(4)
>> or '(16).
>>
>> However, used interactively, SEPARATOR is always nil when 'C-u <digit>
>> M-x' is used.
>>
>> Is (interactive "rP") not a valid combination?
>> Or is this a bug in Emacs?
>>
>
> needs a newline:
>
> (interactive "r\nP")

Yes, that made it work. Thanks.

-- 
cheers,
Thorsten

RE: (interactive "rP") valid?

[Drew Adams]

> >> Is (interactive "rP") not a valid combination?
> >> Or is this a bug in Emacs?
> >
> > needs a newline:
> > (interactive "r\nP")
> 
> Yes, that made it work. Thanks.

C-h i 
Click Elisp
i interactive RET

Re: (interactive "rP") valid?

[Thorsten Jolitz]

Drew Adams <drew.adams@oracle.com> writes:

>> >> Is (interactive "rP") not a valid combination?
>> >> Or is this a bug in Emacs?
>> >
>> > needs a newline:
>> > (interactive "r\nP")
>> 
>> Yes, that made it work. Thanks.
>
> C-h i 
> Click Elisp
> i interactive RET

Maybe not _that_ obvious at first sight?
This was a bug in core Org-mode I stumbled upon. 

-- 
cheers,
Thorsten

RE: (interactive "rP") valid?

[Drew Adams]

> >> >> Is (interactive "rP") not a valid combination?
> >> >> Or is this a bug in Emacs?
> >> > needs a newline: (interactive "r\nP")
> >> Yes, that made it work. Thanks.
> >
> > C-h i
> > Click Elisp
> > i interactive RET
> 
> Maybe not _that_ obvious at first sight?
> This was a bug in core Org-mode I stumbled upon.

I did not mean that anything should have been obvious.

I just meant to remind folks that Emacs itself has most of the answers to our questions, and it's not that hard to ask Emacs.

Of course there is nothing wrong with asking here either.

How to write (interactive) with user-selection from predefined enumeration? (was Re: (interactive "rP") valid?)

[Thorsten Jolitz]

Drew Adams <drew.adams@oracle.com> writes:

> Of course there is nothing wrong with asking here either.

OK, I did read the 'interactive' section of the manual again, but I did
not find the answer to this question (although it is most likely there,
somehere):

How to write an interactive function and let the user choose from a list
(an enumeration) of possible solutions as input (like: Item1 | Item2 | Item3)?

-- 
cheers,
Thorsten

RE: How to write (interactive) with user-selection from predefined enumeration? (was Re: (interactive "rP") valid?)

[Drew Adams]

> OK, I did read the 'interactive' section of the manual again, but I did
> not find the answer to this question (although it is most likely there,
> somehere):

Hm.  "Most likely there somewhere".  Does that mean that you did not spend
time looking for it or you did spend time and couldn't find it?

If the latter, use `M-x report-emacs-bug', to let Emacs Dev know what's
missing - say just how you looked and what you think would have made your
search easier.  Emacs Dev is usually open to improvement suggestions, such
as adding index entries or clarifying the text.

If the former, I have only a little sympathy.  Sure, it might seem easier
to write a question here (and again, there is nothing wrong with that).
But learning to take advantage of the Emacs doc and help system
(`C-h f interactive') yourself is a win for everyone, especially you.

> How to write an interactive function and let the user choose from a list
> (an enumeration) of possible solutions as input (like: Item1 | Item2 |
> Item3)?

Wrt the original question, (elisp) `Using Interactive' (the first target reached
from `i interactive') gives two examples using \n, and it says:

 "It may be a string; its contents are a sequence of elements separated
  by newlines, one for each argument(1)."

And that node cross-references node `Interactive Codes', which explains more.

As to your new question, what is each ItemN?  Just any old name, or the name
of a particular kind of Emacs object?

Node `Interactive Codes' explains about code chars that allow for completion
(of choices).  It says that you get this for choosing the name of a function,
buffer, command, directory, file, user option, or coding system.

Beyond that, node `Using Interactive' explains that the `interactive' spec can
be a Lisp sexp that returns a list of args to be passed to the command.  You
really cannot get more general than that: you can do pretty much anything here.

`Using Interactive' explains how to code such a list.  As one example, you can
use `completing-read' to read a user choice among any kind of completion
candidates (not just names of functions, buffers, commands, directories, files,
options, and coding systems).

What more do you need?  The manual is your friend.

Re: How to write (interactive) with user-selection from predefined enumeration? (was Re: (interactive "rP") valid?)

[Thorsten Jolitz]

Drew Adams <drew.adams@oracle.com> writes:

> `Using Interactive' explains how to code such a list. As one example,
> you can use `completing-read' to read a user choice among any kind of
> completion candidates (not just names of functions, buffers, commands,
> directories, files, options, and coding systems).

Ok, thanks for the tip, 'completing-read' was the missing piece of the
puzzle for me.

> What more do you need?  The manual is your friend.

I must admit I don't find everything so crystal clear and obvious in the
Elisp manual as you describe it here. Especially in the section about
(interactive), more and more comples examples would be helpful. On the
other hand, a 1000page manual is already thick enough, so I would not
call that a bug. 

-- 
cheers,
Thorsten

Re: (interactive "rP") valid?

[Joost Kremers]

Drew Adams wrote:
> C-h i 
> Click Elisp

Mmm... if I type that into Emacs, I end up with "Regexp search: p" in
the minibuffer... Or is this "Click" thing some newfangled modifier key
that I haven't heard about? If so, I hope the old method `m Elisp RET`
isn't deprecated? I'd hate to have to buy a new keyboard...


-- 
Joost Kremers                                   joostkremers@fastmail.fm
Selbst in die Unterwelt dringt durch Spalten Licht
EN:SiS(9)

Re: (interactive "rP") valid?

[Joost Kremers]

Drew Adams wrote:
>> > C-h i
>> > Click Elisp
>> 
>> Mmm... if I type that into Emacs, I end up with "Regexp search: p" in
>> the minibuffer... Or is this "Click" thing some newfangled modifier key
>> that I haven't heard about? If so, I hope the old method `m Elisp RET`
>> isn't deprecated? I'd hate to have to buy a new keyboard...
>
> ;-)
>
> No, I just meant that you can "click `mouse-2' (or `mouse-1', depending)
> on the `Elisp' link."

Yeah, see? One of those newfangled tiny keyboards that won't stay put on
your desk... And only two keys! Can't for the life of me figure out why
anyone would wanna have one of those...


-- 
Joost Kremers                                   joostkremers@fastmail.fm
Selbst in die Unterwelt dringt durch Spalten Licht
EN:SiS(9)

RE: (interactive "rP") valid?

[Drew Adams]

> > C-h i
> > Click Elisp
> 
> Mmm... if I type that into Emacs, I end up with "Regexp search: p" in
> the minibuffer... Or is this "Click" thing some newfangled modifier key
> that I haven't heard about? If so, I hope the old method `m Elisp RET`
> isn't deprecated? I'd hate to have to buy a new keyboard...

;-)

No, I just meant that you can "click `mouse-2' (or `mouse-1', depending)
on the `Elisp' link."

Certainly it would be bad if `m Elisp RET' were lost.  No disagreement.