News for hackers. Stuff that matters.
Re:Mpv – A free, open source, and cross-platform media player by msmenardi on Monday July 18, 2022 @12:10PM (#32139929)
I think the man page for MPV is a little too detailed. Sometimes all you need is a list of flags and a brief description of what they do - but some documentation (looking at you rsync and mpv) is designed to teach you mastery over the tool - which is a little overkill most of the time.
Re:Mpv – A free, open source, and cross-platform media player by MichaelCollins on Monday July 18, 2022 @12:16PM (#32140008)
The detailed manpage is great. The more details the manpage has for each flag, the easier it is for me to find the flag I'm looking for by searching for related terms. Longer descriptions means a greater chance of my related search term hitting a relevant result.

Common flags and short descriptions of them can be found with `mpv --help` or `tldr mpv`

rsync is another example of a manpage I love. Very detailed means very useful. With a detailed manpage, I don't have to waste my time figuring out where the real manual is.

Re:Mpv – A free, open source, and cross-platform media player by badocr on Monday July 18, 2022 @03:22PM (#32142353)
> Sometimes all you need is a list of flags and a brief description of what they do [...]

$ mpv --list-<options|properties>

Pipe to a grep-like program for keywords.