53
submitted 1 year ago by folak@lemmy.world to c/linux@lemmy.ml

Hi,

I saw there https://askubuntu.com/questions/9325/what-is-the-difference-between-man-and-info-documentation that info is "better" than man because is outdated. Still right in 2023 ?

top 29 comments
sorted by: hot top controversial new old
[-] SpicySquid@lemmy.ml 50 points 1 year ago

Well.. I guess I have been living under a rock. Today is the first time to have heard of info. I have been using man for well over 2 decades now.

[-] palordrolap@kbin.social 10 points 1 year ago

Surprising you haven't come across a man page that basically says "We couldn't be bothered putting everything in here, check out the info page on it instead."

I feel like I find myself on one of those every 6 months or so.

[-] BaumGeist@lemmy.ml 2 points 1 year ago

That's funny, I had the opposite experience. When I found out that info was the GNU projects recommended way of documentation, I was all on board. Then I tried using it, and it couldn't find most CLI software I used. So I downloaded the texinfo archives... and that still lacked probably 50% of the commands I tried to look up.

Then I searched up how to get info pages for this or that tool, and someone on StackOverflow had said that it was woefully incomplete and outdated at this point.

I think I'll give it another try and report back

[-] kevin@mander.xyz 35 points 1 year ago* (last edited 1 year ago)

9 times out of 10, what I want is tldr (https://tldr.sh/). There are a bunch of terminal interfaces for it, I use tealdeer.

[-] stepanzak@iusearchlinux.fyi 17 points 1 year ago

Please remove the exclamation mark before your link, you are making it an image that obviously can't be loaded.

[-] kevin@mander.xyz 9 points 1 year ago

Oops, thanks for the heads up! No idea where that came from

[-] jsdz@lemmy.ml 28 points 1 year ago* (last edited 1 year ago)

The "info" thing was a misguided attempt by a crazed bunch of emacs zealots to usurp the rightful position of "man". Probably GNU's worst idea. It persisted in having some popularity for a decade or more but is now mostly forgotten I think. Despite having used Debian for the past ten years straight I've only just now found out that info doesn't even get installed by default any more.

[-] iusearchbtw 20 points 1 year ago

Eh, to be honest, manpages aren't particularly good as either documentation or quick references (hence the popularity of tldr), and info is intended primarily for the sort of long-form, comprehensive documentation that would be awkward to fit in a manpage. Also, texinfo documents can easily be exported to HTML, so one format can be used for both online and offline docs. It's an admirable effort, if nothing else.

[-] kugiyasan@lemmy.one 8 points 1 year ago

I wasn't a huge fan of manpages either until I got a kernel class at uni. The man pages for syscalls and library calls are super well made.

[-] jsdz@lemmy.ml 8 points 1 year ago* (last edited 1 year ago)

I'd have liked it a lot better if it had been intended and used as a place to put the more extensive documentation that isn't really appropriate for a man page, while leaving the man pages as they were. Instead, I learned about it back in the day by being frequently annoyed at missing man pages for basic tools, which had been replaced with suggestions to look at 'info' instead, which always seemed to be much less concise and have a worse UI.

[-] mcepl@lemmy.world 2 points 1 year ago

Actually sadly remember python-docs provided as info document.

[-] mosthated@feddit.nl 16 points 1 year ago

Can you provide any source that it was created or initiated by what you call 'a crazed bunch of emacs zealots', or that the goal was to 'unsurp the rightful position of "man"'. Quite bold statements that are unlikely to be true imho.

[-] notroot 3 points 1 year ago

Emacs zealot here ... can confirm we're like this ;)

[-] Infiltrated_ad8271@kbin.social -4 points 1 year ago

Just because it's theirs? I figured it would be because of an alleged gender issue, for the same reason some are trying to do away with whitelists/blacklists and the like.

[-] jsdz@lemmy.ml 6 points 1 year ago

No, nothing to do with that sort of thing. The idea was that it'd be all hypertexty and therefore better.

[-] Railcar8095@lemm.ee 18 points 1 year ago

One offers info, the other mansplains /S

[-] glad_cat 18 points 1 year ago

Info is supposedly more modern, like a website. But it’s unusable and as annoying as emacs. Man is good enough.

[-] mosthated@feddit.nl 7 points 1 year ago
[-] folkrav@lemmy.world 6 points 1 year ago* (last edited 1 year ago)

You can find something annoying and not hate it. Linux itself is annoying in so many ways, yet I love it.

[-] glad_cat 3 points 1 year ago

I love emacs and I used it a lot with org-mode, but you need weeks to master it, and it's a PITA to configure.

[-] iusearchbtw 12 points 1 year ago

man is standard Unix manual pages, while info is a documentation format introduced/popularised by GNU. info pages usually have a lot more information (sometimes including tutorials, guided examples, links to different pages and sections, etc (depending on the project maintainer obviously)) but man pages are the standard and basically everything has one. If you run info [program] for something without a dedicated info page, it will show the man page instead.

[-] macallik@kbin.social 10 points 1 year ago

My impression
tldr/cheat: Explains most popular arguments using as little words as possible
man: Explains the entire command using a more technical tone
info: Explains the entire command in slightly more informal tone. Can feel wordier as a result, but on the flipside it connects alternative/related commands in a logical way

[-] trachemys@iusearchlinux.fyi 10 points 1 year ago

I completely forgot about info.

[-] recarsion@discuss.tchncs.de 9 points 1 year ago

There's also whatis for short summaries

[-] aquasteel@lemmygrad.ml 5 points 1 year ago

And don't forget apropos. I can't remember what it does, though.

[-] ScottE@lemm.ee 4 points 1 year ago

It's just the same thing as man -k.

[-] netchami@sh.itjust.works 1 points 1 year ago

I've been using this one pretty often lately

[-] tdawg@lemmy.world 0 points 1 year ago

Personally I’m a fan of cheat.sh

For instance to get info on curl you can:

curl cheat.sh/curl
[-] folkrav@lemmy.world 2 points 1 year ago* (last edited 1 year ago)

I since switched to tldr (for the offline/caching functionality, I think?), but for the longest time I just used a wrapper function that did exactly this in my shell configuration. Something a bit like this:

function cheatsh() { 
    curl cheat.sh/"\$1" 
} 
this post was submitted on 21 Oct 2023
53 points (94.9% liked)

Linux

48375 readers
1276 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