53
submitted 10 months 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 10 months 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 10 months 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 9 months 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 10 months ago* (last edited 10 months 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 10 months 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 10 months ago

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

[-] jsdz@lemmy.ml 28 points 10 months ago* (last edited 10 months 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 10 months 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 10 months 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 10 months ago* (last edited 10 months 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 10 months ago

Actually sadly remember python-docs provided as info document.

[-] mosthated@feddit.nl 16 points 10 months 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 9 months ago

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

[-] Infiltrated_ad8271@kbin.social -4 points 10 months 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 10 months 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 10 months ago

One offers info, the other mansplains /S

[-] glad_cat 18 points 10 months 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 10 months ago
[-] folkrav@lemmy.world 6 points 10 months ago* (last edited 10 months 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 10 months 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 10 months 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 10 months 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 10 months ago

I completely forgot about info.

[-] recarsion@discuss.tchncs.de 9 points 10 months ago

There's also whatis for short summaries

[-] aquasteel@lemmygrad.ml 5 points 10 months ago

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

[-] ScottE@lemm.ee 4 points 10 months ago

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

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

I've been using this one pretty often lately

[-] tdawg@lemmy.world 0 points 10 months 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 10 months ago* (last edited 10 months 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

46611 readers
1078 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