From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 11569 invoked by alias); 10 Oct 2006 21:45:28 -0000 Received: (qmail 11558 invoked by uid 22791); 10 Oct 2006 21:45:27 -0000 X-Spam-Check-By: sourceware.org Received: from romy.inter.net.il (HELO romy.inter.net.il) (192.114.186.66) by sourceware.org (qpsmtpd/0.31) with ESMTP; Tue, 10 Oct 2006 21:45:25 +0000 Received: from HOME-C4E4A596F7 (IGLD-84-228-242-30.inter.net.il [84.228.242.30]) by romy.inter.net.il (MOS 3.7.3-GA) with ESMTP id FZA86272 (AUTH halo1); Tue, 10 Oct 2006 23:45:16 +0200 (IST) Date: Tue, 10 Oct 2006 21:45:00 -0000 Message-Id: From: Eli Zaretskii To: Bob Wilson CC: gdb-patches@sources.redhat.com In-reply-to: <452BECD7.4010402@tensilica.com> (message from Bob Wilson on Tue, 10 Oct 2006 11:56:23 -0700) Subject: Re: fix use of @kbd and @key in gdb.texinfo Reply-to: Eli Zaretskii References: <452BECD7.4010402@tensilica.com> X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2006-10/txt/msg00099.txt.bz2 > Date: Tue, 10 Oct 2006 11:56:23 -0700 > From: Bob Wilson > > I've committed this as an obvious patch to fix inconsistent use of the TeXinfo > @kbd and @key macros in the GDB documentation. Thanks, but I'd really prefer that you'd post an RFA first, because some of the changes you did are not obvious at all. Specifically, I don't want to use the Emacs C-c notation in parts of the documentation that are not related to Emacs, because I fear that users who are not familiar with Emacs will not know what C-c means without explanation. (The Emacs manual has a lengthy chapter explaining that, but GDB doesn't.) So please change C-c etc. back to Ctrl-C form, except where Emacs is involved. The changes @kbd<->@key you made are okay, thanks. > * gdb.texinfo (Command Syntax, Connecting, Remote configuration, > Renesas Boards, ST2000, TUI Keys, TUI Single Key Mode, TUI Commands, > Emacs, Console I/O): Fix @key and @kbd usage. This ChangeLog entry is not according to GNU standards, it should be like this: * gdb.texinfo (Command Syntax, Connecting, Remote configuration) (Renesas Boards, ST2000, TUI Keys, TUI Single Key Mode, TUI Commands) (Emacs, Console I/O): Fix @key and @kbd usage. i.e., each line that references functions/chapters/sections should be enclosed in parens.