Jump to man page buffer

Jump to man page buffer

[Hadron Quark]

I have the following code mapped to f1.

"manual-entry (current-word)"

How to make emacs also jump to the buffer showing the resulting
man-page?

thanks for any help.

Re: Jump to man page buffer

[Thorsten Bonow]

>>>>> "Hadron" == Hadron Quark <hadronquark@gmail.com> writes:

    Hadron> I have the following code mapped to f1.

    Hadron> "manual-entry (current-word)"

    Hadron> How to make emacs also jump to the buffer showing the resulting
    Hadron> man-page?

Hi,

there is the `Man-notify-method' variable, mentioned in the documentation to
`manual-entry':

"See variable
`Man-notify-method' for what happens when the buffer is ready.
If a buffer already exists for this man page, it will display immediately."

Hope this helps...

    Hadron> thanks for any help.

Toto

-- 
Contact information and PGP key at
http://www-users.rwth-aachen.de/thorsten.bonow

Enlightenment DR17 has been added into the primary CVS tree. No,
hell hasn't frozen over and last we looked pigs weren't flying
although this might signal Duke Nukem Forever sometime before
Christmas.

Found in the News section of www.enlightenment.org
on Sun Nov 28 2004

Re: Jump to man page buffer

[Hadron Quark]

Thorsten Bonow <thorsten.bonow@post.rwth-aachen.de> writes:

>>>>>> "Hadron" == Hadron Quark <hadronquark@gmail.com> writes:
>
>     Hadron> I have the following code mapped to f1.
>
>     Hadron> "manual-entry (current-word)"
>
>     Hadron> How to make emacs also jump to the buffer showing the resulting
>     Hadron> man-page?
>
> Hi,
>
> there is the `Man-notify-method' variable, mentioned in the documentation to
> `manual-entry':
>
> "See variable
> `Man-notify-method' for what happens when the buffer is ready.
> If a buffer already exists for this man page, it will display immediately."
>
> Hope this helps...

Damn. Asleep again. I missed that.  Thanks a lot : newframe is probably
the best for me.

Out of curiosity what would the function be called to "jump to named
buffer"? I had written my first bit of lisp to construct a legitimate
buffer name but "switch to buffer" switches the named buffer into the
current one, so I had 2 buffers with the manpage in :)


>
>     Hadron> thanks for any help.
>
> Toto

-- 

Re: Jump to man page buffer

[Thorsten Bonow]

>>>>> "Hadron" == Hadron Quark <hadronquark@gmail.com> writes:

    Hadron> Damn. Asleep again. I missed that.  Thanks a lot : newframe is
    Hadron> probably the best for me.

I'm using "pushy" :-)

    Hadron> Out of curiosity what would the function be called to "jump to named
    Hadron> buffer"? I had written my first bit of lisp to construct a
    Hadron> legitimate buffer name but "switch to buffer" switches the named
    Hadron> buffer into the current one, so I had 2 buffers with the manpage in
    Hadron> :)

Huh?

I looked up the man-page of "grep", switched to another buffer and evaluated

(switch-to-buffer "*Man grep*")

Just switched to the correct buffer. Got only one of it.

    Hadron> thanks for any help.

Good night...

Toto

-- 
Contact information and PGP key at
http://www-users.rwth-aachen.de/thorsten.bonow

Otto: Don't call me stupid!

A Fish Called Wanda

Re: Jump to man page buffer

[Hadron Quark]

Thorsten Bonow <thorsten.bonow@post.rwth-aachen.de> writes:

>>>>>> "Hadron" == Hadron Quark <hadronquark@gmail.com> writes:
>
>     Hadron> Damn. Asleep again. I missed that.  Thanks a lot : newframe is
>     Hadron> probably the best for me.
>
> I'm using "pushy" :-)
>
>     Hadron> Out of curiosity what would the function be called to "jump to named
>     Hadron> buffer"? I had written my first bit of lisp to construct a
>     Hadron> legitimate buffer name but "switch to buffer" switches the named
>     Hadron> buffer into the current one, so I had 2 buffers with the manpage in
>     Hadron> :)
>
> Huh?
>
> I looked up the man-page of "grep", switched to another buffer and evaluated
>
> (switch-to-buffer "*Man grep*")
>
> Just switched to the correct buffer. Got only one of it.
>
>     Hadron> thanks for any help.
>
> Good night...

