News for hackers. Stuff that matters.
Re:TLDR pages: Simplified, community-driven man pages by catalogia on Thursday January 23, 2020 @12:27AM (#22125088)
Something I like about tldr is that tldr pages are short enough to not necessitate using a pager, so you can print the tldr of a command and read it while typing the command in the same terminal emulator.

I know you can disable the pager for man, but the typical manpage is going to be fairly long anyway so the pager is generally desired. I suppose you could pipe man through head to just print out the first section, but honestly tldr seems to fill this niche better than I see that working.

Re:TLDR pages: Simplified, community-driven man pages by jopsen on Thursday January 23, 2020 @03:37AM (#22125889)
But they are not system specific... I don't need `tldr opkg` on my system.

In fact, having pages I don't need just causes confusion.

Moreover, commands can have system specific names.

Re:TLDR pages: Simplified, community-driven man pages by catalogia on Thursday January 23, 2020 @08:21AM (#22127293)
My tldr client has a --platform flag that takes 'linux, osx, sunos, or common'. So there is some support there for platform-specific tldr pages at least.

Also my tdlr-pages checkout is only 19MB, so I'm not too concerned about bloat. I'm not really sure how having tldr's for irrelevant commands would be a problem, maybe with some shell autocompletions? Maybe there is a way you could prune the tldr-pages checkout?

I guess all I can really say is tldr works really well for me and I like it a lot. Nothing is perfect, but tldr is quite nice despite some warts.