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[] 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. 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] [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. 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] .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] 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. 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. 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.] 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] [#tbl:manual-pages-filesize]
@ -136,9 +138,6 @@ For comprehension, here are several manpages that are quite big in comparison to
| 9.01 | 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].] 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. In practice, the difference can be negligible and only seen in larger documents since most manpages don't reach even just a single megabyte.