community/neovim: docs are not available even with neovim-doc

Package Information

• Package name: neovim
• Package version: 0.10.4-r0
• Alpine version: 3.22.0_alpha20250108
• Alpine architecture: x86_64

Summary

The documentation for neovim isn't available, even after installing neovim-doc.

Steps to reproduce

• Install neovim and neovim-doc
• Open neovim
• Run :h nvim_buf_set_extmark

The nodoc.txt file is shown. It indicates that I should install neovim-doc, which is already installed.

The neovim-doc package doesn't actually include most of the documentation; it only include a very brief manpage.

Additional notes

I'm not entirely sure how to address this, because the neovim package installs the above linked stub into /usr/share/nvim/runtime/doc/api.txt, so a separate package can't ship (and overwrite) this file with the real documentation.

added triage:pending label

apk fix neovim => doc missing

apk fix neovim-doc => doc back again

This is essentially caused by an undocumented apk-tools behavior. neovim-doc has replaces=neovim set but that doesn't actually needed since apk allows replacing implicitly when 2 packages have the same origin. Which means that neovim will also replaces neovim-doc when it is installed later.

We could try if setting replaces_priority=1 in neovim-doc fixes the issue. Edit: doesn't seem to work

@fabled Would it may be better to move the origin check below the replaces* check (just like it is in apk_pkg_replaces_dir)?

This should make sure that a replaces specified between subpackages works as intended.

mentioned in merge request !81007 (merged)

mentioned in commit sertonix/apk-tools@004dd917

mentioned in merge request apk-tools!288 (merged)

mentioned in commit sertonix/apk-tools@a94fa187

closed with merge request apk-tools!288 (merged)