Re: [doc/commit] Re: fix use of @kbd and @key in gdb.texinfo

[Bob Wilson <bwilson@tensilica.com>]

[-- Attachment #1: Type: text/plain, Size: 1883 bytes --]

Daniel Jacobowitz wrote:
> Bob, please don't do this again; part of the obligation of committing
> "obvious" changes is being responsive when someone disputes their
> obviousness.  Thanks in advance.

Somehow the message that Eli sent directly to me did not get through, probably 
lost in a torrent of spam, and I don't read gdb-patches regularly.  That's not a 
very good excuse, though -- I should have made a point of checking the list in 
case anyone had issues with my change.  I'm sorry.

I will err on the side of caution next time I have a patch that seems obvious.

Eli, thanks for fixing my ChangeLog entry -- I've been writing them that way for 
years and no one has pointed it out to me before.

I'm glad to hear that you want to keep the "Ctrl-" prefix, since it seems more 
clear to me, but I had thought that it was more important to be consistent 
throughout the document.  (My change was motivated by someone reviewing the 
documentation here at Tensilica, who complained about the inconsistency.)  I 
understand what you're saying about using Emacs notation in that section, though.

What about the TUI chapter?  There are lots of "C-" prefixes in there and it's 
not tied to Emacs users.  Should they all use "Ctrl-"?

Also, I noticed that there is a mix of upper- and lowercase for Ctrl key 
combinations, e.g, "Ctrl-C" vs. "Ctrl-c".  Can we make them all the same?  I 
have a slight preference for uppercase, especially because of the "Ctrl-L" case 
that I mentioned earlier, but that goes against the Emacs-style "C-c" convention 
where the letter is lowercase.

Here is a patch to fix one more place to use "Ctrl-".  It was using "C-d" before 
my change, but it seems like it ought to use "Ctrl-" to be consistent, since it 
has nothing to do with Emacs.

2006-10-16  Bob Wilson  <bob.wilson@acm.org>

         * gdb.texinfo (ST2000): Use Ctrl- instead of C-.

[-- Attachment #2: gdb-ctrl.patch --]
[-- Type: text/plain, Size: 658 bytes --]

Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.360
diff -u -r1.360 gdb.texinfo
--- gdb.texinfo	15 Oct 2006 21:36:00 -0000	1.360
+++ gdb.texinfo	16 Oct 2006 16:46:19 -0000
@@ -15264,7 +15264,7 @@
 you are done interacting with STDBUG, typing either of two character
 sequences gets you back to the @value{GDBN} command prompt:
 @kbd{@key{RET} ~ .} (Return, followed by tilde and period) or
-@kbd{@key{RET} ~ C-d} (Return, followed by tilde and control-D).
+@kbd{@key{RET} ~ Ctrl-d} (Return, followed by tilde and control-D).
 @end table
 
 @node Z8000