updated documentation

This commit is contained in:
Sascha Kruse 2011-09-09 00:28:21 +02:00
parent 3e5bf33b59
commit d9527bd949
3 changed files with 40 additions and 12 deletions

40
README
View File

@ -2,12 +2,15 @@ NAME
dunst - dmenu-ish universal notification system
SYNOPSIS
dunst [-b] [-ne l/r] [-fn font] [-nb color] [-nf color] [-to secs]
dunst [-b] [-ne l/r] [-fn font] [-nb color] [-nf color] [-to secs]
[-key key] [-mod modifier]
DESCRIPTION
dunst is a lightweight notification-daemon for the libnotify. It can also be used as a standalone notification
system. Dnotify displays messages received via dbus or as commandline argument in a fashion similar to dmenu
and additionally prints them to stdout. Notifications can be closed via mouseclick.
dunst is a lightweight notification-daemon for the libnotify. It can
also be used as a standalone notification system. Dnotify displays mes
sages received via dbus or as commandline argument in a fashion similar
to dmenu and additionally prints them to stdout. Notifications can be
closed via mouseclick.
OPTIONS
-h/--help
@ -16,33 +19,48 @@ OPTIONS
-b dunst appears at the bottom of the screen.
-ne l/r
Don't expand popup across the screen and put it in the [l]eft or [r]ight edge
Don't expand popup across the screen and put it in the [l]eft or
[r]ight edge
-fn/ font
defines the font or font set used.
-nb/-bg color
defines the background color. #RGB, #RRGGBB and X color names are supported.
defines the background color. #RGB, #RRGGBB and X color names
are supported.
-nf/-fg color
defines the background color.
-msg msg
display msg instead of listening to notifications. This option can be used multiple times.
display msg instead of listening to notifications. This option
can be used multiple times.
-to secs
display each message for secs seconds.
-key key
close window by pressing key [a,b,space,Return etc.] (should be
used in combination with -mod).
-mod modifier
defines the modifier for the key. Available modifiers are:
ctrl,shift,mod1 (usually the alt-key),mod2,mod3,mod4 (usually
windows key). This option can be used multiple times to combine
modifiers.
AUTHOR
written by Sascha Kruse <knopwob@googlemail.com>
COPYRIGHT
Parts of the code are taken from dmenu (especially draw.c and draw.h). Read LICENCE.dmenu and look at
http://tools.suckless.org/dmenu.
Parts of the code are taken from dmenu (especially draw.c and draw.h).
Read LICENCE.dmenu and look at http://tools.suckless.org/dmenu.
Some snippets in dunst_dbus.c are taken from twmn. See http://github.com/sboli/twmn.
Some snippets in dunst_dbus.c are taken from twmn. See
http://github.com/sboli/twmn.
If you feel that copyrights are violated, please send me an e-mail to knopwob@googlemail.com.
If you feel that copyrights are violated, please send me an e-mail to
knopwob@googlemail.com.
SEE also
dwm(1), dmenu(1), twmn(1), notify-send(1)

10
dunst.1
View File

@ -14,6 +14,10 @@ dunst \- dmenu\-ish universal notification system
.IR color ]
.RB [ \-to
.IR secs ]
.RB [ \- key
.IR key ]
.RB [ \- mod
.IR modifier ]
.P
.SH DESCRIPTION
.B dunst
@ -43,6 +47,12 @@ display msg instead of listening to notifications. This option can be used multi
.TP
.BI \-to " secs"
display each message for secs seconds.
.TP
.BI \-key " key"
close window by pressing key [a,b,space,Return etc.] (should be used in combination with -mod).
.TP
.BI \-mod " modifier"
defines the modifier for the key. Available modifiers are: ctrl,shift,mod1 (usually the alt-key),mod2,mod3,mod4 (usually windows key). This option can be used multiple times to combine modifiers.
.SH AUTHOR
written by Sascha Kruse <knopwob@googlemail.com>
.SH COPYRIGHT

View File

@ -378,6 +378,6 @@ main(int argc, char *argv[]) {
void
usage(int exit_status) {
fputs("usage: dunst [-h/--help] [-b] [-ne l/r] [-fn font]\n[-nb/-bg color] [-nf/-fg color] [-to secs] [-msg msg]\n", stderr);
fputs("usage: dunst [-h/--help] [-b] [-ne l/r] [-fn font]\n[-nb/-bg color] [-nf/-fg color] [-to secs] [-key key] [-mod modifier] [-msg msg]\n", stderr);
exit(exit_status);
}