This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [RFA/commit+doco] GDB/MI: Document support for -exec-run --start in -list-features
- From: Joel Brobecker <brobecker at adacore dot com>
- To: Eli Zaretskii <eliz at gnu dot org>
- Cc: gdb-patches at sourceware dot org
- Date: Tue, 3 Dec 2013 14:18:25 +0400
- Subject: Re: [RFA/commit+doco] GDB/MI: Document support for -exec-run --start in -list-features
- Authentication-results: sourceware.org; auth=none
- References: <1386051670-28637-1-git-send-email-brobecker at adacore dot com> <83wqjm4cwl dot fsf at gnu dot org>
> > gdb/ChangeLog:
> >
> > * mi/mi-main.c (mi_cmd_list_features): add "exec-run-start-option".
> > * NEWS: Expand the entry documenting the new -exec-run --start
> > option to mention the corresponding new entry in the output of
> > "-list-features".
> >
> > gdb/doc/ChangeLog:
> >
> > * gdb.texinfo (GDB/MI Miscellaneous Commands): Document the new
> > "exec-run-start-option" entry in the output of the "-list-features"
> > command.
> >
> > gdb/testsuite/ChangeLog:
> >
> > * gdb.mi/mi-start.exp: Add test verifying that -list-features
> > contains "exec-run-start-option".
> >
> > Tested on x86_64-linux. Both code and doco parts are relatively
> > straightforward, so I am planning on checking this in in a day or
> > two, assuming doco approval.
>
> You have my approval, with one comment: each one of the items in that
> @table in gdb.texinfo should be indexed, to facilitate their
> discoverability by readers. E.g., for this item I'd suggest
>
> @findex exec-run-start-option
> @cindex support for @option{--start} option in @code{-exec-run}
>
> I'd also add an index entry for the entire section
>
> @cindex supported @sc{gdb/mi} features, list
>
> >From the past couple of weeks, it sounds like this section will grow
> very fast (so maybe it should become a full-fledged @node).
Thanks, Eli. I will prepare a followup patch as soon as this one
gets in. I don't see the section growing very fast, now that we have
-info-gdb-mi-commands, so it would be mostly for new switches. But
I do agree with all suggestions overall.
--
Joel