Re: [PATCH v3 4/4] gdb/doc: document '+' argument for 'list' command

Eli Zaretskii via Gdb-patches
2023-06-21T14:11:19Z

> Date: Wed, 21 Jun 2023 14:55:25 +0200
> Cc: gdb-patches@sourceware.org
> From: Bruno Larsen <blarsen@redhat.com>
>
> > "list +" lists the ten lines following a previous ten-line listing.
> >
> > vs
> >
> > @item list +
> > Same as using with no arguments, but errors out if the line is
> > past the end of the file.
> >
> > Or what am I missing?
> >
> Ah, I see what you mean. I thought that the help text should prioritize
> being short over being complete, and I basically modeled it after the
> no-arguments help text (With no argument, lists ten more lines after or
> around previous listing) whereas the documentation I thought was
> important outlining the difference.
>
> Would you prefer if I made the help text more verbose?

You could say in the help text something like

"list +" like with no arguments, but errors out if past end of the file