TAGS documentation

TAGS documentation

[Hadron]

Could someone suggest what I need to install/make to get TAGS
documentation in my Emacs info?

Re: TAGS documentation

[Eli Zaretskii]

> From: Hadron <hadronquark@googlemail.com>
> Date: Sat, 28 Jul 2007 14:33:06 +0200
> 
> Could someone suggest what I need to install/make to get TAGS
> documentation in my Emacs info?

As my crystal ball went on strike today, could you please explain what
is ``TAGS documentation'' and what is ``your Emacs info''?

Re: TAGS documentation

[Frank Murray]

"Crystal Ball?!"  For this, you might want a decryption algorithm.

fjm

On 28 Jul 2007, at 10:49 , Eli Zaretskii wrote:

>> From: Hadron <hadronquark@googlemail.com>
>> Date: Sat, 28 Jul 2007 14:33:06 +0200
>>
>> Could someone suggest what I need to install/make to get TAGS
>> documentation in my Emacs info?
>
> As my crystal ball went on strike today, could you please explain what
> is ``TAGS documentation'' and what is ``your Emacs info''?
>
>
> _______________________________________________
> help-gnu-emacs mailing list
> help-gnu-emacs@gnu.org
> http://lists.gnu.org/mailman/listinfo/help-gnu-emacs

Re: TAGS documentation

[Hadron]

Eli Zaretskii <eliz@gnu.org> writes:

>> From: Hadron <hadronquark@googlemail.com>
>> Date: Sat, 28 Jul 2007 14:33:06 +0200
>> 
>> Could someone suggest what I need to install/make to get TAGS
>> documentation in my Emacs info?
>
> As my crystal ball went on strike today, could you please explain what
> is ``TAGS documentation'' and what is ``your Emacs info''?
>

TAGS as in "tags". etags. Code cross referencing. The TAGS section is
in some online gnu emacs documentation but not on my live system.

http://www.math.uio.no/doc/gnu/emacs/tags.html

My "emacs info"?  my emacs info. You know. C-h i.

Re: TAGS documentation

[Eli Zaretskii]

> From: Hadron <hadronquark@googlemail.com>
> Date: Sat, 28 Jul 2007 17:29:22 +0200
> 
> TAGS as in "tags". etags. Code cross referencing. The TAGS section is
> in some online gnu emacs documentation but not on my live system.
> 
> http://www.math.uio.no/doc/gnu/emacs/tags.html
> 
> My "emacs info"?  my emacs info. You know. C-h i.

You mean, your Emacs on-line manual doesn't have a node named "Tags"?
That is, the following sequence of commands:

     C-h i d m emacs RET g Tags RET

spits out some error message instead of getting you to the description
of tags tables and associated commands and features?  If so, you need
to fix your installation of the Emacs manual, because what you want is
an integral part of it.

Re: TAGS documentation

[Hadron]

Eli Zaretskii <eliz@gnu.org> writes:

>> From: Hadron <hadronquark@googlemail.com>
>> Date: Sat, 28 Jul 2007 17:29:22 +0200
>> 
>> TAGS as in "tags". etags. Code cross referencing. The TAGS section is
>> in some online gnu emacs documentation but not on my live system.
>> 
>> http://www.math.uio.no/doc/gnu/emacs/tags.html
>> 
>> My "emacs info"?  my emacs info. You know. C-h i.
>
> You mean, your Emacs on-line manual doesn't have a node named "Tags"?
> That is, the following sequence of commands:
>
>      C-h i d m emacs RET g Tags RET
>
> spits out some error message instead of getting you to the description
> of tags tables and associated commands and features?  If so, you need
> to fix your installation of the Emacs manual, because what you want is
> an integral part of it.

Thank you Eli - that command sequence found tags!

What Search command should find it from the top index level?

Re: TAGS documentation

[Eli Zaretskii]

> From: Hadron <hadronquark@googlemail.com>
> Date: Sat, 28 Jul 2007 20:07:26 +0200
> 
> >      C-h i d m emacs RET g Tags RET
> >
> > spits out some error message instead of getting you to the description
> > of tags tables and associated commands and features?  If so, you need
> > to fix your installation of the Emacs manual, because what you want is
> > an integral part of it.
> 
> Thank you Eli - that command sequence found tags!
> 
> What Search command should find it from the top index level?

In Info manuals, never use search commands -- they are for sissies. ;-)
Instead, use the index search feature of Info.  Any well-written Info
manual should have an index which will get you to the description of
every important concept quickly and efficiently.  In this case, the
command "i tags RET" inside the Emacs manual will land you on the
above spot (this is how I found the node when answering your question,
btw).

The `i' command is the way to use an Info manual as a reference (as
opposed to just reading through it, which is typical of the first time
you learn to use a program).

Re: TAGS documentation

[AN0]

Eli Zaretskii <eliz@gnu.org> writes:

>> From: Hadron <hadronquark@googlemail.com>
>> Date: Sat, 28 Jul 2007 20:07:26 +0200
>> 
>> >      C-h i d m emacs RET g Tags RET
>> >
>> > spits out some error message instead of getting you to the description
>> > of tags tables and associated commands and features?  If so, you need
>> > to fix your installation of the Emacs manual, because what you want is
>> > an integral part of it.
>> 
>> Thank you Eli - that command sequence found tags!
>> 
>> What Search command should find it from the top index level?
>
> In Info manuals, never use search commands -- they are for sissies. ;-)
> Instead, use the index search feature of Info.  Any well-written Info
> manual should have an index which will get you to the description of
> every important concept quickly and efficiently.  In this case, the
> command "i tags RET" inside the Emacs manual will land you on the
> above spot (this is how I found the node when answering your question,
> btw).
>
> The `i' command is the way to use an Info manual as a reference (as
> opposed to just reading through it, which is typical of the first time
> you learn to use a program).

