Let's be honest: man pages are fucking dogshit

Let's be honest: man pages are fucking dogshit.

Maybe they were good thirty years ago when you were supposed to have a printed 3000-page UNIX manual with you and the man pages served just as a reminder ot the basic things of that manual.

But today, in 2018, they are just unusable for a begginer. If you are a begginer, you will not understand a word of most of them, and if you are an advanced user, they will not tell you anything you don't already know. They are useless.

Attached: lees_command_options_for_color_man_pages.png (599x359, 121K)

Other urls found in this thread:

man.openbsd.org/afterboot
tldr.sh
man7.org/linux/man-pages/man1/cut.1.html
man.openbsd.org/cut#EXAMPLES
man.openbsd.org/ls#EXAMPLES
man.openbsd.org/tar#EXAMPLES
cheat.sh/
elvis.the-little-red-haired-girl.org/elvisman/elvisdm.html#man
twitter.com/SFWRedditVideos

My problem with them is that they have way too much shit and I always just need to know something specific
Quicker to google instead of searching through the manpage

They are pretty useful, you are just luser not needing to learn to do advanced things, and many such are documented in man pages.
PS there are more than just section 1 and 8 in man.

ctrl+shift+f is your friend baguette

They are reference manuals, not tutorials. Personally, I love them, as they are very quick to access and just searching through them usually yields what I want to know.

So you're saying we should adopt womyn pages.

Agreed. Archwiki helped me far more than any manpages

I think emacs offers that

i just google shit i cant be bothered with man pages

if you don't understand man pages then just read the man page on them

This.

man man

i really wish that every program came with tldr pages as well

>words are unusable for a beginner

OpenBSD man pages don't have this problem.

man.openbsd.org/afterboot

Attached: 1519351759500.png (765x768, 408K)

>not using vim style search ala /nigger
kys

Not my fault if someone is extremely retarded and doesn't know how or what to read. Man pages are not disappointing me to this day.
>but muh stackoverflow!!
And off Jow Forums you go

It does not matter which tools you use.
The only thing that matters is that you get your shit done.

For some people man pages work, for others it's the arch wiki or whatever. It. does. not. matter.
Pick your tools and know them. Don't care about what other people say.

Nevertheless man-pages in general include all needed information. Sure, it is lacking examples, but once you figure out how they work and how they are structured it's fine and if you don't want to figure it out, then just don't. But stop complaining.

Attached: asdasd.gif (360x314, 2.86M)

Thats why there are info pages.

use man man

or gnu info

tldr.sh

Nice utility if you need a small description of the app with examples

>Sure, it is lacking examples

Only true for garbage GNU/Linux man pages.

man7.org/linux/man-pages/man1/cut.1.html

VS

man.openbsd.org/cut#EXAMPLES
man.openbsd.org/ls#EXAMPLES
man.openbsd.org/tar#EXAMPLES

>tldr.sh

Here comes the javascriplet again

Attached: man.jpg (500x701, 102K)

If it works and it helped someone getting familiar with a new command to get started, I say mission accomplished. And it's available in many formats.

>project has a README.md
>lazy programmer makes --help just vomit the README.md into the terminal
>make a nice pretty man page to print to terminal instead that's easier to read because it's formatted for small screens
>project maintainer doesn't like it because it puts information in two separate places
>goes back to just vomiting the ugly README.md to the terminal

Attached: 178f7be921da7d3568f953b795e97bacbc9e215f5e7391b4a7894139fb355798.png (388x194, 64K)

Search for this:
tldr man pages

They're like manpages but only with the very most brief examples.

didn't know you could have colors in man pages

Depends on your shell.

>tldr.sh
>not cheat.sh/
$ curl cheat.sh/tar

>retard doesn't know you can search manpages
>retard doesn't know you can pass --help flag to get "something specific"

>cheat.sh
You have to be online for it all the time?

ZOOMER FUCK OFF

Eh, I think that is how curl works user.

