1 .TH "CLAWS MAIL" "1" "November 1, 2011" "The Claws Mail team" "User Manuals"
5 Claws Mail \- a GTK+ based fast email and news client
13 Claws Mail is an email client (and news reader) based on GTK+, running on the X Window System, and aiming for:
17 * Graceful, and sophisticated interface
19 * Easy configuration, intuitive operation
24 Currently implemented features include:
29 o integrated NetNews client
31 o unlimited multiple account handling
39 o built\-in image view
41 o X\-Face and (colour) Face support
43 o multiple MH folder support
45 o mbox importing / exporting
47 o external editor support
51 o automatic mail checking
53 o draft message function
61 o XML\-based address book
63 o LDAP, vCard, and JPilot support
65 o newly arrived and unread message management
67 o Mew/Wanderlust\-like key bind
71 o APOP authentication support
75 o SSL support (POP3, SMTP, IMAP4rev1)
79 o drag & drop (partially implemented)
83 o automake + autoconf support
85 o internationalization of messages by gettext
87 o support of many code sets, including UTF\-8 (Unicode) (when using libjconv)
92 This list is not complete.
96 \fB \-\-compose\fR [address]
98 \fB \-\-compose\-from\-file\fR file
100 \fB \-\-subscribe\fR [uri]
102 \fB \-\-attach file1 [file2]...\fR
106 \fB \-\-receive\-all\fR
112 \fB \-\-status folder[/subfolder]\fR
114 \fB \-\-status\-full\fR
116 \fB \-\-statistics\fR
118 \fB \-\-reset-statistics\fR
120 \fB \-\-select [#mh/mailbox/]folder[/msg|/msgid]\fR
134 \fB \-\-version\-full\fR
136 \fB \-\-config\-dir\fR
138 \fB \-\-alternate\-config\-dir [dir]\fR
144 Default directory for mail storage
146 $PREFIX/share/claws\-mail
147 Global program directory
149 $PREFIX/share/claws\-mail/manual
150 Manual files in HTML, PDF, PostScript and plain text format
152 $PREFIX/share/claws\-mail/themes
153 Global themes directory
155 $PREFIX/lib/claws\-mail/plugins
156 Directory for plugins
158 $PREFIX/include/claws\-mail
159 Directory for header files
162 Default directory for user's configuration files directory
164 $HOME/.claws\-mail/addrbook/*
167 $HOME/.claws\-mail/autofaces/*
168 Automatic Faces and X\-Faces files for accounts
170 $HOME/.claws\-mail/certs/*
171 SSL certificates received from mail servers
173 $HOME/.claws\-mail/templates
174 User\-defined templates directory
176 $HOME/.claws\-mail/themes
177 User's themes directory
179 $HOME/.claws\-mail/accountrc
180 Configuration for account(s)
182 $HOME/.claws\-mail/actionsrc
183 User\-defined custom actions
185 $HOME/.claws\-mail/addressbookcustomattributerc
186 User\-defined address book custom attributes
188 $HOME/.claws\-mail/claws.log
191 $HOME/.claws\-mail/claws-win32.log
192 Claws Mail output file (Windows only)
194 $HOME/.claws\-mail/clawsrc
195 Main configuration file
197 $HOME/.claws\-mail/command_history
198 User\-specified commands
200 $HOME/.claws\-mail/customheaderrc
201 Configuration for custom headers for sending mail
203 $HOME/.claws\-mail/dispheaderrc
204 Configuration for custom display of headers in message view
206 $HOME/.claws\-mail/extraheaderrc
207 Editable extra headers to be added to compose window combobox
209 $HOME/.claws\-mail/folderitemrc
210 All folders' attributes
212 $HOME/.claws\-mail/folderlist.xml
213 Folder hierarchy listing
215 $HOME/.claws\-mail/matcherrc
216 Filtering and Processing function configuration
218 $HOME/.claws\-mail/menurc
219 Menu shortcut\-key configuration
221 $HOME/.claws\-mail/messagesearch_history
222 User\-specified searches in message bodies
224 $HOME/.claws\-mail/quicksearch_history
225 User\-specified quick\-search list
227 $HOME/.claws\-mail/messagesearch_history
228 User\-specified searches in message bodies
230 $HOME/.claws\-mail/summary*_history
231 User\-specified searches in message list
233 $HOME/.claws\-mail/tagsrc
234 User\-specified tag list
236 $HOME/.claws\-mail/toolbar*.xml
237 User\-defined custom toolbars
241 To run this program the standard way type:
245 Alternatively you can run it with the following options:
247 \fB\-\-compose [address]\fR
248 to open a Compose window
250 \fB\-\-compose\-from\-file file
251 open composition window with data from given file. Use \- as file name
252 for reading from standard input. Content format: headers first (To:
253 header required) until an empty line is found, then mail body until
256 \fB\-\-subscribe [uri]\fR
257 subscribe to the given URI if possible
259 \fB\-\-attach file1 [file2]...\fR
260 open composition window with specified files attached
262 \fB\-\-compose\fR "mailto:\fI%t\fR?subject=\fI%s\fR&cc=\fI%c\fR&body=\fI%b\fR"
263 this syntax can be used in web\-browsers and CLI to open a pre\-populated Compose window.
264 Possible fields after the destination recipient are: subject, from, cc, bcc, in\-reply\-to,
265 body, insert (insert a file in body part, needs an absolute path), attach (attach a file,
266 needs an absolute path, see also: \-\-attach)
271 \fB\-\-receive\-all\fR
272 receive new messages from all accounts
276 send all queued messages
279 show the total number of messages
281 [new][unread][unread answers to marked][total]
283 \fB\-\-status folder[/subfolder]\fR
284 show the total number of messages in specified folder
286 [new][unread][unread answers to marked][total]
288 \fB\-\-status\-full\fR
289 show the total number of messages per folder
291 [new][unread][unread answers to marked][total]
295 show session statistics
297 \fB\-\-reset-statistics\fR
299 reset session statistics
301 \fB\-\-select [#mh/mailbox/]folder[/msg|/msgid]\fR
302 on startup, jumps to the specified folder/message
305 start Claws Mail in (or switch to, if already running) online mode
308 start Claws Mail in (or switch to, if already running) offline mode
311 display the help message and exit
320 display version number and exit
322 \fB\-\-version\-full\fR
323 display version number and compiled\-in features then exit
325 \fB\-\-config\-dir\fR
326 display the CONFIG\-DIR and exit
328 \fB\-\-alternate\-config\-dir [dir]\fR
329 start Claws Mail with the configuration stored in [dir] directory
339 locale to use for non-win32 systems (the first one not empty is used)
342 use this CA certificates file instead of searching known system files
345 use this CA certificates directory instead known system directories
347 \fBPOSIXLY_CORRECT\fR
348 if defined regular expressions matching follows POSIX standards
351 full path of the user's home directory
354 if defined disables crash dialog (only if Claws Mail has been built with
355 crash dialog feature enabled)
357 \fBG_BROKEN_FILENAMES\fR
358 assumes that filenames are in the locale encoding rather than in UTF-8
361 if defined overrides default J-Pilot charset (CP1252)
363 \fBSESSION_MANAGER\fR
364 if defined tries to use the Session Manager (only if Claws Mail has been
365 built with libSM feature enabled)
368 default host and display number to use
371 the information to access the GPG agent if using GPG agent is enabled in
372 GPG plugin preferences (this is usually set by the agent when launched,
373 otherwise it likely means the GPG agent is not running)
376 if defined overrides default shell "sh" used by Spamassassin plugin to
377 launch spamc wrappers
382 You can search for existing bugs and report new ones on Claws Mail bugzilla:
384 <http://www.thewildbeast.co.uk/claws-mail/bugzilla/>
389 1999-2011 Hiroyuki Yamamoto and the Claws Mail team
395 Holger Berndt <berndth@users.sf.net>
397 Tristan Chabredier <wwp@claws\-mail.org>
399 Ho\(`a Vi\(^et Dinh <hoa@users.sf.net>
401 Andrej Kacian <andrej@kacian.sk>
403 Darko Koruga <darko@users.sf.net>
405 Ricardo Mones Lastra <ricardo@mones.org>
407 Colin Leroy <colin@colino.net>
409 Paul Mangan <paul@claws\-mail.org>
411 Salvatore De Paolis <iwkse@claws\-mail.org>
414 Previous team members
431 Leandro A. F. Pereira
449 <http://www.claws\-mail.org>
451 Claws Mail online manual
452 <http://www.claws\-mail.org/manual>
455 <http://www.claws\-mail.org/plugins.php>