Feature request: info-org-manual

Feature request: info-org-manual

[Marcin Borkowski]

Hi,

there is the info-emacs-manual, bound to C-h r.  Why not introduce
info-org-manual, like this:

(defun info-org-manual ()
  "Display the Org-mode manual in Info mode."
  (interactive)
  (info "org"))

(the above code is a tiny change;), since it's more or less s/emacs/org/
on the original function).  It might be bound to e.g. C-h o (at least
in Org-mode), which seems to be free in stock Emacs.

What do you think?

-- 
Marcin Borkowski
http://octd.wmi.amu.edu.pl/en/Marcin_Borkowski
Adam Mickiewicz University

Re: Feature request: info-org-manual

[Suvayu Ali]

Hi Marcin,

On Sat, Sep 28, 2013 at 11:53:30AM +0200, Marcin Borkowski wrote:
> Hi,
> 
> there is the info-emacs-manual, bound to C-h r.  Why not introduce
> info-org-manual, like this:

I'll play the Devil's advocate, there are many emacs packages with info
pages of their own.  AFAIK, none of them do this.  That said, if such a
command is introduced, probably it should be org-info; keeping with the
convention of all Org commands go under the org-* namespace (same as
org-submit-bug-report).

Cheers,

-- 
Suvayu

Open source is the future. It sets us free.

Re: Feature request: info-org-manual

[Carsten Dominik]

[-- Attachment #1: Type: text/plain, Size: 839 bytes --]


On 28.9.2013, at 12:10, Suvayu Ali <fatkasuvayu+linux@gmail.com> wrote:

> Hi Marcin,
> 
> On Sat, Sep 28, 2013 at 11:53:30AM +0200, Marcin Borkowski wrote:
>> Hi,
>> 
>> there is the info-emacs-manual, bound to C-h r.  Why not introduce
>> info-org-manual, like this:
> 
> I'll play the Devil's advocate, there are many emacs packages with info
> pages of their own.  AFAIK, none of them do this.  That said, if such a
> command is introduced, probably it should be org-info;

That command does already exist.  Also accessible from
the Org menu, under Documentation.  And indeed, we need to stay
in org's namespace, I agree.

- Carsten

> keeping with the
> convention of all Org commands go under the org-* namespace (same as
> org-submit-bug-report).
> 
> Cheers,
> 
> -- 
> Suvayu
> 
> Open source is the future. It sets us free.
> 


[-- Attachment #2: Message signed with OpenPGP using GPGMail --]
[-- Type: application/pgp-signature, Size: 455 bytes --]

Re: Feature request: info-org-manual

[Marcin Borkowski]

Dnia 2013-09-28, o godz. 12:16:52
Carsten Dominik <carsten.dominik@gmail.com> napisał(a):

> 
> On 28.9.2013, at 12:10, Suvayu Ali <fatkasuvayu+linux@gmail.com>
> wrote:
> 
> > Hi Marcin,
> > 
> > On Sat, Sep 28, 2013 at 11:53:30AM +0200, Marcin Borkowski wrote:
> >> Hi,
> >> 
> >> there is the info-emacs-manual, bound to C-h r.  Why not introduce
> >> info-org-manual, like this:
> > 
> > I'll play the Devil's advocate, there are many emacs packages with
> > info pages of their own.  AFAIK, none of them do this.  That said,
> > if such a command is introduced, probably it should be org-info;
> 
> That command does already exist.  Also accessible from
> the Org menu, under Documentation.  And indeed, we need to stay
> in org's namespace, I agree.

Sorry, then.  It happened once again: I thought "it would be nice if
Org had such-and-such feature", and it already has it...  It's kinda
creepy;).  (I'll probably bind it to some handy key in my init.el,
though.)

> - Carsten

Best,

-- 
Marcin Borkowski
http://octd.wmi.amu.edu.pl/en/Marcin_Borkowski
Adam Mickiewicz University

Re: Feature request: info-org-manual

[Suvayu Ali]

On Sat, Sep 28, 2013 at 12:24:05PM +0200, Marcin Borkowski wrote:
> Dnia 2013-09-28, o godz. 12:16:52
> Carsten Dominik <carsten.dominik@gmail.com> napisał(a):
> 
> > 
> > On 28.9.2013, at 12:10, Suvayu Ali <fatkasuvayu+linux@gmail.com>
> > wrote:
> > 
> > > Hi Marcin,
> > > 
> > > On Sat, Sep 28, 2013 at 11:53:30AM +0200, Marcin Borkowski wrote:
> > >> Hi,
> > >> 
> > >> there is the info-emacs-manual, bound to C-h r.  Why not introduce
> > >> info-org-manual, like this:
> > > 
> > > I'll play the Devil's advocate, there are many emacs packages with
> > > info pages of their own.  AFAIK, none of them do this.  That said,
> > > if such a command is introduced, probably it should be org-info;
> > 
> > That command does already exist.  Also accessible from
> > the Org menu, under Documentation.  And indeed, we need to stay
> > in org's namespace, I agree.
> 
> Sorry, then.  It happened once again: I thought "it would be nice if
> Org had such-and-such feature", and it already has it...  It's kinda
> creepy;).  (I'll probably bind it to some handy key in my init.el,
> though.)

