| Message ID | 20190721235427.21893-2-kevinb@redhat.com |
|---|---|
| State | New |
| Headers | show |
> From: Kevin Buettner <kevinb@redhat.com> > Cc: Kevin Buettner <kevinb@redhat.com> > Date: Sun, 21 Jul 2019 16:54:25 -0700 > > gdb/doc/ChangeLog: > > * gdb.texinfo (Mode Options): Add documentation for -P. Thanks. > +Python as @code{sys.argv}. This option is only available if Python > +scripting support was enabled when @value{GDBN} was configured. I'd say "when @value{GDBN} was built". It's more clear, I think. Otherwise, this part is OK, but we should also mention this in NEWS.
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
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}