Re: [RFA] Unify async setting.

Eli Zaretskii
2008-08-15T17:22:39Z

> 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".