Bug#1138807: the manpages of pngcrush should be formatted properly

Md Ayquassar MdAyq6 at ro.ru
Thu Jun 4 06:34:31 BST 2026


Package: pngcrush
Version: 1.8.13-3

Maximize an xterm window and issue `man pngcrush`. You see, e.g., this:

“
        -oldtimestamp (Do not reset file modification time)
  
               -ow (Overwrite)
  
        Overwrite the input file.
               The input file is removed
  
               and the temporary file (default "pngout.png") is renamed to the input file after recompression and therefore they must reside on the same filesystem.
  
               CAUTION: If you are running multiple instances of pngcrush in parallel, you must specify a different temporary filename for each instance, to avoid collisions.
  
               -q (quiet) suppresses console output except for warnings
  
               and summary of results.
  
        -reduce (do lossless color-type or bit-depth reduction)
  
        (if possible).
               Also reduces palette length if
  
        possible.
               Currently only attempts to reduce the
  
        bit depth from 16 to 8.
               Reduces all-gray RGB
  
        or RGBA image to gray or gray-alpha.
               Reduces
  
               all-opaque RGBA or GA image to RGB or grayscale.  Since pngcrush version 1.8.0, -reduce is on by default, and you can disable it with -noreduce.
  
        -rem chunkname (or "alla" or "allb")
  
               Name of an ancillary chunk or optional PLTE to be removed.  Be careful with this.  Don't use this feature to remove transparency, gamma, copyright, or other valuable information.  To remove several different chunks, repeat: -rem tEXt -rem pHYs.  Known chunks (those in the PNG 1.1 spec or extensions doc‐
               ument) can be named with all lower-case letters, so "-rem bkgd" is equivalent to "-rem bKGD".  But note: "-rem text" removes all forms of text chunks; Exact case is required to remove unknown chunks.  To do surgery with a chain-saw, "-rem alla" removes all known ancillary chunks  except  for  tRNS,  and
               "-rem allb" removes all but tRNS and gAMA.
”

See the attachment, too. As you see, the formatting is garbage. E.g., “-ow” starts too far on the right and should be moved left and left-align with “-oldtimestamp”. The description of “-reduce” should be vertically compacted into a single para and moved to the right. Please fix this.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: manpage_overwrite_reduce.png
Type: image/png
Size: 6865 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/pkg-phototools-devel/attachments/20260604/f7926c17/attachment-0001.png>


More information about the Pkg-phototools-devel mailing list