For many, many years now when I want to browse a man page about something I’ll type man X into my terminal, substituting X for whatever it is I wish to learn about. Depending on the manual, it’s short and therefore easy to find what I want, or I am deep in the woods because I’m trying to find a specific flag that appears many times in a very long document. Woe is me if the flag switch is a bare letter, like x.
And let’s say it is x. Now I am searching with /x followed by n n n n n n n n N n n n n n. Obviously I’m not finding the information I want, the search is literal (not fuzzy, nor “whole word”), and even if I find something the manual pager might overshoot me because finding text will move the found line to the top of the terminal, and maybe the information I really want comes one or two lines above.
So… there HAS to be a better way, right? There has to be a modern, fast, easily greppable version to go through a man page. Does it exist?
P.S. I am not talking about summaries like tldr because I typically don’t need summaries but actual technical descriptions.
Kind of off topic, but you know what would be cool? If you had an ‘man explain’ command that would define all the flags/args in a command, like:
man explain rsync --append-verify --progress -avz -e "ssh -p 2222" root@$dip:/sdcard/DCIM/Camera newphonepixWould give you:
rsync - a fast, versatile, remote (and local) file-copying tool --append-verify --append w/old data in file checksum --progress show progress during transfer --archive, -a archive mode is -rlptgoD (no -A,-X,-U,-N,-H) --verbose, -v increase verbosity --compress, -z compress file data during the transfer --rsh=COMMAND, -e specify the remote shell to useetc.
Like this?
Or these?
You can just grep the help output
$ rsync --help 2>&1 | grep -E '^ *(--append-verify|--progress|--archive)' --archive, -a archive mode is -rlptgoD (no -A,-X,-U,-N,-H) --append-verify --append w/old data in file checksum --progress show progress during transferSo it should be possible to create a simple script to do that. Similarly one can output the man document as text to stdout, which in turn can be grepped. I have no grep command at hand to do this in a useful way:
man grep | col -bHere’s what I get in fish when I start writing a
rsynccommand and hit tab to ask for completions:❱ rsync --append-verify --progress -avz - -0 --from0 (All *from/filter files are delimited by 0s) --delete (Delete files that don’t exist on sender) -4 --ipv4 (Prefer IPv4) --delete-after (Receiver deletes after transfer, not before) -6 --ipv6 (Prefer IPv6) --delete-before (Receiver deletes before transfer (default)) -8 --8-bit-output (Leave high-bit chars unescaped in output) --delete-delay (Find deletions during, delete after) [more lines omitted]There is a Plugin for Zsh (ohmyzsh) that gives you that right in the shell. I use it all the time and rely on it. Don’t have the name on my mind though, sorry.
Please do tell once you’ve figured it out.
I’d also like some guidance on this problem (other than “use emacs”), but searching for “ -x” will have a lower false positive rate
I always add a space or two before the flag:
/ -xHonestly, I usually just “man command” in google.
I know it’s wrong but my browser is tiled next to my terminal and it’s easy to look up stuff.
I like tldr. It doesnt give incredibly in depth explanations, but it does show the basics of using most commands.
I have to remember to use tldr, one of these days. Some manpages get so lost in the pedantry of covering everything that the 99 percentile stuff is buried.
Sorry for my previous comment. I was commenting before reading the entire post and was missing the point. On a sidenote, its often enough and helpful to just list the options with
program -hor--help. Sometimes the help option has more information or is easier to understand than the man document.When I search for options in a man document, I usually try it with putting a dash in front of it as
-xor--ignorein example. For really large documents sometimes it can help to add a space before it "-x" or a comma after it "-x," depending on how its actually written. BTW the man program itself has a builtin help you can show by just pressinghwhile looking at a document.man -k printf Search the short descriptions and manual page names for the keyword printf as regular expression. Print out any matches. Equivalent to apropos printf.info
boooooo
I read man in nvim, there is a alias on the arch wiki IIRC (and syntax highlighting)
In KDE, there used to be man: as a protocol that you could use from Konqueror or anything else for that matter. Does it still exist?
I’m at work and cannot check.
Yup still exists. It is also available in KDE Help Center. And you can quickly jump to a man page you typing “#man” into KRunner.
I’ve had this same situation happen to me before and my solution was to search
-xinstead of justx.I use nvchad and pipe the man page into it
You can search via regex. For instance you know a section heading or flag is the first thing on a line preceded with spaces. I also find it earier to read with extensions for colors.
deleted by creator
As someone else said, setting less’ jump value is helpful.
Another tool I use, mostly for the zshall manpage, is https://github.com/kristopolous/mansnip
