.gitignore added
[dotfiles/.git] / .config / coc / extensions / node_modules / coc-pairs / Readme.md
diff --git a/.config/coc/extensions/node_modules/coc-pairs/Readme.md b/.config/coc/extensions/node_modules/coc-pairs/Readme.md
new file mode 100644 (file)
index 0000000..461e20e
--- /dev/null
@@ -0,0 +1,46 @@
+# coc-pairs
+
+Auto pair extension for [coc.nvim](https://github.com/neoclide/coc.nvim).
+
+**Note** you can use other vim auto pairs plugins with coc.nvim, it's a
+simplified implementation to make auto pairs work like in VSCode.
+
+**Note** `b:coc_paires` have renamed to `b:coc_pairs`
+
+For enhanced `<CR>` experience, checkout `:h coc#on_enter()`.
+
+## Tips
+
+- You should disable/remove other auto pair plugins for this extension work as expected.
+- When you type a paired character which is just the next character, it would just move to the right by one column.
+- When the previous content ends with two inserting characters, the characters would just be inserted without inserting the paired character. This makes inserting triple quotes easier.
+- `'` only pairs when the character before is not a word character.
+- for `<` to insert paired `>`, the previous character should not be an empty space.
+
+## Install
+
+In vim/neovim, run this command:
+
+```
+:CocInstall coc-pairs
+```
+
+## Features
+
+- Insert pair characters automatically.
+- Buffer local pairs, ex: `autocmd FileType tex let b:coc_pairs = [["$", "$"]]`
+
+## Options
+
+- `pairs.disableLanguages`, list of language ids to disable this extension, default: `[]`.
+- `pairs.enableCharacters`, list of enabled characters, default: `` ["(", "[", "{", "<", "'", "\"", "`"] ``.
+- `pairs.enableBackspace`, enable imap for backspace to remove paired characters,
+  default: `true`, won't work when `<bs>` is already mapped.
+
+To disable characters for a specified filetypes, you can use `b:coc_pairs_disabled`, ex:
+
+    autocmd FileType markdown let b:coc_pairs_disabled = ['`']
+
+## License
+
+MIT