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

[Simon Marchi <simark@simark.ca>]

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