Re: [PATCH 1/3] Documentation for Python -P commandline support

Simon Marchi
2019-07-22T16:04:08Z

On 2019-07-21 7:54 p.m., Kevin Buettner wrote:
> gdb/doc/ChangeLog:
>
> * gdb.texinfo (Mode Options): Add documentation for -P.
> ---
> gdb/doc/gdb.texinfo | 10 ++++++++++
> 1 file changed, 10 insertions(+)
>
> diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
> index eddd939869..868a1734de 100644
> --- a/gdb/doc/gdb.texinfo
> +++ b/gdb/doc/gdb.texinfo
> @@ -1252,6 +1252,16 @@ for remote debugging.
> Run using @var{device} for your program's standard input and output.
> @c FIXME: kingdon thinks there is more to -tty. Investigate.
>
> +@item -P
> +@cindex @code{-P}
> +@itemx --python
> +@cindex @code{--python}
> +Change interpretation of command line so that the argument immediately
> +following this switch is taken to be the name of a Python script file.
> +This option stops option processing; subsequent options are passed to
> +Python as @code{sys.argv}. This option is only available if Python
> +scripting support was enabled when @value{GDBN} was configured.
> +
> @c resolve the situation of these eventually
> @item -tui
> @cindex @code{--tui}
>

I think having an example would be helpful to understand how to use this
feature, and how it differs from -x. It wasn't really obvious to me at first,
so I suspect it won't be for other people less familiar with GDB.

Simon