<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!--ARC : LSARC 2003/298 Evolution 1.4-->
<!ENTITY envr-tt "ENVIRONMENT VARIABLES">
<!ENTITY cmd "evolution">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="evolution-1">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>evolution</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">28 Jul 2008</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<refnamediv id="evolution-1-name">
<indexterm><primary>evolution</primary></indexterm><indexterm><primary>Evolution
</primary></indexterm>
<refname>evolution</refname><refpurpose>
A personal and workgroup information management solution. An integration 
of mailer, calendar and addressbook clients. Sun Microsystems Edition, 
Version 2.24</refpurpose></refnamediv>
<refsynopsisdiv id="evolution-1-synp"><title>&synp-tt;</title>
<cmdsynopsis><command>&cmd;</command>
<arg choice="opt"><option>-component=<replaceable>name</replaceable></option></arg>
<arg choice="opt"><option>-debug=<replaceable>filename</replaceable></option></arg>
<arg choice="opt"><option>-disable-eplugin</option></arg>
<arg choice="opt"><option>-disable-preview</option></arg>
<arg choice="opt"><option>-force-shutdown</option></arg>
<arg choice="opt"><option>-help</option></arg>
<arg choice="opt"><option>-offline</option></arg>
<arg choice="opt"><option>-online</option></arg>
<arg choice="opt"><option>-usage</option></arg>

</cmdsynopsis></refsynopsisdiv>
<refsect1 id="evolution-1-desc"><title>&desc-tt;</title>
<para>Evolution integrates email, calendar, contacts, and task list management 
in one application. Evolution provides full support for several data exchange and 
communication standards, such as IMAP, POP, SMTP, LDAP, iCalendar, and vCard. 
Evolution enables tight integration with Sun ONE Messaging and Calendar Servers 
and other messaging systems.</para>
<para></para>
</refsect1>
<refsect1 id="evolution-1-opts"><title>&opts-tt;</title>
<para>The following options are supported:</para>
<variablelist termlength="medium">
<varlistentry><term><option>c,  --component=<replaceable>name</replaceable></option></term>
<listitem><para>Start Evolution activating the specified component.</para>
</listitem></varlistentry>
<varlistentry><term><option>-debug=<replaceable>filename</replaceable></option></term>
<listitem><para>Send the debugging output of all components to a file specified by 
<replaceable>filename</replaceable>. <replaceable>filename</replaceable> is a path to a 
file. For example, /tmp/Evolution is a valid value for <replaceable>filename</replaceable>.
</para>
</listitem></varlistentry>
<varlistentry><term><option>-disable-eplugin</option></term><listitem><para>Disable
loading of any plugins.</para>
</listitem></varlistentry>
<varlistentry><term><option>-disable-preview</option></term>
<listitem><para>Disable preview pane of Mail, Contacts and Tasks.</para>
</listitem></varlistentry>
<varlistentry><term><option>-force-shutdown</option></term><listitem><para>
Forcibly shut down all Evolution components.</para>
</listitem></varlistentry>
<varlistentry><term><option>?</option>, <option>-help</option></term><listitem><para>Display help
text.</para>
</listitem></varlistentry>
<varlistentry><term><option>-offline</option></term><listitem><para>Start
in offline mode.</para>
</listitem></varlistentry>
<varlistentry><term><option>-online</option></term><listitem><para>Start in
online mode.</para>
</listitem></varlistentry>
<varlistentry><term><option>-usage</option></term><listitem><para>Display
brief usage text.</para>
</listitem></varlistentry>
<varlistentry>
<term><option role="nodash"><replaceable>gnome-std-options</replaceable></option></term>
<listitem><para>
Standard options available for use with most GNOME applications.  See
<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for more information.</para>
</listitem></varlistentry>
<varlistentry>
</variablelist></refsect1>
<refsect1 id="evolution-1-exam"><title>&exam-tt;</title>
<example role="example">
<title>To start Evolution activating the Calendar component</title>
<para><screen>example% <userinput>&cmd; -c calendar</userinput></screen></para>
</example>
</refsect1>
<refsect1 id="evolution-1-exit"><title>&exit-tt;</title>
<para>The following exit values are returned:</para>
<variablelist termlength="xtranarrow">
<varlistentry><term><returnvalue>0</returnvalue></term><listitem><para>Application
exited successfully</para>
</listitem></varlistentry>
<varlistentry><term><returnvalue>1</returnvalue></term><listitem><para>Application
exited with failure</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 id="evolution-1-file"><title>&file-tt;</title>
<para>The following files are used by this application:</para>
<variablelist termlength="medium">
<varlistentry><term><filename>/usr/bin/&cmd;</filename> </term><listitem>
<para>Executable script for Evolution application</para>
</listitem></varlistentry>
<varlistentry><term><filename>$HOME/.evolution</filename> </term><listitem>
<para>Directory with per-user configuration files and local storage for Evolution</para>
</listitem></varlistentry>
<refsect1 id="evolution-1-attr"><title>&attr-tt;</title>
<para>See <olink targetdocent="REFMAN2" localinfo="attributes-5"><citerefentry>
<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
for descriptions of the following attributes:</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
<colspec colname="COLSPEC1" colwidth="1*">
<thead>
<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
valign="middle">ATTRIBUTE VALUE</entry></row>
</thead>
<tbody>
<row><entry><para>Availability</para></entry><entry><para>mail/evolution</para></entry>
</row>
<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
colname="COLSPEC1"><para>Volatile</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="evolution-1-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para>
<citerefentry><refentrytitle>evolution-exchange-setup</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libebook-1.2</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libecal-1.2</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>
<refsect1 id="evolution-1-note"><title>&note-tt;</title>
<para>
Ever since the upgrade Evolution from 1.4 to 2.x, this product includes source code for 
the Berkeley Database a product of Oracle Corporation.  Your use of the Berkeley Database 
software separately from Evolution or authorized derivatives thereof is subject to 
additional licensing conditions.

Per-user configuration files and local storage in Evolution 2.x are stored in $HOME/.evolution 
directory as opposed to $HOME/evolution directory in Evolution 1.4. If the user had Evolution 
1.4 installed on the system before, they are able to upgrade to Evolution 2.8 without losing 
configuration and local data. When run for the first time, Evolution 2.x will automatically check for and import all 
the old configuration and local data owned by Evolution 1.4, and convert them to the format 
readable by Evolution 2.x. Users are also allowed to choose between 
preserving the $HOME/evolution directory or not. If users choose to preserve configuration 
and local data for Evolution 1.4, they will have to manage Evolution 1.4 and Evolution 2.8 
configuration and data separately, after the one-time migration. No automatic syncing is 
available for ensuring that changes made to Evolution 2.x are ported to Evolution 1.4, or vice versa.

The addressbook database formats of Evolution 2.x and Evolution 1.4 are different due to the 
use of different versions of Berkeley DB in the backend. User cannot simply copy the database 
file from Evolution 1.4 to Evolution 2.8 in order to do the porting of addressbook.

Written by Jeff Cai, Sun Microsystems Inc., 2008.
 </para>
</refsect1>
</refentry>
