1. Forum
  2. USENET
  3. comp.unix.shell

  • Re: Documentation (man, info, etc.) (was Re: The Bash =?UTF-8?B?SGFja2Vy4oCZcw==?= Wiki)

    From Lawrence =?iso-8859-13?q?D=FFOliveiro?=@ldo@nz.invalid to comp.unix.shell on Wed Aug 27 23:26:11 2025
    From Newsgroup: comp.unix.shell

    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.
    --- Synchronet 3.21a-Linux NewsLink 1.2
  • From Lawrence =?iso-8859-13?q?D=FFOliveiro?=@ldo@nz.invalid to comp.unix.shell on Sat Aug 30 00:26:12 2025
    From Newsgroup: comp.unix.shell

    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.
    --- Synchronet 3.21a-Linux NewsLink 1.2