====== neovim ======

My notes on nvim.

===== Installation =====

**tl;dr**: Prefer the tarball to snap or default package manager.

The regular ''apt-get'' repo is too out-of-date. When 0.9.5 was stable, Ubuntu 20.04 was providing 0.3 or 0.4.

[[https://github.com/cli/cli/blob/trunk/docs/install_linux.md#snap-do-not-use|GitHub recommends against snap for gh]], and in WSL2, although I had ''snap'', it didn't work, so I [[https://github.com/neovim/neovim/blob/master/INSTALL.md#install-from-download|downloaded the tarball]]. (If you click Linux, it'll download the tarball. Otherwise [[https://github.com/neovim/neovim/releases|scroll down and find/expand "Assets"]].) Then I extracted it into $HOME/.local/bin/.

  cd ~/.local/bin/
  wget https://github.com/neovim/neovim/releases/latest/download/nvim-linux64.tar.gz
  tar -xvf nvim-linux64.tar.gz
  ln -s nvim-linux64/bin/nvim nvim

===== Copilot =====

You need Node for the Copilot plugin ([[https://github.com/github/copilot.vim?tab=readme-ov-file#getting-started|Getting Started]] instructions). It also works with Vim 9.0.0.0185+.

  - Install [[https://nodejs.org/en/download/package-manager|Node]].
  - Get nvim (see above)
  - [[https://github.com/github/copilot.vim?tab=readme-ov-file|Install plugin]] (used ''--filter=blob:none'')
    - ''%%git clone --filter=blob:none https://github.com/github/copilot.vim.git ~/.config/nvim/pack/github/start/copilot.vim%%''
  - read [[https://docs.github.com/en/copilot/using-github-copilot/getting-started-with-github-copilot?tool=vimneovim#about-github-copilot-and-vimneovim|docs]].
  
===== taglist =====

The old taglist I have isn't working as expected in tmux. Opening the window would wrap neovim windows. The fix is to disable auto-resizing the winwidth.

  let Tlist_Inc_Winwidth = 0

Along the way, I tried getting the latest release (since head auto runs tests). Maybe I should keep it.

  git clone --filter=blob:none -b v4.6 https://github.com/yegappan/taglist ~/.local/share/nvim/site/plugin/

===== cscope =====

Cscope has been removed from neovim. If you want it back, install [[https://github.com/dhananjaylatkar/cscope_maps.nvim|dhananjaylatkar/cscope_maps.nvim]] into ''.config/nvim/pack/cscope_maps/start/''. (This //may// also work in ''~/.local/share/nvim/site/pack/cscope_maps/start/'', but you have to get the path right.)

Your hierarchy would look something like:
<code>
~/.config/nvim/pack/cscope_maps/
└── start
    └── cscope_maps.nvim
        └── lua
            ├── cscope
            │   └── pickers
            └── utils
</code>

Run the following commands:

  mkdir -p ~/.config/nvim/pack/cscope_maps/start/
  cd ~/.config/nvim/pack/cscope_maps/start/
  git clone --filter=blob:none https://github.com/dhananjaylatkar/cscope_maps.nvim.git

Then in your init.vim, add the following snippet:

<file lua init.vim>
lua << EOF
  require('cscope_maps').setup({
    disable_maps = true, -- Mapping C-] to :Cstag <cword> worse than :tag <cword>
-- Alternatively, if we liked the mappings, then customise these two:
--    skip_input_prompt = true,
--    cscope = { skip_picker_for_single_result = true },
  })
EOF
</file>

===== Mappings =====

The easiest way to find out where a mapping came from is to run this command:

    :verbose imap <key sequence>