Re: [RFA] Don't unwind past entry point

["Eli Zaretskii" <eliz@gnu.org>]

> Date: Wed, 10 Nov 2004 12:02:08 -0500
> From: Andrew Cagney <cagney@gnu.org>
> Cc: gdb-patches@sources.redhat.com
> 
> Check eli for the doco.

Thanks for the heads-up, I missed the original message.

>  @table @code
>  @item set backtrace past-main
>  @itemx set backtrace past-main on
> -@kindex set backtrace
> +@kindex set backtrace past-main

Please don't make this change.  When there are several commands that
begin with the same string, like "set backtrace SOMETHING" which all
begin with "set backtrace", we should always index only the common
part and do it only once, so that we end up with a single index entry
that points to the place where the whole family is described.

So please leave only the original "@kindex set backtrace" and "@kindex
show backtrace" entries, and remove all the rest.

> -@kindex show backtrace
> +@kindex show backtrace past-main

This change should also be undone.

> +This entry point is encoded by the linker when the application is built,
> +and is likely before the user entry point ``main'' (or equivalent) is called.

Please use @code{main}, without any quotes.  This produces `main' in
the Info manual and uses an appropriate typeface in the printed
version.

Otherwise, the doco patch is fine.  Thanks.