chore: Auto generate docs

remotes/origin/HEAD
chrisgrieser 2023-11-12 13:07:08 +00:00 committed by github-actions[bot]
parent cad2c8fb4b
commit efbd1398ee
1 changed files with 58 additions and 31 deletions

View File

@ -1,13 +1,13 @@
*genghis.txt* For NVIM v0.8.0 Last change: 2023 October 13 *genghis.txt* For NVIM v0.8.0 Last change: 2023 November 12
============================================================================== ==============================================================================
Table of Contents *genghis-table-of-contents* Table of Contents *genghis-table-of-contents*
1. nvim-genghis |genghis-nvim-genghis-| 1. nvim-genghis |genghis-nvim-genghis-|
- How is this different from vim.eunuch?|genghis-nvim-genghis--how-is-this-different-from-vim.eunuch?|
- Installation and Setup |genghis-nvim-genghis--installation-and-setup| - Installation and Setup |genghis-nvim-genghis--installation-and-setup|
- Available Commands |genghis-nvim-genghis--available-commands| - Available Commands |genghis-nvim-genghis--available-commands|
- Autocompletion of directories|genghis-nvim-genghis--autocompletion-of-directories| - Autocompletion of directories|genghis-nvim-genghis--autocompletion-of-directories|
- Howis this different from vim.eunuch?|genghis-nvim-genghis--howis-this-different-from-vim.eunuch?|
- Why that name |genghis-nvim-genghis--why-that-name| - Why that name |genghis-nvim-genghis--why-that-name|
- About me |genghis-nvim-genghis--about-me| - About me |genghis-nvim-genghis--about-me|
@ -16,28 +16,19 @@ Table of Contents *genghis-table-of-contents*
Conveniencefile operations for neovim, written in lua. Lightweightplugin providing file operations without a full-blown file tree.
- |genghis-how-is-this-different-from-`vim.eunuch`?|
- |genghis-installation-and-setup| - |genghis-installation-and-setup|
- |genghis-available-commands| - |genghis-available-commands|
- |genghis-file-operation-command| - |genghis-file-operation-command|
- |genghis-file-utility-commands| - |genghis-file-utility-commands|
- |genghis-disable-ex-commands| - |genghis-disable-ex-commands|
- |genghis-autocompletion-of-directories| - |genghis-autocompletion-of-directories|
- |genghis-how-is-this-different-from-`vim.eunuch`?|
- |genghis-why-that-name| - |genghis-why-that-name|
- |genghis-about-me| - |genghis-about-me|
HOW IS THIS DIFFERENT FROM VIM.EUNUCH?*genghis-nvim-genghis--how-is-this-different-from-vim.eunuch?*
- Various improvements like automatically keeping the extensions when no extension is given, or moving files to the trash instead of removing them.
- Uses only vim-commands or lua os-modules, so it has no dependencies and works cross-platform.
- Makes use of up-to-date nvim features like `vim.ui.input` or `vim.notify`. This means you can get nicer input fields with normal mode support via plugins like dressing.nvim <https://github.com/stevearc/dressing.nvim>, and confirmation notices with plugins like nvim-notify <https://github.com/rcarriga/nvim-notify>, if they are installed and setup.
- If used with dressing and cmp, |genghis-you-can-also-get-autocompletion-of-directories|.
- Written 100% in lua.
INSTALLATION AND SETUP *genghis-nvim-genghis--installation-and-setup* INSTALLATION AND SETUP *genghis-nvim-genghis--installation-and-setup*
>lua >lua
@ -61,7 +52,7 @@ create keybindings for the commands you want to use:
keymap("n", "<leader>mf", genghis.moveAndRenameFile) keymap("n", "<leader>mf", genghis.moveAndRenameFile)
keymap("n", "<leader>nf", genghis.createNewFile) keymap("n", "<leader>nf", genghis.createNewFile)
keymap("n", "<leader>yf", genghis.duplicateFile) keymap("n", "<leader>yf", genghis.duplicateFile)
keymap("n", "<leader>df", function () genghis.trashFile{trashLocation = "your/path"} end) -- default: "$HOME/.Trash". keymap("n", "<leader>df", function() genghis.trashFile { trashLocation = "your/path" } end) -- default: "$HOME/.Trash".
keymap("x", "<leader>x", genghis.moveSelectionToNewFile) keymap("x", "<leader>x", genghis.moveSelectionToNewFile)
< <
@ -73,9 +64,12 @@ FILE OPERATION COMMAND ~
- `.createNewFile` or `:New`Create a new file. - `.createNewFile` or `:New`Create a new file.
- `.duplicateFile` or `:Duplicate`Duplicate the current file. - `.duplicateFile` or `:Duplicate`Duplicate the current file.
- `.moveSelectionToNewFile` or `:NewFromSelection`Prompts for a new file name and moves the current selection to that new file. (Note that this is a Visual Line Mode command; the selection is moved linewise.) - `.moveSelectionToNewFile` or `:NewFromSelection`Prompts for a new file name
and moves the current selection to that new file. (Note that this is a Visual
Line Mode command; the selection is moved linewise.)
- `.renameFile` or `:Rename`Rename the current file. - `.renameFile` or `:Rename`Rename the current file.
- `.moveAndRenameFile` or `:Move`Move and Rename the current file. Works like the UNIX `mv` command. Best used with |genghis-autocompletion-of-directories|. - `.moveAndRenameFile` or `:Move`Move and Rename the current file. Works like
the UNIX `mv` command. Best used with |genghis-autocompletion-of-directories|.
The following applies to all commands above: - If no extension has been The following applies to all commands above: - If no extension has been
provided, uses the extension of the original file. - If the new file name provided, uses the extension of the original file. - If the new file name
@ -85,20 +79,37 @@ only place in the current working directory, so `.moveAndRenameFile` is the
only command that can move to a parent directory. - All commands support only command that can move to a parent directory. - All commands support
|genghis-autocompletion-of-existing-directories|. |genghis-autocompletion-of-existing-directories|.
`renameFile` and `moveAndRenameFile` will notify any running LSP client about `renameFile` and `moveAndRenameFile` notify any running LSP client about the
the renaming. LSP servers supporting the `workspace/willRenameFiles` method can renaming. LSP servers supporting the `workspace/willRenameFiles` method can use
use this information to update various code parts, for example `use` or this information to update various code parts, for example `use` or `import`
`import` statements. statements.
FILE UTILITY COMMANDS ~ FILE UTILITY COMMANDS ~
- `.trashFile{trashLocation = "/your/path/"}` or `:Trash`Move the current file to the trash location. Defaults to the operating-system-specific trash directory. <https://github.com/chrisgrieser/nvim-genghis/blob/main/lua/genghis.lua#L164> Any existing file in the trash location with the same name is overwritten, making that file irretrievable. If bufdelete.nvim <https://github.com/famiu/bufdelete.nvim> is available, `require'bufdelete.nvim'.bufwipeout` would be used to keep window layout intact instead of `vim.cmd.bwipeout`. - `.trashFile{trashLocation = "/your/path/"}` or `:Trash`Move the current file
- `.copyFilename` or `:CopyFilename`Copy the file name. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise to `"`. to the trash location. Defaults to the operating-system-specific trash
- `.copyFilepath` or `:CopyFilepath`Copy the absolute file path. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise to `"`. directory. <https://github.com/chrisgrieser/nvim-genghis/blob/main/lua/genghis.lua#L164>
- `.copyRelativePath` or `:CopyRelativePath`Copy the relative file path. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise to `"`. Any existing file in the trash location with the same name is overwritten,
- `.copyDirectoryPath` or `:CopyDirectoryPath`Copy the absolute directory path. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise to `"`. making that file irretrievable. If
- `.copyRelativeDirectoryPath` or `:CopyRelativeDirectoryPath`Copy the relative directory path. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise to `"`. bufdelete.nvim <https://github.com/famiu/bufdelete.nvim> is available,
`require'bufdelete.nvim'.bufwipeout` would be used to keep window layout intact
instead of `vim.cmd.bwipeout`.
- `.copyFilename` or `:CopyFilename`Copy the file name. When
`clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise
to `"`.
- `.copyFilepath` or `:CopyFilepath`Copy the absolute file path. When
`clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise
to `"`.
- `.copyRelativePath` or `:CopyRelativePath`Copy the relative file path. When
`clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise
to `"`.
- `.copyDirectoryPath` or `:CopyDirectoryPath`Copy the absolute directory
path. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register,
otherwise to `"`.
- `.copyRelativeDirectoryPath` or `:CopyRelativeDirectoryPath`Copy the
relative directory path. When `clipboard="unnamed[plus]"` has been set, copies
to the `+` register, otherwise to `"`.
- `.chmodx` or `:Chmodx`Makes current file executable. Equivalent to `chmod +x`. - `.chmodx` or `:Chmodx`Makes current file executable. Equivalent to `chmod +x`.
To always use system clipboard put this in your configuration file: To always use system clipboard put this in your configuration file:
@ -132,7 +143,7 @@ Put this in your configuration file:
AUTOCOMPLETION OF DIRECTORIES*genghis-nvim-genghis--autocompletion-of-directories* AUTOCOMPLETION OF DIRECTORIES*genghis-nvim-genghis--autocompletion-of-directories*
You can get autocompletion for directories by using `dressing.nvim`, You can get autocompletion for directories by using `dressing.nvim`,
`nvim-cmp`, and vims omnifunc: `nvim-cmp`, and vims `omnifunc`
>lua >lua
-- packer -- packer
@ -154,14 +165,30 @@ You can get autocompletion for directories by using `dressing.nvim`,
>lua >lua
-- required setup for cmp, somewhere after your main cmp-config -- required setup for cmp, somewhere after your main cmp-config
require("cmp").setup.filetype("DressingInput", { require("cmp").setup.filetype("DressingInput", {
sources = cmp.config.sources { {name = "omni"} }, sources = cmp.config.sources { { name = "omni" } },
}) })
< <
HOWIS THIS DIFFERENT FROM VIM.EUNUCH?*genghis-nvim-genghis--howis-this-different-from-vim.eunuch?*
- Various improvements like automatically keeping the extensions when no
extension is given, or moving files to the trash instead of removing them.
- Uses only vim-commands or lua `os` modules, so it has no dependencies and
works cross-platform.
- Makes use of up-to-date nvim features like `vim.ui.input` or `vim.notify`.
This means you can get nicer input fields with normal mode support via plugins
like dressing.nvim <https://github.com/stevearc/dressing.nvim>, and
confirmation notices with plugins like
nvim-notify <https://github.com/rcarriga/nvim-notify>, if they are installed
and setup.
- LSP support when renaming.
- Written 100% in lua.
WHY THAT NAME *genghis-nvim-genghis--why-that-name* WHY THAT NAME *genghis-nvim-genghis--why-that-name*
A nod to vim.eunuch <https://github.com/tpope/vim-eunuch> - as opposed to A nod to vim.eunuch <https://github.com/tpope/vim-eunuch>. As opposed to
childless eunuchs, it is said that Genghis Khan has fathered thousands of childless eunuchs, it is said that Genghis Khan has fathered thousands of
children <https://allthatsinteresting.com/genghis-khan-children>. children <https://allthatsinteresting.com/genghis-khan-children>.
@ -174,7 +201,7 @@ economy and how software ecosystems manage the tension between innovation and
compatibility. If you are interested in this subject, feel free to get in compatibility. If you are interested in this subject, feel free to get in
touch. touch.
**Blog** I also occassionally blog about vim: Nano Tips for Vim **Blog** I also occasionally blog about vim: Nano Tips for Vim
<https://nanotipsforvim.prose.sh> <https://nanotipsforvim.prose.sh>
**Profiles** - Discord <https://discordapp.com/users/462774483044794368/> - **Profiles** - Discord <https://discordapp.com/users/462774483044794368/> -
@ -183,7 +210,7 @@ Academic Website <https://chris-grieser.de/> - GitHub
- ResearchGate <https://www.researchgate.net/profile/Christopher-Grieser> - - ResearchGate <https://www.researchgate.net/profile/Christopher-Grieser> -
LinkedIn <https://www.linkedin.com/in/christopher-grieser-ba693b17a/> LinkedIn <https://www.linkedin.com/in/christopher-grieser-ba693b17a/>
**Buy Me a Coffee**  
Generated by panvimdoc <https://github.com/kdheepak/panvimdoc> Generated by panvimdoc <https://github.com/kdheepak/panvimdoc>