foodogsquared/website
1
0
Fork 0
mirror of https://github.com/foo-dogsquared/website.git synced 2025-02-07 09:19:00 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Reformat certain sections in "Using Neovim as a manpager"

Browse Source
This commit is contained in:
Gabriel Arazas 2023-03-23 22:14:17 +08:00
parent 39bec309d6
commit 91b4d517d2
No known key found for this signature in database
GPG Key ID: ADE0C41DAB221FCC
1 changed files with 4 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
content/posts/2023-03-12-using-neovim-as-your-manpager/index.adoc
View File

@ -78,6 +78,7 @@ Here's a video that shows using Neovim with the previously mentioned keybindings
video::./assets/neovim-manpage-navigation.webm[]
You can also navigate an outline of the document with kbd:[gO] which is nice to navigate large documents.
The outline will also show the flags and options if the manual page has a single- or double-dashed option at the beginning of a line (i.e., `--option`, `-flag`).
[NOTE]
====
@ -86,8 +87,6 @@ Unfortunately by default, kbd:[gO] only works on `help` and `:Man` buffers as in
Also, this feature is not found in Vim.
====
The outline will also show the flags and options if the manual page has a single- or double-dashed option at the beginning of a line (i.e., `--option`, `-flag`).
.The outline of man:yt-dlp[1]
image::./assets/neovim-man-outlines-with-flags-and-options.png[A full window of the outline for yt-dlp]
@ -108,6 +107,9 @@ In particular, the way how Neovim opens.
In the following video, there are two pagers: less and Neovim opening `configuration.nix(5)` which is at least 150,000 lines, 400,000 words counted, totalling just 9MB in size.
It should clearly show the different approach of opening.
.Neovim versus less on opening `configuration.nix(5)`
video::./assets/neovim-vs-less-performance.webm[]
For comprehension, here are several manpages that are quite big in comparison to the monstrous manual page. footnote:[This will vary between different systems with different versions and all.]
[#tbl:manual-pages-filesize]
@ -136,9 +138,6 @@ For comprehension, here are several manpages that are quite big in comparison to
| 9.01
|===
.Neovim versus less on opening `configuration.nix(5)`
video::./assets/neovim-vs-less-performance.webm[]
As you can see Neovim is magnitudes slower due to the approach of loading the whole file in memory before showing it unlike what less is doing. footnote:[To be fair, it's an github:neovim/neovim[issue for Neovim to open large files, issue=614].]
In practice, the difference can be negligible and only seen in larger documents since most manpages don't reach even just a single megabyte.