[PATCH v2] Document how GDB searches for files when using -s, -e, and -se options

[PATCH v2] Document how GDB searches for files when using -s, -e, and -se options

[Kevin Buettner]

GDB's documentation of the 'file' command says:

    If you do not specify a directory and the file is not found in the
    GDB working directory, GDB uses the environment variable PATH as a
    list of directories to search, just as the shell does when looking
    for a program to run.

The same is true for files specified via commandline options -s, -e,
and -se.

This commit adds a cross reference to the file command for these options.
---
 gdb/doc/gdb.texinfo | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 5f09f3a1433..aad7c79c248 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -962,6 +962,11 @@ If @value{GDBN} has not been configured to included core file support,
 such as for most embedded targets, then it will complain about a second
 argument and ignore it.
 
+For the @samp{-s}, @samp{-e}, and @samp{-se} options, and their long
+form equivalents, the method used to search the file system for the
+symbol and/or executable file is the same as that used by the
+@code{file} command.  @xref{Files, ,file}.
+
 Many options have both long and short forms; both are shown in the
 following list.  @value{GDBN} also recognizes the long forms if you truncate
 them, so long as enough of the option is present to be unambiguous.
-- 
2.35.3

Re: [PATCH v2] Document how GDB searches for files when using -s, -e, and -se options

[Kevin Buettner]

Ping.

On Fri,  3 Jun 2022 10:04:43 -0700
Kevin Buettner <kevinb@redhat.com> wrote:

> GDB's documentation of the 'file' command says:
> 
>     If you do not specify a directory and the file is not found in the
>     GDB working directory, GDB uses the environment variable PATH as a
>     list of directories to search, just as the shell does when looking
>     for a program to run.
> 
> The same is true for files specified via commandline options -s, -e,
> and -se.
> 
> This commit adds a cross reference to the file command for these options.
> ---
>  gdb/doc/gdb.texinfo | 5 +++++
>  1 file changed, 5 insertions(+)
> 
> diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
> index 5f09f3a1433..aad7c79c248 100644
> --- a/gdb/doc/gdb.texinfo
> +++ b/gdb/doc/gdb.texinfo
> @@ -962,6 +962,11 @@ If @value{GDBN} has not been configured to included core file support,
>  such as for most embedded targets, then it will complain about a second
>  argument and ignore it.
>  
> +For the @samp{-s}, @samp{-e}, and @samp{-se} options, and their long
> +form equivalents, the method used to search the file system for the
> +symbol and/or executable file is the same as that used by the
> +@code{file} command.  @xref{Files, ,file}.
> +
>  Many options have both long and short forms; both are shown in the
>  following list.  @value{GDBN} also recognizes the long forms if you truncate
>  them, so long as enough of the option is present to be unambiguous.
> -- 
> 2.35.3
> 

Re: [PATCH v2] Document how GDB searches for files when using -s, -e, and -se options

[Eli Zaretskii]

> Date: Tue, 21 Jun 2022 08:40:43 -0700
> From: Kevin Buettner <kevinb@redhat.com>
> Cc: Eli Zaretskii <eliz@gnu.org>
> 
> Ping.

This is OK, and sorry for the delay.

Re: [PATCH v2] Document how GDB searches for files when using -s, -e, and -se options

[Kevin Buettner]

On Tue, 21 Jun 2022 18:52:23 +0300
Eli Zaretskii <eliz@gnu.org> wrote:

> > Date: Tue, 21 Jun 2022 08:40:43 -0700
> > From: Kevin Buettner <kevinb@redhat.com>
> > Cc: Eli Zaretskii <eliz@gnu.org>
> > 
> > Ping.  
> 
> This is OK, and sorry for the delay.

I've pushed it.