On Wed, 27 Aug 2025 16:51:20 -0300, Jim Diamond wrote:

Over the years I've heard people complain that man pages are too terse.

The bash(1) man page, for a counterexample, replicates the entire manual.

Imagine if the man page for ffmpeg(-all), gcc or txr was verbose.

I just counted over 19,000 words in the ffmpeg(1) man page. That does try
to explain the use of the core command (including filtergraphs!) with no details specific to particular filters/codecs/formats/etc.

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)

On Fri, 29 Aug 2025 12:12:45 -0000 (UTC), Lars Poulsen wrote:

2) There is not really a consistent mapping between package names and
folder/file names in /usr/share/doc

Listing the contents of the package will show where all the files go,
including documentation files.

3) Even if it not in /usr/share/doc on your system, it may in fact
be available in your repos, but good luck figuring out what the
package is called.

Keyword searches can be helpful here.

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)