Bug#869277: /usr/bin/notify-send: Improve the manpage

[Jason Crain]

On Sat, Jul 22, 2017 at 04:37:37PM +0200, c.buhtz at posteo.jp wrote:
> On 2017-07-22 07:19 Jason Crain <jason at inspiresomeone.us> wrote:
> > On Sat, Jul 22, 2017 at 01:52:49PM +0200, Christian Buhtz wrote:
> > > I tried to contribute but can not find the sources of the manpage
> > > (for notify- send) somewhere.  
> > 
> > The manpage is Debian-specific so it's in Debian's pkg-gnome SVN:
> > https://anonscm.debian.org/viewvc/pkg-gnome/desktop/unstable/libnotify/debian/
> 
> Thanks for the hint. So upstream doesn't offer a manpage?
> 
> Sorry but IMO it is wasting ressource when contributing to
> distro-specific sources. When upstream would over a manpage I would
> contribute to it.
> 
> Can you describe the packaging process please? Isn't there a check
> if the binary features fit to the manpage and other docs? I would
> totally understand if this would be to much work.

There are several documents you can read if you want to learn about the
packaging process.  See https://www.debian.org/doc/, especially the
Debian Policy Manual, Debian Developer's Reference, and Debian New
Maintainers' Guide in the Developers' manuals section.

I don't see anything wrong with the manpage though as you say it could
be more detailed.

> I know I am quite radical here: I would suggest to kill the debian
> specific manpage, put enough pressure on upstream to offer its own
> manpage. If not kill the complete package because of Debian-quality.

It is of course preferable for these things to be upstreamed but that
sometimes doesn't happen.  Feel free to contact upstream and request
they package the manpage.  You can start with upstream's bug report:
https://bugzilla.gnome.org/757151.