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

[Pablo A B]

Now not even that link works. Galago Project doesn't exist anymore.
Last archive.org snapshot:
https://web.archive.org/web/20220422104829/https://www.galago-project.org/specs/notification/
Maybe should be replaced with
https://specifications.freedesktop.org/notification-spec/notification-spec-latest.html
as mention 
[here](https://gitlab.gnome.org/GNOME/libnotify/-/blob/master/README.md)

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

[c . buhtz]

Upstream moved its BugTracker

Here are the new links to two of the related Issues in upstream

https://gitlab.gnome.org/GNOME/libnotify/-/issues/24

https://gitlab.gnome.org/GNOME/libnotify/-/issues/23

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

[c.buhtz]

Related to

 - "libnotify-bin: add informations about upstream"
   https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=869409

 - "libnotify-bin: option -a is not described in notify-send man page"
   https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=756151

 - "Missing man page for notify-send"
   https://bugzilla.gnome.org/show_bug.cgi?id=757151

 - "add valuable informations to README"
   https://bugzilla.gnome.org/show_bug.cgi?id=785286

Just to be clear: IMO a Debian maintainer shouldn't waste it's time
with pimp up the bad documentation of some projects. It is up to
upstream!

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

[Jason Crain]

On Sat, Jul 22, 2017 at 04:37:37PM +0200, c.bu...@posteo.jp wrote:
> On 2017-07-22 07:19 Jason Crain  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.

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

[c.buhtz]

On 2017-07-22 07:19 Jason Crain  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.

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.

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

[Jason Crain]

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/

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

[Christian Buhtz]

Package: libnotify-bin
Version: 0.7.7-2
Severity: normal
File: /usr/bin/notify-send

Dear Maintainer,

please let the manpage be improved.

There should be informations about the options '--category' and '--hints'. The
possible values and there effect should be described in the manpage.

I link to http://www.galago-project.org/specs/notification is nice but not
enough and under the quality of Debian packages.

kind



-- System Information:
Debian Release: buster/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.11.9-towo.1-siduction-amd64 (SMP w/4 CPU cores; PREEMPT)
Locale: LANG=de_DE.utf8, LC_CTYPE=de_DE.utf8 (charmap=UTF-8), 
LANGUAGE=de_DE.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages libnotify-bin depends on:
ii  libc6 2.24-12
ii  libglib2.0-0  2.52.3-1
ii  libnotify40.7.7-2

libnotify-bin recommends no packages.

libnotify-bin suggests no packages.

-- no debconf information