But when I used the `i' command in the Info directory (where the `d' led me
to), I got following message:
The Info directory node has no index; use m to select a manual

so it seems an `m' command is inevitable.
-- 

Re: TAGS documentation

[Hadron]

AN0 <an00na@gmail.com> writes:

> Eli Zaretskii <eliz@gnu.org> writes:
>
>>> From: Hadron <hadronquark@googlemail.com>
>>> Date: Sat, 28 Jul 2007 20:07:26 +0200
>>> 
>>> >      C-h i d m emacs RET g Tags RET
>>> >
>>> > spits out some error message instead of getting you to the description
>>> > of tags tables and associated commands and features?  If so, you need
>>> > to fix your installation of the Emacs manual, because what you want is
>>> > an integral part of it.
>>> 
>>> Thank you Eli - that command sequence found tags!
>>> 
>>> What Search command should find it from the top index level?
>>
>> In Info manuals, never use search commands -- they are for sissies. ;-)
>> Instead, use the index search feature of Info.  Any well-written Info
>> manual should have an index which will get you to the description of
>> every important concept quickly and efficiently.  In this case, the
>> command "i tags RET" inside the Emacs manual will land you on the
>> above spot (this is how I found the node when answering your question,
>> btw).
>>
>> The `i' command is the way to use an Info manual as a reference (as
>> opposed to just reading through it, which is typical of the first time
>> you learn to use a program).
>
> But when I used the `i' command in the Info directory (where the `d' led me
> to), I got following message:
> The Info directory node has no index; use m to select a manual
>
> so it seems an `m' command is inevitable.

Exactly. So is there are way to search all manuals without doing an "m" first?

Re: TAGS documentation

[Eli Zaretskii]

> From: Hadron <hadronquark@googlemail.com>
> Date: Sun, 29 Jul 2007 14:17:29 +0200
> 
> > so it seems an `m' command is inevitable.
> 
> Exactly. So is there are way to search all manuals without doing an "m" first?

Yes, "M-x info-apropos RET".

But I don't recommend this, unless you _really_ don't know in which
manual to look.  It is much better (faster) to go to the right manual,
and then use `i' there.

Re: TAGS documentation

[Hadron]

Eli Zaretskii <eliz@gnu.org> writes:

>> From: Hadron <hadronquark@googlemail.com>
>> Date: Sat, 28 Jul 2007 20:07:26 +0200
>> 
>> >      C-h i d m emacs RET g Tags RET
>> >
>> > spits out some error message instead of getting you to the description
>> > of tags tables and associated commands and features?  If so, you need
>> > to fix your installation of the Emacs manual, because what you want is
>> > an integral part of it.
>> 
>> Thank you Eli - that command sequence found tags!
>> 
>> What Search command should find it from the top index level?
>
> In Info manuals, never use search commands -- they are for sissies. ;-)
> Instead, use the index search feature of Info.  Any well-written Info
> manual should have an index which will get you to the description of
> every important concept quickly and efficiently.  In this case, the
> command "i tags RET" inside the Emacs manual will land you on the
> above spot (this is how I found the node when answering your question,
> btw).
>
> The `i' command is the way to use an Info manual as a reference (as
> opposed to just reading through it, which is typical of the first time
> you learn to use a program).
>
>

Well, here is the funny thing and why I looked so stupid asking the
original question.

"i" does nothing at the top level.

Foolishly (or maybe not so) I assumed there would be a "top level"
search for all "info" sections available from the the "info" index in
emacs.

After all, how am I, or anyone else. to know that "tags" is part of
"emacs" as opposed to, say " cc-mode?

If you get my meaning.

Re: TAGS documentation

[Eli Zaretskii]

> From: Hadron <hadronquark@googlemail.com>
> Date: Sun, 29 Jul 2007 04:51:18 +0200
> 
> Well, here is the funny thing and why I looked so stupid asking the
> original question.
> 
> "i" does nothing at the top level.

Neither does Search.

I assumed that you were already in the Emacs manual, that's why I
didn't mention that you need to select a manual.

> After all, how am I, or anyone else. to know that "tags" is part of
> "emacs" as opposed to, say " cc-mode?

Well, your original message did indicate you knew:

    Could someone suggest what I need to install/make to get TAGS
    documentation in my Emacs info?
                        ^^^^^^^^^^

Re: TAGS documentation

[Hadron]

Eli Zaretskii <eliz@gnu.org> writes:

>> From: Hadron <hadronquark@googlemail.com>
>> Date: Sun, 29 Jul 2007 04:51:18 +0200
>> 
>> Well, here is the funny thing and why I looked so stupid asking the
>> original question.
>> 
>> "i" does nothing at the top level.
>
> Neither does Search.
>
> I assumed that you were already in the Emacs manual, that's why I
> didn't mention that you need to select a manual.
>
>> After all, how am I, or anyone else. to know that "tags" is part of
>> "emacs" as opposed to, say " cc-mode?
>
> Well, your original message did indicate you knew:
>
>     Could someone suggest what I need to install/make to get TAGS
>     documentation in my Emacs info?
>                         ^^^^^^^^^^

I see - yes, bad of me . I wasn't clear. I had meant "all info available
in emacs".

Thanks for the info-apropos, but I see why you don't really recommend it
either.