<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!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">

<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>

<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>