From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 28674 invoked by alias); 11 May 2007 18:30:21 -0000 Received: (qmail 28664 invoked by uid 22791); 11 May 2007 18:30:20 -0000 X-Spam-Check-By: sourceware.org Received: from hq.tensilica.com (HELO mailapp.tensilica.com) (65.205.227.29) by sourceware.org (qpsmtpd/0.31) with ESMTP; Fri, 11 May 2007 18:30:18 +0000 Received: from localhost ([127.0.0.1]) by mailapp.tensilica.com with esmtp (Exim 4.34) id 1HmZse-0001z4-Gv; Fri, 11 May 2007 11:30:16 -0700 Received: from mailapp.tensilica.com ([127.0.0.1]) by localhost (mailapp [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 07555-01; Fri, 11 May 2007 11:30:16 -0700 (PDT) Received: from heron.hq.tensilica.com ([192.168.11.123]) by mailapp.tensilica.com with esmtp (Exim 4.34) id 1HmZse-0001yz-6B; Fri, 11 May 2007 11:30:16 -0700 Received: from [192.168.11.123] (heron.hq.tensilica.com [192.168.11.123]) by heron.hq.tensilica.com (Postfix) with ESMTP id 111225EC2F; Fri, 11 May 2007 11:30:16 -0700 (PDT) Message-ID: <4644B637.5050201@tensilica.com> Date: Fri, 11 May 2007 18:30:00 -0000 From: Bob Wilson User-Agent: Thunderbird 1.5.0.10 (X11/20070403) MIME-Version: 1.0 To: Eli Zaretskii CC: gdb-patches@sources.redhat.com Subject: Re: [PATCH] edit documentation for TUI mode References: <46423A94.2090607@tensilica.com> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2007-05/txt/msg00204.txt.bz2 Eli Zaretskii wrote: > The last sentence begs a question: ``how''? We should either answer > that right there, or have an xref to where the appropriate command is > described. Good point. I'm not entirely sure what to do here. It would be best to specify it directly, with a cross-ref for additional info, but there appear to be a lot of different ways of switching into TUI mode. Even the "C-x C-a" key binding, which is the most straightforward and also works to switch back out of TUI mode, has 3 different variations: "C-x C-a", "C-x a" and "C-x A". What do you think about changing that sentence as follows? You can also switch in and out of TUI mode while @value{GDBN} runs by using various TUI commands and key bindings, such as @kbd{C-x C-a}. @xref{TUI Keys, , TUI Key Bindings}. > Why did you switch to `@table @asis' and an explicit @key in each > item? What was wrong with the previous method? The last entry, "C-L", is not a key. It needs to be formatted with @kbd. The difference doesn't matter much for Info output, but for TeX output, it is bad to have a key-shaped box with "C-L" inside it. --Bob