Bug#733996: closure-compiler: Install a useful manpage for ‘closure-compiler’ command

[Ben Finney]

Package: src:closure-compiler
Version: 20130227+dfsg1-4
Severity: important


On 04-Jan-2014, tony mancill wrote:

> There isn't currently a manpage - the documentation I've seen regarding
> using it refers to invoking it as a jar file (see [0], and more generally
> [1]). Given that all of the upstream documentation is focused on invoking
> it as a jar file, I think we're on our here, at least at the start.

That's a familiar position for Debian package maintainers, yes.

I am reporting (with this message) a new bug for the missing
‘closure-compiler(1)’ manpage, per Debian policy §12.1:

     Each program, utility, and function should have an associated manual
     page included in the same package.  It is suggested that all
     configuration files also have a manual page included as well.  Manual
     pages for protocols and other auxiliary things are optional.

     If no manual page is available, this is considered as a bug and should
     be reported to the Debian Bug Tracking System (the maintainer of the
     package is allowed to write this bug report themselves, if they so
     desire).  Do not close the bug report until a proper man page is
     available.

> I agree that the package should have a manpage if we're going to continue
> to provide the /usr/bin/ symlink.

Right, and I think the ‘/usr/bin/closure-compiler’ command is very much
desirable (to allow using that command without needing to care about the
implementation). So I think adding a manpage is necessary.

> Daniel added this in the -3 upload. If you or Daniel can contribute a
> manpage, that would be great.

I will work on a suitable manpage and submit it to the bug report for this.

-- 
 \       “My aunt gave me a walkie-talkie for my birthday. She says if |
  `\        I'm good, she'll give me the other one next year.” —Steven |
_o__)                                                           Wright |
Ben Finney <ben at benfinney.id.au>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-java-maintainers/attachments/20140105/fdcfbcdd/attachment-0002.sig>