loic/vim-singlechar
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: Add new commands and mappings for begin/end-of-line insertion

Browse source 
- Document new commands: :InsertCharBegin [count] [char], :InsertCharEnd [count] [char]
- Update mappings to support begin/end-of-line insertion with [count]
- Add configuration options for <Leader>I and <Leader>A mappings
- Document static cursor option (g:singlechar_static_cursor)
- Clarify usage and mapping examples for all new features
This commit is contained in:
lohhiiccc 2025-08-21 17:18:08 +02:00
parent 502bf47ce4
commit d26ea1e5a6
1 changed files with 17 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
doc/singlechar.txt
View file

@ -6,7 +6,7 @@
Author: lohhiiccc Author: lohhiiccc
Version: 1.0.0 Version: 1.0.0
License: MIT License: MIT
Last Change: 2025-08-19 Last Change: 2025-08-21
CONTENTS *singlechar-contents* CONTENTS *singlechar-contents*
@ -79,8 +79,10 @@ COMMANDS *singlechar-commands
The plugin provides two commands: The plugin provides two commands:
`:InsertCharAt [count]` - Insert a character at the cursor position `:InsertCharAt [count] [char]` - Insert a character at the cursor position
`:InsertCharAfter [count]` - Insert a character after the cursor position `:InsertCharAfter [count] [char]` - Insert a character after the cursor position
`:InsertCharBegin [count] [char]` - Insert a character at the beginning of the line
`:InsertCharEnd [count] [char]` - Insert a character at the end of the line
The optional count parameter specifies how many times to insert the character. The optional count parameter specifies how many times to insert the character.
@ -89,8 +91,10 @@ MAPPINGS *singlechar-mappings
By default, the plugin defines these mappings: By default, the plugin defines these mappings:
`<Leader>i` - Map to `:InsertCharAt` `[count]<Leader>i` - Map to `:InsertCharAt [count]`
`<Leader>a` - Map to `:InsertCharAfter` `[count]<Leader>a` - Map to `:InsertCharAfter [count]`
`[count]<Leader>I` - Map to `:InsertCharBegin [count]`
`[count]<Leader>A` - Map to `:InsertCharEnd [count]`
=============================================================================== ===============================================================================
CONFIGURATION *singlechar-configuration* CONFIGURATION *singlechar-configuration*
@ -99,6 +103,8 @@ Customizing mappings: >
" Must be set before the plugin is loaded " Must be set before the plugin is loaded
let g:singlechar_map_insert_at = '<Leader>i' " Default let g:singlechar_map_insert_at = '<Leader>i' " Default
let g:singlechar_map_insert_after = '<Leader>a' " Default let g:singlechar_map_insert_after = '<Leader>a' " Default
let g:singlechar_map_insert_begin = '<Leader>I' " Default
let g:singlechar_map_insert_end = '<Leader>A' " Default
< <
Disabling default mappings: > Disabling default mappings: >
" Disable default mappings " Disable default mappings
@ -107,7 +113,13 @@ Disabling default mappings: >
" Create your own mappings " Create your own mappings
nnoremap <expr> <silent> ,i ":<C-u>InsertCharAt " .. v:count1 .. "<CR>" nnoremap <expr> <silent> ,i ":<C-u>InsertCharAt " .. v:count1 .. "<CR>"
nnoremap <expr> <silent> ,a ":<C-u>InsertCharAfter " .. v:count1 .. "<CR>" nnoremap <expr> <silent> ,a ":<C-u>InsertCharAfter " .. v:count1 .. "<CR>"
nnoremap <expr> <silent> ,I ":<C-u>InsertCharBegin " .. v:count1 .. "<CR>"
nnoremap <expr> <silent> ,A ":<C-u>InsertCharEnd " .. v:count1 .. "<CR>"
< <
Set static cursor option: >
" When enabled, cursor returns to its original position after insertion
let g:singlechar_static_cursor = 1
Changing the prompt message: > Changing the prompt message: >
let g:singlechar_prompt = 'Character to insert (Esc to cancel): ' let g:singlechar_prompt = 'Character to insert (Esc to cancel): '
< <