File: claws-mail.1

package info (click to toggle)
claws-mail 3.14.1-3
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 44,732 kB
  • sloc: ansic: 273,079; xml: 13,055; sh: 5,372; perl: 3,533; makefile: 3,528; yacc: 2,654; lex: 455; python: 334
file content (556 lines) | stat: -rw-r--r-- 12,832 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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
.TH "CLAWS MAIL" "1" "August 5, 2016" "The Claws Mail team" "User Manuals"

.SH "NAME"
.LP 
claws\-mail \- a GTK+ based fast email and news client

.SH "SYNOPSIS"
.B claws\-mail
.RI [ options ]

.SH "DESCRIPTION"
.TP 
Claws Mail is an email client (and news reader) based on GTK+, running on the X Window System, and aiming for:
.br 
\[bu] Quick response
.br 
\[bu] Graceful, and sophisticated interface
.br 
\[bu] Easy configuration, intuitive operation
.br 
\[bu] Abundant features
\fR
.TP 
Currently implemented features include:
\[bu] POP3 support
.br 
\[bu] IMAP4rev1 support
.br 
\[bu] integrated NetNews client
.br 
\[bu] unlimited multiple account handling
.br 
\[bu] thread display
.br 
\[bu] filtering
.br 
\[bu] MIME (attachments)
.br 
\[bu] built\-in image view
.br 
\[bu] X\-Face and (colour) Face support
.br 
\[bu] multiple MH folder support
.br 
\[bu] mbox importing / exporting
.br 
\[bu] external editor support
.br 
\[bu] message queueing
.br 
\[bu] automatic mail checking
.br 
\[bu] draft message function
.br 
\[bu] template function
.br 
\[bu] line\-wrapping
.br 
\[bu] clickable URI
.br 
\[bu] XML\-based address book
.br 
\[bu] LDAP, vCard, and JPilot support
.br 
\[bu] newly arrived and unread message management
.br 
\[bu] Mew/Wanderlust\-like key bind
.br 
\[bu] printing
.br 
\[bu] APOP authentication support
.br 
\[bu] SMTP AUTH support
.br 
\[bu] SSL support (POP3, SMTP, IMAP4rev1)
.br 
\[bu] IPv6 support
.br 
\[bu] drag & drop (partially implemented)
.br 
\[bu] GnuPG support
.br 
\[bu] automake + autoconf support
.br 
\[bu] internationalization of UI messages by gettext
.br 
\[bu] support of many code sets, including UTF\-8 (Unicode) (when using libjconv)
.br 
\[bu] support for plugins
\fR
.LP 
This list is not complete.

