|
From: | GNU bug Tracking System |
Subject: | [debbugs-tracker] bug#35580: closed (hexl-mode documentation is confusing about insertion) |
Date: | Sat, 11 May 2019 12:02:02 +0000 |
Your message dated Sat, 11 May 2019 15:01:26 +0300 with message-id <address@hidden> and subject line Re: bug#35580: hexl-mode documentation is confusing about insertion has caused the debbugs.gnu.org bug report #35580, regarding hexl-mode documentation is confusing about insertion to be marked as done. (If you believe you have received this mail in error, please contact address@hidden) -- 35580: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=35580 GNU Bug Tracking System Contact address@hidden with problems
--- Begin Message ---Subject: hexl-mode documentation is confusing about insertion Date: Sun, 5 May 2019 13:53:55 +0100 I have been trying to understand how to insert (rather than overwrite) characters in hexl-mode. The documentation seems to be quite clear:Ordinary text characters overwrite in Hexl mode. This is to reduce
the risk of accidentally spoiling the alignment of data in the file.
There are special commands for insertion.(I copied this from git master just to be sure!)The list of commands underneath list several commands that have "insert" in their name, leading the naive reader (me) to believe they will insert rather than overwrite.However, this is not the case: the various keystrokes listed underneath which mention "insert" all overstrike.I suspect that my confusion results from guessing (incorrectly) that the sentence "There are special commands for insertion" uses the word "insertion" to oppose "overwrite" earlier in the paragraph; but in fact, it means "insertion" in the sense of "inserting a character", which happens always to overwrite in hexl-mode.To clarify this, I suggest changing the sentenceThere are special commands for insertion.toThere are special commands to insert characters by their numeric code.I think this is the feature that the sentence is trying to point up, as evidenced by the fact that the (partial) list of commands that follows gives the various commands for inserting a character by its code.Finally, the sentenceHere is a list of the commands of Hexl mode:could be changed toHere are some of the most useful commands of Hexl mode:because the list is not comprehensive (nor need it be).
--- End Message ---
--- Begin Message ---Subject: Re: bug#35580: hexl-mode documentation is confusing about insertion Date: Sat, 11 May 2019 15:01:26 +0300 > From: Reuben Thomas <address@hidden> > Date: Sun, 5 May 2019 13:53:55 +0100 > > Ordinary text characters overwrite in Hexl mode. This is to reduce > the risk of accidentally spoiling the alignment of data in the file. > There are special commands for insertion. > > (I copied this from git master just to be sure!) > > The list of commands underneath list several commands that have "insert" in > their name, leading the naive > reader (me) to believe they will insert rather than overwrite. > > However, this is not the case: the various keystrokes listed underneath which > mention "insert" all overstrike. > > I suspect that my confusion results from guessing (incorrectly) that the > sentence "There are special > commands for insertion" uses the word "insertion" to oppose "overwrite" > earlier in the paragraph; but in fact, it > means "insertion" in the sense of "inserting a character", which happens > always to overwrite in hexl-mode. Thanks, I clarified this text.
--- End Message ---
[Prev in Thread] | Current Thread | [Next in Thread] |