Package: libnotify-bin Version: 0.3.2-2 Severity: minor Tags: patch Hi,
I was looking at the man-page of notify-send and I found some points of improvement: - There is no short description (useful for `whatis'). - The options are listed twice. - The options were listed in the Description section instead of the Options section. - The Description section didn't contain any description. - The See Also section was referring to info files, but there are none (AFAIK). - The See Also section could refer to the spec mentioned in the deb description of libnotify-bin. - The Author section was missing. I have attached a patch solving almost all these problems except that I do not know who wrote/made the original man-page so I couldn't include that in the Author section body. Regards, Paul -- System Information: Debian Release: testing/unstable APT prefers unstable APT policy: (500, 'unstable'), (102, 'experimental') Architecture: powerpc (ppc) Shell: /bin/sh linked to /bin/dash Kernel: Linux 2.6.15-1-powerpc Locale: LANG=C, LC_CTYPE=nl_NL.UTF8 (charmap=UTF-8) Versions of packages libnotify-bin depends on: ii libc6 2.3.6-1 GNU C Library: Shared libraries an ii libglib2.0-0 2.8.6-1 The GLib library of C routines ii libnotify1 0.3.2-2 sends desktop notifications to a n ii libpopt0 1.7-5 lib for parsing cmdline parameters ii libxcursor1 1.1.3-1 X cursor management library libnotify-bin recommends no packages. -- no debconf information
--- debian/notify-send.1.old 2006-02-20 08:41:45.000000000 +0000 +++ debian/notify-send.1 2006-02-20 08:58:17.000000000 +0000 @@ -1,34 +1,15 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. .TH USAGE: "1" "November 2005" "notify-send 0.2.2" "User Commands" .SH NAME -notify-send +notify-send - a program to send desktop notifications .SH SYNOPSIS .B notify-send -[\fIOPTIONS\fR]\fI* <summary> \fR[\fIbody\fR] +[\fIOPTIONS\fR]\fI <summary> \fR[\fIbody\fR] .SH DESCRIPTION -.TP -\fB\-u\fR, \fB\-\-urgency\fR=\fISTRING\fR -Specifies the urgency level (low, normal, -critical). -.TP -\fB\-t\fR, \fB\-\-expire\-time\fR=\fIINT\fR -Specifies the timeout in seconds at which to -expire the notification. -.TP -\fB\-i\fR, \fB\-\-icon\fR=\fIICON1\fR,ICON2,... -Specifies an icon filename or stock icon to -display. -.TP -\fB\-t\fR, \fB\-\-type\fR=\fIICON1\fR,ICON2,... -Specifies the notification type. -.SS "Help options:" -.TP -\-?, \fB\-\-help\fR -Show this help message -.TP -\fB\-\-usage\fR -Display brief usage message -.TP +With \fInotify-send\fR you can sends desktop notifications to the user via +a notification daemon from the command line. These notifications can be +used to inform the user about an event or display some form of information +without getting in the user's way. +.SH OPTIONS \fB\-u\fR, \fB\-\-urgency\fR=\fISTRING\fR Specifies the urgency level (low, normal, critical). @@ -50,15 +31,8 @@ .TP \fB\-\-usage\fR Display brief usage message -.SH "SEE ALSO" -The full documentation for -.B Usage: -is maintained as a Texinfo manual. If the -.B info -and -.B Usage: -programs are properly installed at your site, the command -.IP -.B info Usage: -.PP -should give you access to the complete manual. +.SH SEE ALSO +The Desktop Notification Spec on http://www.galago-project.org/specs/notification/. +.SH AUTHOR +This manual page was written by ???? <????> +for the Debian project (but may be used by others).