.SH "OPTIONS"
.LP 
\fB \-\-compose\fR [address]
.br 
\fB \-\-compose\-from\-file\fR file
.br 
\fB \-\-subscribe\fR [uri]
.br 
\fB \-\-attach file1 [file2]...\fR
.br 
\fB \-\-receive\fR
.br 
\fB \-\-receive\-all\fR
.br 
\fB \-\-cancel\-receiving\fR
.br 
\fB \-\-cancel\-sending\fR
.br 
\fB \-\-send\fR
.br 
\fB \-\-status\fR
.br 
\fB \-\-status folder[/subfolder]\fR
.br 
\fB \-\-status\-full\fR
.br 
\fB \-\-statistics\fR
.br 
\fB \-\-reset-statistics\fR
.br 
\fB \-\-select [#mh/mailbox/]folder[/msg|/msgid]\fR
.br 
\fB \-\-online\fR
.br 
\fB \-\-offline\fR
.br 
\fB \-\-exit\fR
.br 
\fB \-\-debug\fR
.br 
\fB \-\-toggle\-debug\fR
.br 
\fB \-\-help\fR
.br 
\fB \-\-version\fR
.br 
\fB \-\-version\-full\fR
.br 
\fB \-\-config\-dir\fR
.br
\fB \-\-alternate\-config\-dir [dir]\fR
.br
\fB \-\-geometry WxH+X+Y\fR

.SH "FILES"
.LP 
.TP 
$HOME/Mail
Default directory for mail storage
.TP 
$PREFIX/share/claws\-mail
Global program directory
.TP 
$PREFIX/share/claws\-mail/manual
Manual files in HTML, PDF, PostScript and plain text format
.TP 
$PREFIX/share/claws\-mail/themes
Global themes directory
.TP 
$PREFIX/lib/claws\-mail/plugins
Directory for plugins
.TP 
$PREFIX/include/claws\-mail
Directory for header files
.TP 
$HOME/.claws\-mail
Default directory for user's configuration files directory
.TP 
$HOME/.claws\-mail/addrbook/*
Addressbook files
.TP 
$HOME/.claws\-mail/autofaces/*
Automatic Faces and X\-Faces files for accounts
.TP 
$HOME/.claws\-mail/certs/*
SSL certificates received from mail servers
.TP 
$HOME/.claws\-mail/tagsdb
Tags directory
.TP 
$HOME/.claws\-mail/templates
User\-defined templates directory
.TP 
$HOME/.claws\-mail/themes
User's themes directory
.TP 
$HOME/.claws\-mail/accountrc
Configuration for account(s)
.TP 
$HOME/.claws\-mail/actionsrc
User\-defined custom actions
.TP 
$HOME/.claws\-mail/addressbookcustomattributerc
User\-defined address book custom attributes
.TP 
$HOME/.claws\-mail/claws.log
Claws Mail logfile
.TP 
$HOME/.claws\-mail/clawsrc
Main configuration file
.TP 
$HOME/.claws\-mail/command_history
User\-specified commands
.TP 
$HOME/.claws\-mail/customheaderrc
Configuration for custom headers for sending mail
.TP 
$HOME/.claws\-mail/dispheaderrc
Configuration for custom display of headers in message view
.TP
$HOME/.claws\-mail/extraheaderrc
Editable extra headers to be added to compose window combobox
.TP 
$HOME/.claws\-mail/folderitemrc
All folders' attributes
.TP 
$HOME/.claws\-mail/folderlist.xml
Folder hierarchy listing
.TP 
$HOME/.claws\-mail/matcherrc
Filtering and Processing function configuration
.TP 
$HOME/.claws\-mail/menurc
Menu shortcut\-key configuration
.TP 
$HOME/.claws\-mail/messagesearch_history
User\-specified searches in message bodies
.TP 
$HOME/.claws\-mail/quicksearch_history
User\-specified quick\-search list
.TP 
$HOME/.claws\-mail/messagesearch_history
User\-specified searches in message bodies
.TP 
$HOME/.claws\-mail/summary*_history
User\-specified searches in message list
.TP 
$HOME/.claws\-mail/passwordstorerc
User saved passwords
.TP
$HOME/.claws\-mail/tagsrc
User\-specified tag list
.TP 
$HOME/.claws\-mail/toolbar*.xml
User\-defined custom toolbars
.TP
.B "Windows only"
.LP
.TP
%TEMP%\\claws\-win32.log
Claws Mail output file when \-\-debug is enabled. If %TEMP% is not set it
defaults to windows directory (usually C:\\Windows) or C:\\ if windows
directory is not available.
.TP
%APPDATA%\\Claws\-mail\\claws.log
Claws Mail log file

.SH "EXAMPLES"
.LP 
To run this program the standard way type:
.LP 
claws\-mail
.LP 
Alternatively you can run it with the following options:
.TP 
\fB\-\-compose [address]\fR 
to open a Compose window
.TP
\fB\-\-compose\-from\-file file
open composition window with data from given file. Use \- as file name
for reading from standard input. Content format: headers first (To: 
header required) until an empty line is found, then mail body until
end of file.
.TP 
\fB\-\-subscribe [uri]\fR
subscribe to the given URI if possible
.TP 
\fB\-\-attach file1 [file2]...\fR
open composition window with specified files attached
.TP 
\fB\-\-compose\fR "mailto:\fI%t\fR?subject=\fI%s\fR&cc=\fI%c\fR&body=\fI%b\fR"
this syntax can be used in web\-browsers and CLI to open a pre\-populated Compose window.
Possible fields after the destination recipient are: subject, from, cc, bcc, in\-reply\-to,
body, insert (insert a file in body part, needs an absolute path), attach (attach a file,
needs an absolute path, see also: \-\-attach)
.TP 
\fB\-\-receive\fR
receive new messages
.TP 
\fB\-\-receive\-all\fR
receive new messages from all accounts
.TP 
\fB\-\-cancel\-receiving\fR
cancel receiving of messages
.TP 
\fB\-\-cancel\-sending\fR
cancel sending of messages
.TP 
\fB\-\-send\fR
.br 
send all queued messages
.TP 
\fB\-\-status\fR
show the total number of messages
.br 
[new][unread][unread answers to marked][total]
.TP 
\fB\-\-status folder[/subfolder]\fR
show the total number of messages in specified folder
.br 
[new][unread][unread answers to marked][total]
.TP 
\fB\-\-status\-full\fR
show the total number of messages per folder
.br 
[new][unread][unread answers to marked][total]
.TP 
\fB\-\-statistics\fR
.br 
show session statistics
.TP 
\fB\-\-reset-statistics\fR
.br 
reset session statistics
.TP 
\fB\-\-select [#mh/mailbox/]folder[/msg|/msgid]\fR
on startup, jumps to the specified folder/message
.TP 
\fB\-\-online\fR
start Claws Mail in (or switch to, if already running) online mode
.TP 
\fB\-\-offline\fR
start Claws Mail in (or switch to, if already running) offline mode
.TP 
\fB\-\-help\fR
display the help message and exit
.TP 
\fB\-\-exit\fR
exit Claws Mail
.TP 
\fB\-\-debug\fR
for debug mode (on Windows systems output is written to a file instead
of standard error output, see \fBWindows only\fR on \fBFILES\fR
section)
.TP 
\fB\-\-toggle-debug\fR
toggle debug mode of a running Claws Mail instance
.TP 
\fB\-\-version\fR
display version number and exit
.TP 
\fB\-\-version\-full\fR
display version number and compiled\-in features then exit
.TP 
\fB\-\-config\-dir\fR
display the CONFIG\-DIR and exit
.TP
\fB\-\-alternate\-config\-dir [dir]\fR
start Claws Mail with the configuration stored in [dir] directory
\fB\-\-geometry WxH+X+Y\fR
set initial X geometry of main window

.SH "ENVIRONMENT"
.LP
.TP
\fBCLAWS_NO_CRASH\fR
if defined disables crash dialog (only if Claws Mail has been built with
crash dialog feature enabled)
.TP
\fBDISPLAY\fR
default host and display number to use
.TP
\fBETPANSERVER\fR, \fBETPANPORT\fR
when using a tunnel command to open server connections these temporary
variables are set to the server name and server port respectively in the
environment of the running command
.TP
\fBGPG_AGENT_INFO\fR
the information to access the GPG agent if using GPG agent is enabled in
GPG plugin preferences (this is usually set by the agent when launched,
otherwise it likely means the GPG agent is not running)
.TP
\fBG_BROKEN_FILENAMES\fR
assumes that filenames are in the locale encoding rather than in UTF\-8
.TP
\fBHOME\fR
full path of the user's home directory
.TP
\fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLANG\fR
locale to use for non\-windows systems (the first one not empty is used)
.TP
\fBPILOT_CHARSET\fR
if defined overrides default J\-Pilot charset (CP1252)
.TP
\fBPOSIXLY_CORRECT\fR
if defined regular expressions matching follows POSIX standards
.TP
\fBSESSION_MANAGER\fR
if defined tries to use the Session Manager (only if Claws Mail has been
built with libSM feature enabled)
.TP
\fBSHELL\fR
if defined overrides default shell "sh" used by Spamassassin plugin to
launch spamc wrappers
.TP
\fBSSL_CERT_DIR\fR
use this CA certificates directory instead known system directories
.TP
\fBSSL_CERT_FILE\fR
use this CA certificates file instead of searching known system files
.TP
\fBUSER\fR
used to initialize default "user_id" preference in newly created accounts

.SH "BUGS"
.LP
.TP
You can search for existing bugs and report new ones on Claws Mail bugzilla:
.br
<http://www.thewildbeast.co.uk/claws\-mail/bugzilla/>

.SH "COPYRIGHT"
.LP
.TP
1999\-2016 The Claws Mail team and Hiroyuki Yamamoto
.LP
Portions are also Copyright:
.br
(C) 2007\-2009 g10 Code GmbH
.br
(C) 1999\-2005 Nullsoft, Inc.
.br
(C) 1991\-1993, 1996\-2000, 2001 Free Software Foundation, Inc.
.br
(C) 2001 Thomas Link, Hiroyuki Yamamoto
.br
(C) 1995\-1997 Peter Mattis and Spencer Kimball
.br
(C) 1995\-1997 Peter Mattis, Spencer Kimball, Josh MacDonald
.br
(C) 1997\-1998 Jay Painter <jpaint@serv.net><jpaint@gimp.org>
.br
(C) 1999\-2003 Michael Natterer <mitch@gimp.org>
.br
(C) 2000 Evan Martin
.br
(C) 1998 Lars Hamann and Stefan Jeske
.br
(C) 2005, 2006, 2007, 2009 GNOME Foundation
.br
(C) 2004\-2006 Christian Hammond
.br
(C) 2003\-2004 Pawel Salek
.br
(C) 2001, 2002 \- DINH Viet Hoa
.br
(C) 1999\-2000, Gael Roualland <gael.roualland@iname.com>
.br
(C) 1998\-2002 Sendmail, Inc.
.br
(C) 2007\-2008 Juha Kautto (juha at xfce.org)
.br
(C) 1994\-2002 World Wide Web Consortium
.br
(C) 1999 Graham Davison
.br
(C) 1999 Eric Busboom
.br
(C) 2000, Eric Busboom, http://www.softwarestudio.org
.br
(C) 2002\-2007 Randall Hand <yerase@yerot.com>
.br
(C) 2001 by Werner Koch <dd9jn@gnu.org>
.br
(C) 2004 Apache Software Foundation
.br
(C) 2008 Mikkel Kamstrup Erlandsen
.br
(C) 2002  Red Hat, Inc.; Copyright 1998, 2001 Tim Janik
.br
(C) 2008\-2009  Christian Hammond, David Trowbridge
.br
(C) 2003\-2005  Lars Lindner <lars.lindner@gmx.net>
.br
(C) 2004,2005  Nathan J. Conrad <t98502@users.sourceforge.net>
.br
(C) 2004 Karl Soderstrom <ks@xanadunet.net>
.br
(C) 2000 Helix Code, Inc. (www.helixcode.com)

.SH "LICENSE"
.LP
.TP
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
.TP
See COPYING file on toplevel distribution directory for more license details.

.SH "AUTHORS"
.LP 
.TP 
.I "The Claws Mail Team"
.LP
.RS 4
Holger Berndt 			<berndth@users.sf.net>
.br 
Tristan Chabredier		<wwp@claws\-mail.org>
.br 
Andrej Kacian			<andrej@kacian.sk>
.br 
Darko Koruga 			<darko@users.sf.net>
.br 
Ricardo Mones Lastra 	<ricardo@mones.org>
.br 
Charles Lehner			<charles@claws-mail.org>
.br 
Colin Leroy 			<colin@colino.net>
.br 
Paul Mangan 			<paul@claws\-mail.org>
.br 
Salvatore De Paolis 	<iwkse@claws\-mail.org>
.br
Pawel Pekala			<cOrn@o2.pl>
.br
Michael Rasmussen		<mir@datanom.net>
.RE

.TP 
.I "Previous team members"
.LP
.RS 4
Ho\(`a Vi\(^et Dinh, Keith Edmunds, Match Grun, Melvin Hadasht,
Oliver Haertel, Christoph Hohmann, Alfons Hoogervorst, Werner Koch,
Thorsten Maerz, Leandro A. F. Pereira, Luke Plant, Martin Schaaf,
Carsten Schurig, Fabien Vantard, Sergey Vlasov, Hiroyuki Yamamoto
.RE

.SH "SEE ALSO"
.LP 
.TP 
Claws Mail Homepage
<http://www.claws\-mail.org>
.TP
Claws Mail frequently asked questions
<http://www.claws\-mail.org/faq>
.TP
Claws Mail online manual
<http://www.claws\-mail.org/manual>
.TP
Claws Mail plugins
<http://www.claws\-mail.org/plugins.php>
.TP
\fIX\fR(7), \fIxwininfo\fR(1).