René wrote: > I'm preparing a presentation of Vim's essentials hence I'm extensively > browsing through Vim's documentation. Unless I'm mistaken it seems > that in the index.txt file the word 'buffer' is quite often used in > lieu of 'register'. I found this by chance while I was looking for the > word 'buffer' (:help index :set hls /buffer). > > For instance: > > |C| ["x]C 2 change from the cursor position to the end > of the line, and N-1 more lines [into > buffer x]; synonym for "c$" > > Now if I follow the tag |C| (positioning my cursor on it, then typing CTRL-]) > I read in change.txt: > > *C* > ["x]C Delete from the cursor position to the end of the > line and [count]-1 more lines [into register x], and > start insert. Synonym for c$ (not |linewise|). > > The notation '"x' unambiguously refers to 'register x'. So in the > index.txt file I think that one should read 'register' in lieu of > 'buffer' while the text in change.txt uses the word 'register' > correctly. > > This is mostly the case in section 2 (Normal mode) and once in section > 2.4 (gp command). In other places (section 5 EX commands) the word > 'buffer' seems to be always used appropriately. > > These small discrepancies might confuse new users. Indeed clear > vocabulary and precise definitions are important in the learning > process. > > I'm too new to Vim and far from an expert but I'd be very happy to > contribute by reviewing the index.txt file and proposing an update > with the word changes. It seems not too difficult: everywhere one > reads '["x]' one should also read '[into register x]'. However I'd > prefer to pass my updates to someone with expertise and authority to > review my proposed changes. > > Note: I found it in Vim version 7.4 and 8.0
You are right, these "buffer x" should be "register x". There are a few of them. I'll fix it. -- LAUNCELOT: I am, sir. I am a Knight of King Arthur. FATHER: 'Mm ... very nice castle, Camelot ... very good pig country.... "Monty Python and the Holy Grail" PYTHON (MONTY) PICTURES LTD /// Bram Moolenaar -- b...@moolenaar.net -- http://www.Moolenaar.net \\\ /// sponsor Vim, vote for features -- http://www.Vim.org/sponsor/ \\\ \\\ an exciting new programming language -- http://www.Zimbu.org /// \\\ help me help AIDS victims -- http://ICCF-Holland.org /// -- -- You received this message from the "vim_use" maillist. Do not top-post! Type your reply below the text you are replying to. For more information, visit http://www.vim.org/maillist.php --- You received this message because you are subscribed to the Google Groups "vim_use" group. To unsubscribe from this group and stop receiving emails from it, send an email to vim_use+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.