I'll explain : If you're editing a c file and called
manual-entry(current-word) then the default setting was to open a new
buffer and leave focus in the c file. I was trying to programmatically
jump to the new buffer after calling manual-entry. But a call to
switch-to buffer when there are *2* buffers open, brings the manual
buffer into the current buffer - so suddenly there are 2 visible buffers
showing the same manpage.

>
> Toto

-- 

Re: Jump to man page buffer

[Thorsten Bonow]

>>>>> "Hadron" == Hadron Quark <hadronquark@gmail.com> writes:

    Hadron> I'll explain : If you're editing a c file and called
    Hadron> manual-entry(current-word) then the default setting was to open a
    Hadron> new buffer and leave focus in the c file. I was trying to
    Hadron> programmatically jump to the new buffer after calling
    Hadron> manual-entry. But a call to switch-to buffer when there are *2*
    Hadron> buffers open, brings the manual buffer into the current buffer - so
    Hadron> suddenly there are 2 visible buffers showing the same manpage.

Ah. I see.

Toto

-- 
Contact information and PGP key at
http://www-users.rwth-aachen.de/thorsten.bonow

RWTH Aaachen -- Jetzt noch weiter vorne...

Re: Jump to man page buffer

[David Hansen]

On Sun, 10 Sep 2006 01:07:41 +0200 Hadron Quark wrote:

> I'll explain : If you're editing a c file and called
> manual-entry(current-word) then the default setting was to open a new
> buffer and leave focus in the c file. I was trying to programmatically
> jump to the new buffer after calling manual-entry.

