From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-58002-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 25975 invoked by alias); 15 Aug 2008 17:22:39 -0000
Received: (qmail 25965 invoked by uid 22791); 15 Aug 2008 17:22:39 -0000
X-Spam-Check-By: sourceware.org
Received: from mtaout4.012.net.il (HELO mtaout4.012.net.il) (84.95.2.10)     by sourceware.org (qpsmtpd/0.31) with ESMTP; Fri, 15 Aug 2008 17:22:00 +0000
Received: from HOME-C4E4A596F7 ([84.229.211.50]) by i_mtaout4.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0K5N00A1FK6Q75B0@i_mtaout4.012.net.il> for gdb-patches@sources.redhat.com; Fri, 15 Aug 2008 20:20:51 +0300 (IDT)
Date: Fri, 15 Aug 2008 17:22:00 -0000
From: Eli Zaretskii <eliz@gnu.org>
Subject: Re: [RFA] Unify async setting.
In-reply-to: <200808152107.19270.vladimir@codesourcery.com>
X-012-Sender: halo1@inter.net.il
To: Vladimir Prus <vladimir@codesourcery.com>
Cc: gdb-patches@sources.redhat.com
Reply-to: Eli Zaretskii <eliz@gnu.org>
Message-id: <uvdy2dwkk.fsf@gnu.org>
References: <200808152107.19270.vladimir@codesourcery.com>
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-patches.sourceware.org>
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2008-08/txt/msg00425.txt.bz2

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