Yeah, happens all the time.  I have been using Org since 2009 I think,
and I didn't know!

:)

-- 
Suvayu

Open source is the future. It sets us free.

Re: Feature request: info-org-manual

[Marcin Borkowski]

Dnia 2013-09-28, o godz. 12:34:02
Suvayu Ali <fatkasuvayu+linux@gmail.com> napisał(a):

> On Sat, Sep 28, 2013 at 12:24:05PM +0200, Marcin Borkowski wrote:
> > Dnia 2013-09-28, o godz. 12:16:52
> > Carsten Dominik <carsten.dominik@gmail.com> napisał(a):
> > 
> > > 
> > > On 28.9.2013, at 12:10, Suvayu Ali <fatkasuvayu+linux@gmail.com>
> > > wrote:
> > > 
> > > > Hi Marcin,
> > > > 
> > > > On Sat, Sep 28, 2013 at 11:53:30AM +0200, Marcin Borkowski
> > > > wrote:
> > > >> Hi,
> > > >> 
> > > >> there is the info-emacs-manual, bound to C-h r.  Why not
> > > >> introduce info-org-manual, like this:
> > > > 
> > > > I'll play the Devil's advocate, there are many emacs packages
> > > > with info pages of their own.  AFAIK, none of them do this.
> > > > That said, if such a command is introduced, probably it should
> > > > be org-info;
> > > 
> > > That command does already exist.  Also accessible from
> > > the Org menu, under Documentation.  And indeed, we need to stay
> > > in org's namespace, I agree.
> > 
> > Sorry, then.  It happened once again: I thought "it would be nice if
> > Org had such-and-such feature", and it already has it...  It's kinda
> > creepy;).  (I'll probably bind it to some handy key in my init.el,
> > though.)
> 
> Yeah, happens all the time.  I have been using Org since 2009 I think,
> and I didn't know!

BTW: I have long ago disabled my Emacs menu (and toolbar - they take
too much screen real estate, and are useless anyway;)), and - even
though I've read the Org-mode manual (almost) cover to cover - I now
also grepped it: this command is never mentioned there!  So I guess
that my lack of knowledge was justifiable. :)

> :)

Cheers,

-- 
Marcin Borkowski
http://octd.wmi.amu.edu.pl/en/Marcin_Borkowski
Adam Mickiewicz University

Re: Feature request: info-org-manual

[Memnon Anon]

Marcin Borkowski <mbork@wmi.amu.edu.pl> writes:

> and - even
> though I've read the Org-mode manual (almost) cover to cover - I now
> also grepped it: this command is never mentioned there!  So I guess
> that my lack of knowledge was justifiable. :)


Well, the manual does not contain everything; never did, never will.

One quick 'n easy way to find it with apropos and Icicles (my own keybindings...):
1. C-u C-h f 
2. org- 
3. Tab (=icicle-prefix-complete)
4. C-s (=icicle-narrow-candidates)
5. info

=>
,----[ *completion buffer* ]
| org-add-planning-info			  org-babel-view-src-block-info	
| org-info				  org-table-field-info 
| org-texinfo-convert-region-to-texinfo 
`----

or M-x apropos-command for "org info" ...

Memnon

Re: Feature request: info-org-manual

[Nicolas Richard]

Hello,

Suvayu Ali <fatkasuvayu+linux@gmail.com> writes:
> On Sat, Sep 28, 2013 at 11:53:30AM +0200, Marcin Borkowski wrote:
>> there is the info-emacs-manual, bound to C-h r.  Why not introduce
>> info-org-manual, like this:
>
> I'll play the Devil's advocate, there are many emacs packages with info
> pages of their own.  AFAIK, none of them do this.

The only example I have in mind is Gnus, which has gnus-info-find-node
bound to C-c TAB in *some* gnus buffers (e.g. group and summary buffers)

-- 
Nicolas.