Dear All,

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

Thanks in advance for your feedback.
René

-- 
-- 
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 [email protected].
For more options, visit https://groups.google.com/d/optout.

Reply via email to