SPRUCE(1) SPRUCE(1) NAME spruce - a GTK+ Internet mail client for X11. SYNOPSIS spruce [ options ... ] DESCRIPTION Spruce is an X11 mail user agent (commonly known as an email client) written with the Gtk+ widget set. It is geared towards being extremely small and fast, supporting all the common features that users want or need without sacrificing usability or functionality. Spruce's basic feature set includes: View, Save, Delete, Expunge, Print, Copy/Move between mailboxes, Reply and Forward messages. Compose messages in a simple editor with word-wrap. Allows inserting text files into the editor to save composition time through a menu option. Supports adding file attachments via toolbar button. Easy manipulation of mailboxes and messages using both menus and drag-and-drop technology. Address book to keep a list of long or frequently used addresses. New mail checking at the press of a button or on a set timer. Spruce supports MIME (Multipurpose Internet Mail Extensions), an Internet Standard for representing multipart and multimedia data in email. Spruce allows you to save MIME objects to files. Spruce's message composer does not currently have integral multimedia capability, but any type of data file (including multimedia) can be attached to a text message and sent using MIME's encoding rules. This allows any group of individuals with MIME-capable mail software (e.g. Spruce, CSCMail, Mutt, Pine, or many other programs) to exchange formatted documents, spreadsheets, image files, etc, via Internet email. At the present time, spruce uses it's own SMTP interface to send mail. Future versions may support the ability to have an external program like Sendmail send messages as an alternative. Spruce currently supports several different methods of mail retrieval. Currently supported are: POP (POP3, APOP, and POP with CRAM-MD5 Authentication), IMAP (also supports CRAM-MD5 Authentication) and mbox (mbox is the standard UNIX mail format. These mailboxes are commonly found in /var/spool/mail and/or in the user's home directory: ~/mbox). - 1 - Formatted: April 19, 2024 SPRUCE(1) SPRUCE(1) OPTIONS The command line options/arguments are: --bindings This will cause spruce to display any and all key bindings and then exit. Key bindings are keystrokes that are shrotcuts to common menu functions. -h, --help Output spruce's help screen and then exit. -i, --icons This will cause spruce to use icons in the toolbars. If used with the next option ( -t , -- text ), spruce will display both text and icons. -t, --text This will cause spruce to use text in the toolbar buttons. If combined with the previous option ( -i , --icons ), both text and icons will be displayed. -o, --both This is the equivalent of the previous two arguments ( --text and --icons ). This is the default configuration if no other toolbar specific option(s) are passed. -v, --version Output spruce's version information and then exit. SPECIAL OPTIONS Any combination of these options will cause spruce to automatically open a new compose window on startup. --mailto address Specify a mail-to (TO) address --cc address Specify a carbon-copy (CC) address --bcc address Specify a blind carbon-copy (BCC) address (not yet implemented) --subject subject Specify a subject (must be in quotes if the subject contains spaces) - 2 - Formatted: April 19, 2024 SPRUCE(1) SPRUCE(1) CONFIGURATION There are several levels of Spruce configuration. Configuration values at a given level over-ride corresponding values at lower levels. In order of increasing precedence: o built-in defaults. o personal ~/.spruce/spruce.conf file (may be set via built-in Options dialog.) o command-line options. FILES ~/.spruce/spruce.conf configuration file ~/.spruce/addrbook addressbook file ~/.spruce/*.mbx spruce specific mailboxes ~/.spruce/uid.list list of downloaded messages which prevents spruce from redownloading the same email message. ~/.spruce/msgid.list list of read messages ~/.spruce/sprucesig random signature file (takes precedence over the global random signature file) /etc/sprucesig global random signature file SEE ALSO http://www.xtorshun.org/spruce/faq.html for frequently asked questions ACKNOWLEDGMENTS The Spruce development team includes: Project Leader: Jeffrey Stedfast Principal authors: Jeffrey Stedfast, Kristoffer Brnemyr and Melissa Matthews Documentation: Jeffrey Stedfast Web Site: Justin Mecham and Eliot Landrum Suggestions: Folks from all over! Copyright (c)1999 by Jeffrey Stedfast - 3 - Formatted: April 19, 2024