this post was submitted on 10 Jul 2024
89 points (100.0% liked)

Linux

1258 readers
83 users here now

From Wikipedia, the free encyclopedia

Linux is a family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991 by Linus Torvalds. Linux is typically packaged in a Linux distribution (or distro for short).

Distributions include the Linux kernel and supporting system software and libraries, many of which are provided by the GNU Project. Many Linux distributions use the word "Linux" in their name, but the Free Software Foundation uses the name GNU/Linux to emphasize the importance of GNU software, causing some controversy.

Rules

Related Communities

Community icon by Alpár-Etele Méder, licensed under CC BY 3.0

founded 5 years ago
MODERATORS
 

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.

top 39 comments
sorted by: hot top controversial new old
[–] pr06lefs@lemmy.ml 31 points 4 months ago* (last edited 4 months ago) (2 children)

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 newphonepix

Would 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 use 

etc.

[–] thingsiplay 11 points 4 months ago

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 transfer

So 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 -b
[–] gomp@lemmy.ml 2 points 4 months ago

Here's what I get in fish when I start writing a rsync command 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]
[–] kbal@fedia.io 10 points 4 months ago* (last edited 4 months ago)

I am searching with /x

On most systems these days you can use regular expressions there. If /-x isn't good enough try /-x[ ,] or whatever.

[–] Obi@sopuli.xyz 10 points 4 months ago (1 children)

As someone with 0 knowledge of Linux (and very little of programming/command lines in general), this thread reads funny AF.

[–] martinb@lemmy.sdf.org 2 points 4 months ago

We are deep in the technical weeds here. 95% of Linux usage really doesn't require such humour unfortunately.

[–] bastion@feddit.nl 9 points 4 months ago (2 children)

Man pages this, man pages that. When will the Linux community start really thinking about woman pages?

[–] Eyck_of_denesle@lemmy.zip 3 points 4 months ago

Woman in emacs

[–] crispy_kilt@feddit.de 3 points 4 months ago (1 children)
[–] bastion@feddit.nl 3 points 4 months ago* (last edited 4 months ago)

That's the point.

I thought it would be clear that ~~we should start calling them womanuals~~ this was a joke.

[–] MrSoup@lemmy.zip 8 points 4 months ago (3 children)

Bonus:
You can open man pages inside GNOME Help by using yelp man:X

[–] jbk@discuss.tchncs.de 3 points 4 months ago

wow I kept opening man:somethingwithoutsectionunfortunately in firefox instead of doing that lol

load more comments (2 replies)
[–] OneCardboardBox@lemmy.sdf.org 7 points 4 months ago (2 children)

As an emacs user, I use M-x man. All my standard keybindings make finding what I need very easy.

Of course, it's not so fast if you aren't already in emacs.

[–] thingsiplay 15 points 4 months ago* (last edited 4 months ago)

I want to mention that one can set the pager for man to be Vim too. Then it would load the document in Vim instead in less for display and navigation. This can be set with option man -P pager or with the environmental variable $MANPAGER or $PAGER . I had set this up in the past with original Vim, but it required some special options for Vim as well. It was nice, but ultimately not needed; so I went back to less. Sometimes less is more.

Edit: Here is how one can use Neovim as the pager:

export MANPAGER='nvim +Man!'

I kind of missed it and will set it to this now. Put this line in the Bash configuration .bashrc and every man document is loaded in Neovim now.

[–] amanneedsamaid@sopuli.xyz 2 points 4 months ago

+1, displaying in a Emacs buffer solves any issues I could have. If you're already 'in' Emacs, this will be more frictionless than shell scripts around man

[–] vzq@lemmy.blahaj.zone 7 points 4 months ago (1 children)

Honestly, 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.

[–] ParetoOptimalDev@lemmy.today 2 points 4 months ago

I did this before being in emacs made it so convenient to avoid, but got bit randomly by different versions or gnu vs BSD.

[–] thingsiplay 5 points 4 months ago* (last edited 4 months ago)

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 -h or --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 -x or --ignore in 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 pressing h while looking at a document.

[–] Schmerzbold@feddit.org 4 points 4 months ago* (last edited 4 months ago)

You can set on what line on the screen less (the pager program man uses by default) puts search results with the -jn/--jump-target=n option. For example, using .5 as a value for n makes less focus the line with the search result on the center of the screen. This should help with your overshoot issue.

Either set the option within less with the - command followed by j.5↵ for the current running instance of less, or set and export the LESS environment variable inside your ~/.bashrc to have less always behave that way.

[–] jeffreyosborne@lemm.ee 4 points 4 months ago (1 children)

I like tldr. It doesnt give incredibly in depth explanations, but it does show the basics of using most commands.

[–] rotopenguin@infosec.pub 2 points 4 months ago

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.

[–] Tovervlag@feddit.nl 3 points 4 months ago* (last edited 4 months ago) (1 children)

I lately often use chatgpt for these kind of things. It's amazing in breaking down the parameters and what they mean. Verify, especially when the problem is hard and apparently unfindable. Chatgpt won't find it either. It sometimes makes up things in these scenarios.

edit: You guys are allowed to not like my post but it really helps me so why not try it instead of just downvoting.

[–] Asetru@feddit.org 3 points 4 months ago

It's amazing

It sometimes makes up things

https://xkcd.com/481/

[–] ParetoOptimalDev@lemmy.today 3 points 4 months ago (1 children)

woman in emacs.

I also find info pages much nicer to use after an adjustment period given I grew up on vim and man.

[–] crispy_kilt@feddit.de 2 points 4 months ago

Nice operating system. Just lacks a good editor

[–] electricprism@lemmy.ml 2 points 4 months ago* (last edited 4 months ago)

I read man in nvim, there is a alias on the arch wiki IIRC (and syntax highlighting)

[–] sping@lemmy.sdf.org 2 points 4 months ago

Sorry it's not a very direct answer but this is one of the many things that make Emacs such a comfortable environment once you're used to it, which takes ... a while.

There is a man command and then of course it's just more text displayed so you can search and narrow and highlight etc. in the same way you do with any other text. Plus of course there are a few trivial bonuses like links to other man pages being clickable.

It's all text and Emacs is a text manipulation framework (that naturally includes some editors).

[–] troyunrau@lemmy.ca 2 points 4 months ago (1 children)

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.

[–] JRepin@lemmy.ml 2 points 4 months ago* (last edited 4 months ago)

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.

[–] kubok@fedia.io 2 points 4 months ago (1 children)

I have krunner with the man plugin enabled. When typing man:X in the krunner prompt, a window opens with a nicely styled man page.

[–] JRepin@lemmy.ml 2 points 4 months ago (1 children)
[–] kubok@fedia.io 1 points 4 months ago

I did not know that. Thank you.

[–] wuphysics87@lemmy.ml 2 points 4 months ago

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.

[–] Andy@programming.dev 1 points 4 months ago

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

[–] Zucca@sopuli.xyz 1 points 4 months ago

I haven't used lsp for a while, but it seemed like a good $PAGER.

https://github.com/dgouders/lsp

[–] Rozauhtuno@lemmy.blahaj.zone 1 points 4 months ago

It's not exactly what you asked for, but the fish shell has often explanations of what each flag does.

[–] RovingFox@infosec.pub 1 points 4 months ago

I use nvchad and pipe the man page into it

[–] GadgeteerZA@fedia.io 1 points 4 months ago* (last edited 4 months ago)