Have a look at `Man-notify-method'.

David

Re: Jump to man page buffer

[Kevin Rodgers]

Hadron Quark wrote:
> Out of curiosity what would the function be called to "jump to named
> buffer"? I had written my first bit of lisp to construct a legitimate
> buffer name but "switch to buffer" switches the named buffer into the
> current one, so I had 2 buffers with the manpage in :)

See the Displaying Buffers [in Windows] node of the Emacs Lisp manual,
which describes the details.  Generally the best way to respect the
user's preferences is to use pop-to-buffer.

-- 
Kevin

Re: Jump to man page buffer

[robert.thorpe]

Hadron Quark wrote:
> I have the following code mapped to f1.
>
> "manual-entry (current-word)"
>
> How to make emacs also jump to the buffer showing the resulting
> man-page?
>
> thanks for any help.

As a side-note, using man pages as references is trouble in systems
that use GNU components heavily.

The best docs of most of the general utilities are the info pages, the
best docs to glibc are generally the info pages.  The best/only docs to
the kernel stuff and system utilities are the man pages.

Re: Jump to man page buffer

[Hadron Quark]

robert.thorpe@antenova.com writes:

> Hadron Quark wrote:
>> I have the following code mapped to f1.
>>
>> "manual-entry (current-word)"
>>
>> How to make emacs also jump to the buffer showing the resulting
>> man-page?
>>
>> thanks for any help.
>
> As a side-note, using man pages as references is trouble in systems
> that use GNU components heavily.
>
> The best docs of most of the general utilities are the info pages, the
> best docs to glibc are generally the info pages.  The best/only docs to
> the kernel stuff and system utilities are the man pages.
>

Didnt know that.

I tried "info(current-word)" but it doesnt work.

How would I bring up the info for C functions then? Ideally use the info
page if it exists or else revert to the man page.


-- 

Re: Jump to man page buffer

[David Hansen]

On Tue, 12 Sep 2006 01:07:49 +0200 Hadron Quark wrote:

> robert.thorpe@antenova.com writes:
>
>> Hadron Quark wrote:
>>> I have the following code mapped to f1.
>>>
>>> "manual-entry (current-word)"
>>>
>>> How to make emacs also jump to the buffer showing the resulting
>>> man-page?
>>>
>>> thanks for any help.
>>
>> As a side-note, using man pages as references is trouble in systems
>> that use GNU components heavily.
>>
>> The best docs of most of the general utilities are the info pages, the
>> best docs to glibc are generally the info pages.  The best/only docs to
>> the kernel stuff and system utilities are the man pages.
>>
>
> Didnt know that.
>
> I tried "info(current-word)" but it doesnt work.
>
> How would I bring up the info for C functions then? Ideally use the info
> page if it exists or else revert to the man page.

Install the GNU libc info manual and use it like you use the
other info manuals.

Anyway i disagree with Robert.  I would think that on every
POSIX box it's more likely that the manual pages are available
than the libc info manual.

And for a quick lookup the manual pages are usually better.
In contrast the libc manual is a bit more descriptive and
comes with more examples.  Both have it's use.

David

Re: Jump to man page buffer

[robert.thorpe]

Hadron Quark wrote:
> robert.thorpe@antenova.com writes:
>
> > Hadron Quark wrote:
> >> I have the following code mapped to f1.
> >>
> >> "manual-entry (current-word)"
> >>
> >> How to make emacs also jump to the buffer showing the resulting
> >> man-page?
> >>
> >> thanks for any help.
> >
> > As a side-note, using man pages as references is trouble in systems
> > that use GNU components heavily.
> >
> > The best docs of most of the general utilities are the info pages, the
> > best docs to glibc are generally the info pages.  The best/only docs to
> > the kernel stuff and system utilities are the man pages.
> >
>
> Didnt know that.
>
> I tried "info(current-word)" but it doesnt work.
>
> How would I bring up the info for C functions then? Ideally use the info
> page if it exists or else revert to the man page.

In Emacs if you type C-h C-i when over the name of a C library function
then it should jump to the correct place in the glibc info file.

You have to have the glibc info file installed for this to work.  Any
distro that supports development should have this installed by default
along with the glibc man pages and the system utilities man pages.

If not look get your distros install program to add those things.
(Don't download them from the net, or they'll likely be the wrong
versions compared to what you're actually using).

Re: Jump to man page buffer

[David Hansen]

On 12 Sep 2006 10:54:59 -0700 robert thorpe wrote:

> In Emacs if you type C-h C-i when over the name of a C library function
> then it should jump to the correct place in the glibc info file.

That must be some extension you use:

C-h TAB is undefined

Please tell us what you are using to directly jump to the
documentation.

David

RE: Jump to man page buffer

[Drew Adams]

    > In Emacs if you type C-h C-i when over the name of a C 
    > library function then it should jump to the correct place
    > in the glibc info file.
    
    That must be some extension you use:
    C-h TAB is undefined
    
    Please tell us what you are using to directly jump to the
    documentation.

Try M-x load-library info-look

Re: Jump to man page buffer

[David Hansen]

On Tue, 12 Sep 2006 12:51:11 -0700 Drew Adams wrote:

>     > In Emacs if you type C-h C-i when over the name of a C 
>     > library function then it should jump to the correct place
>     > in the glibc info file.
>     
>     That must be some extension you use:
>     C-h TAB is undefined
>     
>     Please tell us what you are using to directly jump to the
>     documentation.
>
> Try M-x load-library info-look

Thank you.  That's really nice.  But the key binding is
actually C-h S in case anyone else cares.

David

RE: Jump to man page buffer

[Drew Adams]

    On Tue, 12 Sep 2006 12:51:11 -0700 Drew Adams wrote:

    >     > In Emacs if you type C-h C-i when over the name of a C
    >     > library function then it should jump to the correct place
    >     > in the glibc info file.
    >
    >     That must be some extension you use:
    >     C-h TAB is undefined
    >
    >     Please tell us what you are using to directly jump to the
    >     documentation.
    >
    > Try M-x load-library info-look

    Thank you.  That's really nice.  But the key binding is
    actually C-h S in case anyone else cares.

Prior to Emacs 22, the key binding was `C-h C-i', that is, `C-h TAB'. I'm
not sure why the binding changed.

Re: Jump to man page buffer

[robert.thorpe]

David Hansen wrote:
> On Tue, 12 Sep 2006 12:51:11 -0700 Drew Adams wrote:
>
> >     > In Emacs if you type C-h C-i when over the name of a C
> >     > library function then it should jump to the correct place
> >     > in the glibc info file.
> >
> >     That must be some extension you use:
> >     C-h TAB is undefined
> >
> >     Please tell us what you are using to directly jump to the
> >     documentation.
> >
> > Try M-x load-library info-look
>
> Thank you.  That's really nice.  But the key binding is
> actually C-h S in case anyone else cares.

They've changed the keybinding!  It is C-h C-i in Emacs 21.3.
C-h C-i was a little easier to hit than C-h S, pity.  I suppose "S" is
more mnemonic for looking up symbols than C-i.