[Pkg-javascript-devel] Bug#847642: ‘uglifyjs?=(1)=?UTF-8?Q?’ manual page has sections with incorrect content

[Ben Finney]

Control: reopen -1

> The command ‘uglifyjs’ has a manual page ‘uglifyjs(1)’ that does not
> helpfully describe the command:
> 
>     NAME
>            uglify-js - manual page for uglify-js 2.7.5

This is still the case; the manual page (now for version 2.8.29) does
not contain a useful ‘NAME’ section. The ‘DESCRIPTION’ section also
does not contain the command description.

    NAME
           uglify-js - manual page for uglify-js 2.8.29

    DESCRIPTION
           bin/uglifyjs input1.js [input2.js ...] [options] Use a single
           dash to read input from the standard input.

           NOTE: by default there is no mangling/compression. […]

The summary of options belongs not in the ‘DESCRIPTION’ section, but
in the ‘SYNOPSIS’ section. This frees the ‘DESCRIPTION’ section to
properly describe the behaviour of the command for a new user.

I am re-opening this bug report, with the original request unresolved:

> The manual page should have the sections described ‘man-pages(7)’ §
> “Sections within a manual page”, with the content as described in that
> document.

-- 
 \      “[Entrenched media corporations will] maintain the status quo, |
  `\       or die trying. Either is better than actually WORKING for a |
_o__)                  living.” —ringsnake.livejournal.com, 2007-11-12 |
Ben Finney <bignose at debian.org>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/pkg-javascript-devel/attachments/20181210/9ada6a72/attachment.sig>