[PATCH] [gdb/doc]: Updated manpages to be consistent with help

Philippe Waroquiers philippe.waroquiers@skynet.be
Thu Oct 14 18:56:05 GMT 2021


Note that I started a patch to have the options consistently using -- 

But as GDB accepts various layout for options (such as -thisone or --thisone),
it was not very clear it that was a good thing to do.
Pedro e.g. commented that GDB does not use the concept of 'short' and 'long' options.

Finally, as I understand, the decision was rather to use as cannnical form
  -thisone
 (in the doc and on line help)
and so the manual should then also be aligned.

Sadly, I had no time to finalize the patch (i.e. to rather systematically use
the single dash convention).
But this patch seems then not to go into what I think is the last agreed direction.

See the initial RFC in 
https://sourceware.org/pipermail/gdb-patches/2021-June/179587.html
and RFA in
https://sourceware.org/pipermail/gdb-patches/2021-June/179834.html

Thanks
Philippe





On Thu, 2021-10-14 at 10:10 -0300, Bruno Larsen via Gdb-patches wrote:
> On 10/13/21 12:30 PM, Sergio Durigan Junior wrote:
> > On Wednesday, October 13 2021, Bruno Larsen via Gdb-patches wrote:
> > 
> > > Updated manpages to be consistent with help information provided by the
> > > binary. The main changes are Making all long-form options have '--',
> > > instead of a single '-' and added most of the missing options to the
> > > manpage.
> > 
> > You might want to mention/fix
> > https://sourceware.org/bugzilla/show_bug.cgi?id=23965 and likely other
> > related manpage bugs in this commit.
> > 
> > Thanks,
> > 
> Good catch! I added this bug and https://sourceware.org/bugzilla/show_bug.cgi?id=10619
> 
> The other ones were unrelated (documentation of ?? and reordering of options to be alphabetical)
> 




More information about the Gdb-patches mailing list