doc/man/claws-mail.1

   1 .TH "CLAWS MAIL" "1" "June  4, 2015" "The Claws Mail team" "User Manuals"
   2
   3 .SH "NAME"
   4 .LP
   5 Claws Mail \- a GTK+ based fast email and news client
   6
   7 .SH "SYNOPSIS"
   8 .B claws\-mail
   9 .RI [ options ]
  10
  11 .SH "DESCRIPTION"
  12 .TP
  13 Claws Mail is an email client (and news reader) based on GTK+, running on the X Window System, and aiming for:
  14 .br
  15 \[bu] Quick response
  16 .br
  17 \[bu] Graceful, and sophisticated interface
  18 .br
  19 \[bu] Easy configuration, intuitive operation
  20 .br
  21 \[bu] Abundant features
  22 \fR
  23 .TP
  24 Currently implemented features include:
  25 \[bu] POP3 support
  26 .br
  27 \[bu] IMAP4rev1 support
  28 .br
  29 \[bu] integrated NetNews client
  30 .br
  31 \[bu] unlimited multiple account handling
  32 .br
  33 \[bu] thread display
  34 .br
  35 \[bu] filtering
  36 .br
  37 \[bu] MIME (attachments)
  38 .br
  39 \[bu] built\-in image view
  40 .br
  41 \[bu] X\-Face and (colour) Face support
  42 .br
  43 \[bu] multiple MH folder support
  44 .br
  45 \[bu] mbox importing / exporting
  46 .br
  47 \[bu] external editor support
  48 .br
  49 \[bu] message queueing
  50 .br
  51 \[bu] automatic mail checking
  52 .br
  53 \[bu] draft message function
  54 .br
  55 \[bu] template function
  56 .br
  57 \[bu] line\-wrapping
  58 .br
  59 \[bu] clickable URI
  60 .br
  61 \[bu] XML\-based address book
  62 .br
  63 \[bu] LDAP, vCard, and JPilot support
  64 .br
  65 \[bu] newly arrived and unread message management
  66 .br
  67 \[bu] Mew/Wanderlust\-like key bind
  68 .br
  69 \[bu] printing
  70 .br
  71 \[bu] APOP authentication support
  72 .br
  73 \[bu] SMTP AUTH support
  74 .br
  75 \[bu] SSL support (POP3, SMTP, IMAP4rev1)
  76 .br
  77 \[bu] IPv6 support
  78 .br
  79 \[bu] drag & drop (partially implemented)
  80 .br
  81 \[bu] GnuPG support
  82 .br
  83 \[bu] automake + autoconf support
  84 .br
  85 \[bu] internationalization of UI messages by gettext
  86 .br
  87 \[bu] support of many code sets, including UTF\-8 (Unicode) (when using libjconv)
  88 .br
  89 \[bu] support for plugins
  90 \fR
  91 .LP
  92 This list is not complete.
  93
  94 .SH "OPTIONS"
  95 .LP
  96 \fB \-\-compose\fR [address]
  97 .br
  98 \fB \-\-compose\-from\-file\fR file
  99 .br
 100 \fB \-\-subscribe\fR [uri]
 101 .br
 102 \fB \-\-attach file1 [file2]...\fR
 103 .br
 104 \fB \-\-receive\fR
 105 .br
 106 \fB \-\-receive\-all\fR
 107 .br
 108 \fB \-\-cancel\-receiving\fR
 109 .br
 110 \fB \-\-cancel\-sending\fR
 111 .br
 112 \fB \-\-send\fR
 113 .br
 114 \fB \-\-status\fR
 115 .br
 116 \fB \-\-status folder[/subfolder]\fR
 117 .br
 118 \fB \-\-status\-full\fR
 119 .br
 120 \fB \-\-statistics\fR
 121 .br
 122 \fB \-\-reset-statistics\fR
 123 .br
 124 \fB \-\-select [#mh/mailbox/]folder[/msg|/msgid]\fR
 125 .br
 126 \fB \-\-online\fR
 127 .br
 128 \fB \-\-offline\fR
 129 .br
 130 \fB \-\-exit\fR
 131 .br
 132 \fB \-\-debug\fR
 133 .br
 134 \fB \-\-toggle\-debug\fR
 135 .br
 136 \fB \-\-help\fR
 137 .br
 138 \fB \-\-version\fR
 139 .br
 140 \fB \-\-version\-full\fR
 141 .br
 142 \fB \-\-config\-dir\fR
 143 .br
 144 \fB \-\-alternate\-config\-dir [dir]\fR
 145
 146 .SH "FILES"
 147 .LP
 148 .TP
 149 $HOME/Mail
 150 Default directory for mail storage
 151 .TP
 152 $PREFIX/share/claws\-mail
 153 Global program directory
 154 .TP
 155 $PREFIX/share/claws\-mail/manual
 156 Manual files in HTML, PDF, PostScript and plain text format
 157 .TP
 158 $PREFIX/share/claws\-mail/themes
 159 Global themes directory
 160 .TP
 161 $PREFIX/lib/claws\-mail/plugins
 162 Directory for plugins
 163 .TP
 164 $PREFIX/include/claws\-mail
 165 Directory for header files
 166 .TP
 167 $HOME/.claws\-mail
 168 Default directory for user's configuration files directory
 169 .TP
 170 $HOME/.claws\-mail/addrbook/*
 171 Addressbook files
 172 .TP
 173 $HOME/.claws\-mail/autofaces/*
 174 Automatic Faces and X\-Faces files for accounts
 175 .TP
 176 $HOME/.claws\-mail/certs/*
 177 SSL certificates received from mail servers
 178 .TP
 179 $HOME/.claws\-mail/templates
 180 User\-defined templates directory
 181 .TP
 182 $HOME/.claws\-mail/themes
 183 User's themes directory
 184 .TP
 185 $HOME/.claws\-mail/accountrc
 186 Configuration for account(s)
 187 .TP
 188 $HOME/.claws\-mail/actionsrc
 189 User\-defined custom actions
 190 .TP
 191 $HOME/.claws\-mail/addressbookcustomattributerc
 192 User\-defined address book custom attributes
 193 .TP
 194 $HOME/.claws\-mail/claws.log
 195 Claws Mail logfile
 196 .TP
 197 $HOME/.claws\-mail/clawsrc
 198 Main configuration file
 199 .TP
 200 $HOME/.claws\-mail/command_history
 201 User\-specified commands
 202 .TP
 203 $HOME/.claws\-mail/customheaderrc
 204 Configuration for custom headers for sending mail
 205 .TP
 206 $HOME/.claws\-mail/dispheaderrc
 207 Configuration for custom display of headers in message view
 208 .TP
 209 $HOME/.claws\-mail/extraheaderrc
 210 Editable extra headers to be added to compose window combobox
 211 .TP
 212 $HOME/.claws\-mail/folderitemrc
 213 All folders' attributes
 214 .TP
 215 $HOME/.claws\-mail/folderlist.xml
 216 Folder hierarchy listing
 217 .TP
 218 $HOME/.claws\-mail/matcherrc
 219 Filtering and Processing function configuration
 220 .TP
 221 $HOME/.claws\-mail/menurc
 222 Menu shortcut\-key configuration
 223 .TP
 224 $HOME/.claws\-mail/messagesearch_history
 225 User\-specified searches in message bodies
 226 .TP
 227 $HOME/.claws\-mail/quicksearch_history
 228 User\-specified quick\-search list
 229 .TP
 230 $HOME/.claws\-mail/messagesearch_history
 231 User\-specified searches in message bodies
 232 .TP
 233 $HOME/.claws\-mail/summary*_history
 234 User\-specified searches in message list
 235 .TP
 236 $HOME/.claws\-mail/tagsrc
 237 User\-specified tag list
 238 .TP
 239 $HOME/.claws\-mail/toolbar*.xml
 240 User\-defined custom toolbars
 241 .TP
 242 .B "Windows only"
 243 .LP
 244 .TP
 245 %TEMP%\\claws\-win32.log
 246 Claws Mail output file when \-\-debug is enabled. If %TEMP% is not set it
 247 defaults to windows directory (usually C:\\Windows) or C:\\ if windows
 248 directory is not available.
 249 .TP
 250 %APPDATA%\\Claws\-mail\\claws.log
 251 Claws Mail log file
 252
 253 .SH "EXAMPLES"
 254 .LP
 255 To run this program the standard way type:
 256 .LP
 257 claws\-mail
 258 .LP
 259 Alternatively you can run it with the following options:
 260 .TP
 261 \fB\-\-compose [address]\fR
 262 to open a Compose window
 263 .TP
 264 \fB\-\-compose\-from\-file file
 265 open composition window with data from given file. Use \- as file name
 266 for reading from standard input. Content format: headers first (To:
 267 header required) until an empty line is found, then mail body until
 268 end of file.
 269 .TP
 270 \fB\-\-subscribe [uri]\fR
 271 subscribe to the given URI if possible
 272 .TP
 273 \fB\-\-attach file1 [file2]...\fR
 274 open composition window with specified files attached
 275 .TP
 276 \fB\-\-compose\fR "mailto:\fI%t\fR?subject=\fI%s\fR&cc=\fI%c\fR&body=\fI%b\fR"
 277 this syntax can be used in web\-browsers and CLI to open a pre\-populated Compose window.
 278 Possible fields after the destination recipient are: subject, from, cc, bcc, in\-reply\-to,
 279 body, insert (insert a file in body part, needs an absolute path), attach (attach a file,
 280 needs an absolute path, see also: \-\-attach)
 281 .TP
 282 \fB\-\-receive\fR
 283 receive new messages
 284 .TP
 285 \fB\-\-receive\-all\fR
 286 receive new messages from all accounts
 287 .TP
 288 \fB\-\-cancel\-receiving\fR
 289 cancel receiving of messages
 290 .TP
 291 \fB\-\-cancel\-sending\fR
 292 cancel sending of messages
 293 .TP
 294 \fB\-\-send\fR
 295 .br
 296 send all queued messages
 297 .TP
 298 \fB\-\-status\fR
 299 show the total number of messages
 300 .br
 301 [new][unread][unread answers to marked][total]
 302 .TP
 303 \fB\-\-status folder[/subfolder]\fR
 304 show the total number of messages in specified folder
 305 .br
 306 [new][unread][unread answers to marked][total]
 307 .TP
 308 \fB\-\-status\-full\fR
 309 show the total number of messages per folder
 310 .br
 311 [new][unread][unread answers to marked][total]
 312 .TP
 313 \fB\-\-statistics\fR
 314 .br
 315 show session statistics
 316 .TP
 317 \fB\-\-reset-statistics\fR
 318 .br
 319 reset session statistics
 320 .TP
 321 \fB\-\-select [#mh/mailbox/]folder[/msg|/msgid]\fR
 322 on startup, jumps to the specified folder/message
 323 .TP
 324 \fB\-\-online\fR
 325 start Claws Mail in (or switch to, if already running) online mode
 326 .TP
 327 \fB\-\-offline\fR
 328 start Claws Mail in (or switch to, if already running) offline mode
 329 .TP
 330 \fB\-\-help\fR
 331 display the help message and exit
 332 .TP
 333 \fB\-\-exit\fR
 334 exit Claws Mail
 335 .TP
 336 \fB\-\-debug\fR
 337 for debug mode (on Windows systems output is written to a file instead
 338 of standard error output, see \fBWindows only\fR on \fBFILES\fR
 339 section)
 340 .TP
 341 \fB\-\-toggle-debug\fR
 342 toggle debug mode of a running Claws Mail instance
 343 .TP
 344 \fB\-\-version\fR
 345 display version number and exit
 346 .TP
 347 \fB\-\-version\-full\fR
 348 display version number and compiled\-in features then exit
 349 .TP
 350 \fB\-\-config\-dir\fR
 351 display the CONFIG\-DIR and exit
 352 .TP
 353 \fB\-\-alternate\-config\-dir [dir]\fR
 354 start Claws Mail with the configuration stored in [dir] directory
 355
 356 .SH "ENVIRONMENT"
 357 .LP
 358 .TP
 359 \fBCLAWS_NO_CRASH\fR
 360 if defined disables crash dialog (only if Claws Mail has been built with
 361 crash dialog feature enabled)
 362 .TP
 363 \fBDISPLAY\fR
 364 default host and display number to use
 365 .TP
 366 \fBGPG_AGENT_INFO\fR
 367 the information to access the GPG agent if using GPG agent is enabled in
 368 GPG plugin preferences (this is usually set by the agent when launched,
 369 otherwise it likely means the GPG agent is not running)
 370 .TP
 371 \fBG_BROKEN_FILENAMES\fR
 372 assumes that filenames are in the locale encoding rather than in UTF\-8
 373 .TP
 374 \fBHOME\fR
 375 full path of the user's home directory
 376 .TP
 377 \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLANG\fR
 378 locale to use for non\-windows systems (the first one not empty is used)
 379 .TP
 380 \fBPILOT_CHARSET\fR
 381 if defined overrides default J\-Pilot charset (CP1252)
 382 .TP
 383 \fBPOSIXLY_CORRECT\fR
 384 if defined regular expressions matching follows POSIX standards
 385 .TP
 386 \fBSESSION_MANAGER\fR
 387 if defined tries to use the Session Manager (only if Claws Mail has been
 388 built with libSM feature enabled)
 389 .TP
 390 \fBSHELL\fR
 391 if defined overrides default shell "sh" used by Spamassassin plugin to
 392 launch spamc wrappers
 393 .TP
 394 \fBSSL_CERT_DIR\fR
 395 use this CA certificates directory instead known system directories
 396 .TP
 397 \fBSSL_CERT_FILE\fR
 398 use this CA certificates file instead of searching known system files
 399 .TP
 400 \fBUSER\fR
 401 used to initialize default "user_id" preference in newly created accounts
 402
 403 .SH "BUGS"
 404 .LP
 405 .TP
 406 You can search for existing bugs and report new ones on Claws Mail bugzilla:
 407 .br
 408 <http://www.thewildbeast.co.uk/claws\-mail/bugzilla/>
 409
 410 .SH "COPYRIGHT"
 411 .LP
 412 .TP
 413 1999\-2015 Hiroyuki Yamamoto and the Claws Mail team
 414 .LP
 415 Portions are also Copyright:
 416 .br
 417 (C) 2007\-2009 g10 Code GmbH
 418 .br
 419 (C) 1999\-2005 Nullsoft, Inc.
 420 .br
 421 (C) 1991\-1993, 1996\-2000, 2001 Free Software Foundation, Inc.
 422 .br
 423 (C) 2001 Thomas Link, Hiroyuki Yamamoto
 424 .br
 425 (C) 1995\-1997 Peter Mattis and Spencer Kimball
 426 .br
 427 (C) 1995\-1997 Peter Mattis, Spencer Kimball, Josh MacDonald
 428 .br
 429 (C) 1997\-1998 Jay Painter <jpaint@serv.net><jpaint@gimp.org>
 430 .br
 431 (C) 1999\-2003 Michael Natterer <mitch@gimp.org>
 432 .br
 433 (C) 2000 Evan Martin
 434 .br
 435 (C) 1998 Lars Hamann and Stefan Jeske
 436 .br
 437 (C) 2005, 2006, 2007, 2009 GNOME Foundation
 438 .br
 439 (C) 2004\-2006 Christian Hammond
 440 .br
 441 (C) 2003\-2004 Pawel Salek
 442 .br
 443 (C) 2001, 2002 \- DINH Viet Hoa
 444 .br
 445 (C) 1999\-2000, Gael Roualland <gael.roualland@iname.com>
 446 .br
 447 (C) 1998\-2002 Sendmail, Inc.
 448 .br
 449 (C) 2007\-2008 Juha Kautto (juha at xfce.org)
 450 .br
 451 (C) 1994\-2002 World Wide Web Consortium
 452 .br
 453 (C) 1999 Graham Davison
 454 .br
 455 (C) 1999 Eric Busboom
 456 .br
 457 (C) 2000, Eric Busboom, http://www.softwarestudio.org
 458 .br
 459 (C) 2002\-2007 Randall Hand <yerase@yerot.com>
 460 .br
 461 (C) 2001 by Werner Koch <dd9jn@gnu.org>
 462 .br
 463 (C) 2004 Apache Software Foundation
 464 .br
 465 (C) 2008 Mikkel Kamstrup Erlandsen
 466 .br
 467 (C) 2002  Red Hat, Inc.; Copyright 1998, 2001 Tim Janik
 468 .br
 469 (C) 2008\-2009  Christian Hammond, David Trowbridge
 470 .br
 471 (C) 2003\-2005  Lars Lindner <lars.lindner@gmx.net>
 472 .br
 473 (C) 2004,2005  Nathan J. Conrad <t98502@users.sourceforge.net>
 474 .br
 475 (C) 2004 Karl Soderstrom <ks@xanadunet.net>
 476 .br
 477 (C) 2000 Helix Code, Inc. (www.helixcode.com)
 478
 479 .SH "LICENSE"
 480 .LP
 481 .TP
 482 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.
 483 .TP
 484 See COPYING file on toplevel distribution directory for more license details.
 485
 486 .SH "AUTHORS"
 487 .LP
 488 .TP
 489 .I "The Claws Mail Team"
 490 .LP
 491 .RS 4
 492 Holger Berndt                   <berndth@users.sf.net>
 493 .br
 494 Tristan Chabredier              <wwp@claws\-mail.org>
 495 .br
 496 Andrej Kacian                   <andrej@kacian.sk>
 497 .br
 498 Darko Koruga                    <darko@users.sf.net>
 499 .br
 500 Ricardo Mones Lastra    <ricardo@mones.org>
 501 .br
 502 Colin Leroy                     <colin@colino.net>
 503 .br
 504 Paul Mangan                     <paul@claws\-mail.org>
 505 .br
 506 Salvatore De Paolis     <iwkse@claws\-mail.org>
 507 .br
 508 Pawel Pekala                    <cOrn@o2.pl>
 509 .br
 510 Michael Rasmussen               <mir@datanom.net>
 511 .RE
 512
 513 .TP
 514 .I "Previous team members"
 515 .LP
 516 .RS 4
 517 Ho\(`a Vi\(^et Dinh, Keith Edmunds, Match Grun, Melvin Hadasht,
 518 Oliver Haertel, Christoph Hohmann, Alfons Hoogervorst, Werner Koch,
 519 Thorsten Maerz, Leandro A. F. Pereira, Luke Plant, Martin Schaaf,
 520 Carsten Schurig, Fabien Vantard, Sergey Vlasov, Hiroyuki Yamamoto
 521 .RE
 522
 523 .SH "SEE ALSO"
 524 .LP
 525 .TP
 526 Claws Mail Homepage
 527 <http://www.claws\-mail.org>
 528 .TP
 529 Claws Mail online manual
 530 <http://www.claws\-mail.org/manual>
 531 .TP
 532 Claws Mail plugins
 533 <http://www.claws\-mail.org/plugins.php>
 534