[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