bump year
[clawsker.git] / clawsker.pod
1 #
2 # Clawsker manual page
3 # $Id$
4 #
5 =pod
6
7 =head1 NAME
8
9 Clawsker - A Claws Mail Tweaker
10
11 =head1 SYNOPSIS
12
13 clawsker [options]
14
15 =head1 DESCRIPTION
16
17 Clawsker is an applet to edit the so called Claws Mail hidden preferences.
18
19 Claws Mail is a fast, lightweight and feature-rich MUA with a high number 
20 of configurable options. To keep the binary small and fast some of these 
21 preferences which are not widely used are not provided with a graphical
22 interface for inspection and/or modification.
23
24 Users wanting to edit such preferences had to face raw editing of their 
25 configuration files, now you can do it with a convenient GTK2 interface
26 using Clawsker.
27
28 =head1 OPTIONS
29
30 --help
31         Shows a brief help screen.
32
33 --version
34         Show information about program, Claws Mail and Perl-GTK versions.
35
36 --verbose
37         Tells more on the standard output.
38
39 --alternate-config-dir <dir>
40         Uses <dir> as Claws Mail configuration dir.
41
42 --clawsrc <file>
43         Uses <file> as Claws Mail resource configuration file. This sets
44         the full file name overriding any previous setting.
45
46 Multiple options are allowed, although only the last one has effect. Weird
47 option specifications may produce weird results (but otherwise correct).
48         
49 =head1 LIMITATIONS
50
51 A running Claws Mail cannot be detected if using the --clawsrc option because
52 the directory is not assumed to be a Claws Mail configuration dir. If that is 
53 the case use the --alternate-config-dir option instead.
54
55 =head1 SEE ALSO
56
57 Clawsker homepage "L<http://www.claws-mail.org/clawsker>"
58
59 =head1 AUTHOR
60
61 Main author is Ricardo Mones E<lt>ricardo@mones.orgE<gt> with the help of
62 others. See the AUTHORS file on source tarball for a detailed list of 
63 contributors.
64
65 =head1 LICENSE
66
67 Copyright (c) 2007-2010 by Ricardo Mones Lastra
68
69 This program is free software: you can redistribute it and/or modify
70 it under the terms of the GNU General Public License as published by
71 the Free Software Foundation, either version 3 of the License, or
72 (at your option) any later version.
73
74 This program is distributed in the hope that it will be useful,
75 but WITHOUT ANY WARRANTY; without even the implied warranty of
76 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
77 GNU General Public License for more details.
78
79 You should have received a copy of the GNU General Public License
80 along with this program.  If not, see E<lt>http://www.gnu.org/licenses/E<gt>.
81
82 =cut
83