Ticket #645: evolution.1

File evolution.1, 3.6 KB (added by bbaren, 12 years ago)

Evolution wrapper man page

Line 
1.\" Evolution wrapper (/usr/bin/evolution) man page
2.TH evolution 1 Debathena "October 2011" "Athena Mail"
3.SH NAME
4evolution \- groupware suite containing e-mail, calendar, addressbook, to-do
5list and memo tools
6.SH SYNOPSIS
7.B evolution
8.RI [ OPTIONS ] " " [ MAILTO ]
9.SH DESCRIPTION
10Evolution is a graphical groupware suite, a single application for reading and
11sending e\-mail and for managing calendars, address books, notes, to-do lists
12and memos.
13.B evolution
14is an Athena wrapper around Evolution, which can be invoked as
15.BR evolution.debathena-orig "."
16.PP
17An optional
18.I MAILTO
19expression can be specified, typically invoked from another application.  An
20example
21.I MAILTO
22expression is `mailto:username@example.com`. This will open a new composer
23window with an empty e-mail to `username@example.com`. More advanced
24expressions are also suppported, but should conform to RFC 2368.
25.PP
26For a more detailed explanation of Evolution, please see the Help menu.
27.SH OPTIONS
28.TP
29.B \-?,  \-\-help
30Show a help message listing all the options and their meanings.
31.TP
32.B \-\-usage
33Show a brief help message listing the names of the options only.
34.TP
35.BI "\-c, \-\-component=" COMPONENT
36Start Evolution by activating the desired component.
37.I COMPONENT
38is one of `mail', `calendar', `contacts', `tasks', `memos'.
39.TP
40.B \-\-offline
41Start in offline mode.
42.TP
43.BR \-\-online
44Start in online mode.
45.TP
46.B \-\-force\-shutdown
47Forcibly shut down all Evolution components.
48.TP
49.B \-\-force\-migrate
50Forcibly re-migrate from Evolution 1.4.
51.TP
52.BI \-\-debug= FILE
53.RI "Send the debugging output of all components to " FILE "."
54.TP
55.B \-\-disable-eplugin
56Disable loading of any plugins.
57.PP
58In addition, the usual GTK+ and GNOME command line options apply.  See the
59output of \-\-help for details.
60.SH "DEBATHENA CUSTOMIZATIONS"
61.nr step 1 1
62When
63.B evolution
64starts, it performs several Debathena-specific actions:
65.IP \n[step]. 3
66If Evolution has never been run before (or the
67.I ~/.evolution
68directory is missing),
69.B evolution
70creates
71.I ~/.evolution
72and sets its AFS permissions to be listable only by the current user
73(system:anyuser none).
74.IP \n+[step].
75.B evolution
76examines the user's mail server to determine if the user uses Exchange or IMAP.
77If the latter,
78.B evolution
79sets Evolution to use GSSAPI to authenticate with Kerberos.
80.IP \n+[step].
81If the user still has an Athena 9 style mail server hostname set,
82.B evolution
83adds the user's new style mail server hostname to his or her Evolution profile.
84.RB ( evolution
85keeps the old server settings as a backup.)
86.B evolution
87also mutates the user's Evolution folder tree to refer to the new style server
88hostname.
89
90If the user does not have an Athena 9 style mail server hostname set,
91.B evolution
92sets up Evolution to use GSSAPI to authenticate the user to outgoing.mit.edu,
93and it creates an initial Evolution folder tree for the user.
94.PP
95After it performs these actions,
96.B evolution
97starts Evolution.
98.SH "SEE ALSO"
99.BR afs (1),
100.BR fs_setacl (1),
101<http://www.novell.com/products/evolution/>, <http://debathena.mit.edu/>
102.SH AUTHOR
103Evolution was originally developed by the company Ximian, now a part of Novell.
104Evolution is now part of GNOME, and many people have touched the code.  See the
105"About" item in the "Help" menu for a list.
106.PP
107This manual page was originally written by Lars Wirzenius for the Debian
108system.  Benjamin Barenblat updated it for use with Debathena.
109.\" Copyright (C) 2004  Lars Wirzenius, Oystein Gisnas
110.\" Copyright (C) 2011  Benjamin Barenblat <bbaren@mit.edu>
111.\" You may copy this manual page under the terms of the version 2 of
112.\" the GNU General Public License.