This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [RFA] Unify async setting.
- From: Eli Zaretskii <eliz at gnu dot org>
- To: Vladimir Prus <vladimir at codesourcery dot com>
- Cc: gdb-patches at sources dot redhat dot com
- Date: Fri, 15 Aug 2008 20:20:27 +0300
- Subject: Re: [RFA] Unify async setting.
- References: <200808152107.19270.vladimir@codesourcery.com>
- Reply-to: Eli Zaretskii <eliz at gnu dot org>
> From: Vladimir Prus <vladimir@codesourcery.com>
> Date: Fri, 15 Aug 2008 21:07:19 +0400
>
> [doc/ChangeLog]
> * gdb.texinfo (Background execution): Adjust example
> (GDB/MI Miscellaneous Commands): Document -list-target-features.
This part is okay, except that...
> +@itemize @minus
> +@item
> +@samp{async}---indicates that the target is capable of asynchronous
> +command execution, which means that GDB will accept further commands
> +even while the target is running.
> +
> +@end itemize
You want "@table @samp" here, not @itemize. Like this:
@table @samp
@item async
Indicates that the target is capable of asynchronous command
execution, which means that GDB will accept further commands
while the debuggee is running.
@itemize is for ordered lists, like when you want to show several
alternatives or a sequence of actions. When you want to describe
several attributes, you need to distinguish between the attribute and
its description, which is what @table is for.
(Note that I removed the "even" part.) And please use @value{GDBN}
instead of a literal "GDB".