3 ms·
Terse was fine when you had 10 tools with 5 options each. Now we have so many more tools and each has grown a large number of flags. Nobody can remember them al
by arccy 2y ago
Terse was fine when you had 10 tools with 5 options each. Now we have so many more tools and each has grown a large number of flags. Nobody can remember them all so the docs need to say more. Plus the more niche flags need more explanations.
- fsckboy 2y agoI like the flags documentation, there are too many other words. I also used to like the examples at the bottom.
- necovek 2y ago--help should give you basic docs for GNU utilities. Manpages should be more extensive (examples included). As far as GNU tools go, their attempt to move docs to (tex)info format for better interactivity has largely failed, so I guess most of that content is slowly moving over to manpages now.
- setopt 2y ago> As far as GNU tools go, their attempt to move docs to (tex)info format for better interactivity has largely failed I think the only community where it kind of succeeded is the Emacs community, thanks to the built-in info reader and that a lot of Emacs docs got written in info.
- setopt 2y agoIf you like examples, you might like the “tldr” command. https://tldr.sh/ https://tldr.sh/