I'm surprised people hate manpages because they're too much.

I think they aren't enough. Yeah ok so I have 20 switches, what will they literally do, and can I combine certain onrs without them breaking something oe tripping each other?

It's the problem I have with alot of documentation, yeah there is this nd that and I can use that parameter but what does it DO? It seems like I check stackoverflow way too many times for things that could be in a man or other documentation.

I am going to be fucking on top of my own documentation to fight this cancer.

You can if you put colors on less.

they are like the msdn of linux, there could be 5 pages of useless shit and then in one little short sentence is something ultra important and if you miss it, you're fucked.
old people act like this is okay only because they had to read that shit for years and years and they are arrogant enough to assume that I'd get paid to do the same but that's not true anymore.

Next level autist: reads man pages for fun.

>he doesn't know about the one man page a day challenge

Never gonna make it, brah

How to do that?

Edit your .bashrc file and put this on it:

# Have less display colours
export LESS_TERMCAP_mb=$'\E[01;31m'
export LESS_TERMCAP_md=$'\E[01;31m'
export LESS_TERMCAP_me=$'\E[0m'
export LESS_TERMCAP_se=$'\E[0m'
export LESS_TERMCAP_so=$'\E[01;44;33m'
export LESS_TERMCAP_ue=$'\E[0m'
export LESS_TERMCAP_us=$'\E[01;32m'

thanks dude

Attached: Autism_meter.gif (728x426, 128K)

>2018
>something called "man"
thats so mysoginistic wtf

I do find man pages kind of my last resort. I'd prefer them to contain more examples of common usages. Some do, but it's not guaranteed.

Let's be honest: OP is a faggot and his taste is questionable

>if you are an advanced user, they will not tell you anything you don't already know
They're for reference.

man pages are much better than a shit google search the problem is zoomers have zero attention span and will thankfully never get good tech jobs. I guarantee you're a bootcamp webdev.

k y s p l z

literally `man whathever; /mysearch; q` instead of opening up your botnet browser and searching for minutes to hours

No they're not. They're extremely useful.
They work perfectly fine for most things.
You're probably to retarded to realise man is also used for code/library manuals and system calls among other things.

/


Based *BSD man pages are based.

Friendly reminder you can view manpages in Elvis "man" mode elvis.the-little-red-haired-girl.org/elvisman/elvisdm.html#man
$ elvis troff_file
there
:display man

Is fucking awesome.

Attached: Elvis-241x300.jpg (241x300, 20K)

I use manpages all the time, maybe you're just a brainlet?

>If you are a begginer, you will not understand a word of most of them,
Then you wouldn't even know which man page to read to begin with.

>if you are an advanced user, they will not tell you anything you don't already know.
As if anyone would know all the optional parameters to each and every program.

Generally, if your question is "How do I do A" man pages aren't that helpful, but if your question is "Can I do A with program B" they are great.

Wow, you're so right! They should make it easy so us girls can use Linux too! Why not make it a wiki I can access from my phone that explains it using a multiracial inclusive assortment of emojis??

Annual reminder that man can spit out postscript
man -t 1 intro > out.ps

I agree that man pages are not useful for beginners. Fortunately, the FreeBSD Handbook exists to teach you everything you need to know so you can understand man pages later.
Don't blame man pages for the fact your GNU/Linux distros don't have good beginner docs. It's getting better now, but a few years ago, if the BSDs didn't exist, I'd have never learnt Unix.

But why? Postscript is garbage and all the postscript readers are garbage. It's just a proprietary Adobe format people keep shilling. I'd rather read it in plaintext or even in html.

>app
Off yourself

I dunno. Maybe some people really hate trees, and want to print the whole thing.

kek

>project knows how to handle documentation flow
>i don't like it
too bad user

There is an amazing lack of good documentation. Maybe it is just a coincidence that the same people that write manpages are shit at writing documentation. Maybe the original manpage docs were shit and they learned from that.
/thread

this is neat

doesn't work for me