File: melon.1

package info (click to toggle)
melon 1.4-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 956 kB
  • ctags: 158
  • sloc: ansic: 2,427; makefile: 91; sh: 58
file content (128 lines) | stat: -rw-r--r-- 3,319 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH MELON 1 "Mrz 21, 2002"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
melon \- configurable email notifier, xbiff replacement
.SH SYNOPSIS
.B melon
.RI [ command ]
.RI [ options ]
.SH DESCRIPTION
.B Melon
is a simple utility that notifies user for newly received emails,
through a nice couple of configurable icons. In short, it is an
.B xbiff
replacement.
.PP
When a mailbox has received new emails, the icon changes and an
acoustic warning is played.  It supports multiple mailboxes handling,
acoustic warnings or execution of external application on request.
Since
.BR Melon 's
check is based on the change time of a file, you can
monitor every kind of files with it, not just mailboxes.
.PP
.B Melon
is also able to check normal mailboxes. Then, the status flag of each
message is check.
.SH COMMANDS
The following
.RI commands
are supported.
.TP
.B open
.B Melon
executes the program defined as mailer command in the
.B Melon
configuration
.TP
.B reset
Currently running process rereads configuration file and all mailboxes are
reset to inactive.
.TP
.B stop
Stops
.BR Melon .
.SH OPTIONS
The following command line options are supported.
.IP -v
Shows version and paths.
.IP -h
Prints a short help.
.IP -p
Normally, melon saves its pid on the file 
.I ~/.melon/melon.pid
at start time. In this way, you are able to perform some action   
using a preexistent melon instance (see "Control Commands" for 
more information). The 
.B -p
switch allows multiple instances of  
melon to be executed simultaneously, loosing however the use of
control commands.
.IP "-g, -geometry"
Give the coordinates of the melon icon in the standard X way:
.IP
melon -g -0-0
.IP
to get
.B Melon
at the bottom right corner of the screen or
.IP
melon -g -0+0
.IP
to get it at the top right corner of the screen.
.SH FILES
.I ~/.melon/melon.pid
.RS
Contains the process ID of the currently running
.BR Melon .
.RE
.I ~/.melon/melon.cfg
.RS
Configuration file of
.BR Melon .
.RE
.I /usr/share/melon/au
.RS
Audio root.
.RE
.I /usr/share/melon/voc
.RS
Audio root.
.RE
.I /usr/share/melon/pix
.RS
Pixmap root.
.RE
.SH BUGS
Be aware that the current release of
.B Melon
only supports one running task at the time. The PID of a running task
is usually stored in 
.I .melon/melon.pid
in the users home directory.
.B Melon
cannot be started if this file exists. If
.B Melon
is shutdown cleanly, it removes this file. The switch
.B -p
overrides this behaviour but has the drawback that the commands do no longer
work.
.SH AUTHOR
This manual page was written by Philipp Frauenfelder <pfrauenf@debian.org>,
for the Debian GNU/Linux system (but may be used by others) because
the original program does not have a manual page.