aboutsummaryrefslogtreecommitdiffstats
path: root/ftp/ncftpd/Makefile
diff options
context:
space:
mode:
authorbeech <beech@FreeBSD.org>2008-09-23 17:06:22 +0800
committerbeech <beech@FreeBSD.org>2008-09-23 17:06:22 +0800
commit96b988a9c5ef737d2b45f303f031672cf41b2279 (patch)
tree6ab2f62cd4bbd54b466f3833f345468e4d124eff /ftp/ncftpd/Makefile
parentd98851b1c29191412716e54149a3991e4a6cd8dc (diff)
downloadfreebsd-ports-gnome-96b988a9c5ef737d2b45f303f031672cf41b2279.tar.gz
freebsd-ports-gnome-96b988a9c5ef737d2b45f303f031672cf41b2279.tar.zst
freebsd-ports-gnome-96b988a9c5ef737d2b45f303f031672cf41b2279.zip
- Update to 2.8.5
- Add amd64 support for 6.x and 7.x - Remove 5.x support - Update startup script to rcNG - Fix docs handling - Cleanup and tweaks PR: ports/127527 Submitted by: OH Changsun <oh@xbsd.kr>
Diffstat (limited to 'ftp/ncftpd/Makefile')
-rw-r--r--ftp/ncftpd/Makefile46
1 files changed, 28 insertions, 18 deletions
diff --git a/ftp/ncftpd/Makefile b/ftp/ncftpd/Makefile
index 06f07dc5a281..a7c17a65cd53 100644
--- a/ftp/ncftpd/Makefile
+++ b/ftp/ncftpd/Makefile
@@ -6,34 +6,47 @@
#
PORTNAME= ncftpd
-PORTVERSION= 2.8.3
+PORTVERSION= 2.8.5
CATEGORIES= ftp
-MASTER_SITES= ${MASTER_SITE_LOCAL} \
- ftp://ftp.ncftp.com/ncftpd/${PORTVERSION}/ \
- ftp://ftp.nl.uu.net/pub/unix/ftp/ncftpd/${PORTVERSION}/
-MASTER_SITE_SUBDIR= miwi
-DISTNAME= ${PORTNAME}-${PORTVERSION}-freebsd${BINVER}-${ARCH}-export
+MASTER_SITES= ftp://ftp.ncftp.com/ncftpd/${PORTVERSION}/ \
+ ftp://ftp.nl.uu.net/pub/unix/ftp/ncftpd/${PORTVERSION}/ \
+ LOCAL/beech
+DISTNAME= ${PORTNAME}-${PORTVERSION}-freebsd${BINVER}-${DIST_ARCH}-export
MAINTAINER= beech@FreeBSD.org
-COMMENT= A well known commercial FTP daemon with a 30-day evaluation license
+COMMENT= Commercial FTP daemon with a 30-day evaluation license
WRKSRC= ${WRKDIR}/${PORTNAME}-${PORTVERSION}
-ONLY_FOR_ARCHS= i386
+ONLY_FOR_ARCHS= i386 amd64
NO_BUILD= YES
LICENSE= shareware
RESTRICTED= 30 day evaluation license
+USE_RC_SUBR= ncftpd.sh
+SUB_FILES= pkg-message
+
+PORTDOCS= install.html README README.freebsd LICENSE
+
.include <bsd.port.pre.mk>
-.if ${OSVERSION} >= 600000
+.if ${OSVERSION} >= 700000
+BINVER= 7.0
+.elif ${OSVERSION} >= 600000
BINVER= 6.0
.else
-BINVER= 5.4
-.else
BROKEN= FreeBSD version too old
.endif
+.if ${ARCH} == amd64
+DIST_ARCH= x86_64
+.if ${BINVER} == "6.0"
+BINVER= 6.2
+.endif
+.else
+DIST_ARCH= i386
+.endif
+
do-install:
${MKDIR} ${PREFIX}/etc/ncftpd
${INSTALL_PROGRAM} ${WRKSRC}/ncftpd ${PREFIX}/sbin
@@ -43,16 +56,13 @@ do-install:
${INSTALL_PROGRAM} ${WRKSRC}/ncftpd_spy ${PREFIX}/bin
${INSTALL_DATA} ${WRKSRC}/conf/general.cf-dist ${PREFIX}/etc/ncftpd
${INSTALL_DATA} ${WRKSRC}/conf/domain.cf-dist ${PREFIX}/etc/ncftpd
- ${INSTALL_SCRIPT} ${SCRIPTDIR}/ncftpd.sh ${PREFIX}/etc/rc.d
post-install:
.if !defined(NOPORTDOCS)
- ${MKDIR} ${PREFIX}/share/doc/ncftpd
- ${INSTALL_DATA} ${WRKSRC}/install.html ${PREFIX}/share/doc/ncftpd
- ${INSTALL_DATA} ${WRKSRC}/README ${PREFIX}/share/doc/ncftpd
- ${INSTALL_DATA} ${WRKSRC}/README.freebsd ${PREFIX}/share/doc/ncftpd
- ${INSTALL_DATA} ${WRKSRC}/LICENSE ${PREFIX}/share/doc/ncftpd
+ @${INSTALL} -d ${DOCSDIR}
+ @ cd ${WRKSRC} && ${INSTALL_DATA} ${PORTDOCS} ${DOCSDIR}
.endif
- @${SED} -e 's,%%PREFIX%%,${PREFIX},' ${PKGMESSAGE}
+
+ @${CAT} ${PKGMESSAGE}
.include <bsd.port.post.mk>
iv class='add'>+ <application>Evolution</application> acknowledge the efforts
+ and contributions of all who worked on those projects.
+ </para>
+
+ <para>
+ Ximian would like to thank everyone who helped out with the bug
+ tracking process, particularly Miles Lane, and also the staff of
+ El Pelon Taqueria, on Peterborough St. in Boston, for
+ sustenance.
+ </para>
+
+ <para>
+ For more information please visit the
+ <application>Evolution</application> <ulink
+ url="http://www.ximian.com/products/evolution/"
+ type="http">Web page</ulink>. Please send all comments,
+ suggestions, and bug reports to the <ulink
+ url="http://bugzilla.ximian.com" type="http">Ximian bug tracking
+ database</ulink>. Instructions for submitting bug reports can be
+ found on-line at the same location. You can also use the GNOME
+ bug report tool, <command>bug-buddy</command>, to submit your
+ defect reports.
+ </para>
+ <para>
+ This manual was written by Aaron Weber
+ (<email>aaron@ximian.com</email>), Kevin Breit
+ (<email>mrproper@ximian.com</email>) Duncan Mak
+ (<email>duncan@ximian.com</email>) and Ettore Perazzoli
+ (<email>ettore@ximian.com</email>) with the help of the
+ application programmers and the GNOME Documentation Project.
+ Please file comments and suggestions for this manual as bugs in
+ the Ximian bug tracking system. If you contributed to this
+ project but do not see your name here, please contact Aaron
+ Weber (<email>aaron@ximian.com</email>) and he'll list you. The
+ list of translators, in particular, is lacking numerous
+ contributors.
+ </para>
+ <para>
+ This product has been translated into many languages. Some of
+ the translators are listed here:
+ <itemizedlist>
+ <listitem><para>
+ Daniel Persson for .se
+ </para></listitem>
+
+ <listitem><para>
+ Hector Garcia Alvarez for .es
+ </para></listitem>
+
+ <listitem><para>
+ Kjartan Maraas for .no
+ </para></listitem>
+ </itemizedlist>
+ </para>
+ </appendix>
+
+
+
+
+
diff --git a/help/C/apx-fdl.sgml b/help/C/apx-fdl.sgml
new file mode 100644
index 0000000000..4af2a495fa
--- /dev/null
+++ b/help/C/apx-fdl.sgml
@@ -0,0 +1,667 @@
+<!--
+ The GNU Free Documentation License 1.1 in DocBook
+ Markup by Eric Baudais <baudais@okstate.edu>
+ Maintained by the GNOME Documentation Project
+ http://developer.gnome.org/projects/gdp
+ Version: 1.0.1
+ Last Modified: Nov 16, 2000
+-->
+
+<appendix id="apx-fdl">
+ <appendixinfo>
+ <releaseinfo>
+ Version 1.1, March 2000
+ </releaseinfo>
+ <copyright>
+ <year>2000</year><holder>Free Software Foundation, Inc.</holder>
+ </copyright>
+ <legalnotice id="fdl-legalnotice">
+ <para>
+ <address>Free Software Foundation, Inc. <street>59 Temple Place,
+ Suite 330</street>, <city>Boston</city>, <state>MA</state>
+ <postcode>02111-1307</postcode> <country>USA</country></address>
+ Everyone is permitted to copy and distribute verbatim copies of this
+ license document, but changing it is not allowed.
+ </para>
+ </legalnotice>
+ </appendixinfo>
+ <title>GNU Free Documentation License</title>
+
+ <sect1 id="fdl-preamble">
+ <title>0. PREAMBLE</title>
+ <para>
+ The purpose of this License is to make a manual, textbook, or
+ other written document <quote>free</quote> in the sense of
+ freedom: to assure everyone the effective freedom to copy and
+ redistribute it, with or without modifying it, either
+ commercially or noncommercially. Secondarily, this License
+ preserves for the author and publisher a way to get credit for
+ their work, while not being considered responsible for
+ modifications made by others.
+ </para>
+
+ <para>
+ This License is a kind of <quote>copyleft</quote>, which means
+ that derivative works of the document must themselves be free in
+ the same sense. It complements the GNU General Public License,
+ which is a copyleft license designed for free software.
+ </para>
+
+ <para>
+ We have designed this License in order to use it for manuals for
+ free software, because free software needs free documentation: a
+ free program should come with manuals providing the same
+ freedoms that the software does. But this License is not limited
+ to software manuals; it can be used for any textual work,
+ regardless of subject matter or whether it is published as a
+ printed book. We recommend this License principally for works
+ whose purpose is instruction or reference.
+ </para>
+ </sect1>
+ <sect1 id="fdl-section1">
+ <title>1. APPLICABILITY AND DEFINITIONS</title>
+ <para id="fdl-document">
+ This License applies to any manual or other work that contains a
+ notice placed by the copyright holder saying it can be
+ distributed under the terms of this License. The
+ <quote>Document</quote>, below, refers to any such manual or
+ work. Any member of the public is a licensee, and is addressed
+ as <quote>you</quote>.
+ </para>
+
+ <para id="fdl-modified">
+ A <quote>Modified Version</quote> of the Document means any work
+ containing the Document or a portion of it, either copied
+ verbatim, or with modifications and/or translated into another
+ language.
+ </para>
+
+ <para id="fdl-secondary">
+ A <quote>Secondary Section</quote> is a named appendix or a
+ front-matter section of the <link
+ linkend="fdl-document">Document</link> that deals exclusively
+ with the relationship of the publishers or authors of the
+ Document to the Document's overall subject (or to related
+ matters) and contains nothing that could fall directly within
+ that overall subject. (For example, if the Document is in part a
+ textbook of mathematics, a Secondary Section may not explain any
+ mathematics.) The relationship could be a matter of historical
+ connection with the subject or with related matters, or of
+ legal, commercial, philosophical, ethical or political position
+ regarding them.
+ </para>
+
+ <para id="fdl-invariant">
+ The <quote>Invariant Sections</quote> are certain <link
+ linkend="fdl-secondary"> Secondary Sections</link> whose titles
+ are designated, as being those of Invariant Sections, in the
+ notice that says that the <link
+ linkend="fdl-document">Document</link> is released under this
+ License.
+ </para>
+
+ <para id="fdl-cover-texts">
+ The <quote>Cover Texts</quote> are certain short passages of
+ text that are listed, as Front-Cover Texts or Back-Cover Texts,
+ in the notice that says that the <link
+ linkend="fdl-document">Document</link> is released under this
+ License.
+ </para>
+
+ <para id="fdl-transparent">
+ A <quote>Transparent</quote> copy of the <link
+ linkend="fdl-document"> Document</link> means a machine-readable
+ copy, represented in a format whose specification is available
+ to the general public, whose contents can be viewed and edited
+ directly and straightforwardly with generic text editors or (for
+ images composed of pixels) generic paint programs or (for
+ drawings) some widely available drawing editor, and that is
+ suitable for input to text formatters or for automatic
+ translation to a variety of formats suitable for input to text
+ formatters. A copy made in an otherwise Transparent file format
+ whose markup has been designed to thwart or discourage
+ subsequent modification by readers is not Transparent. A copy
+ that is not <quote>Transparent</quote> is called
+ <quote>Opaque</quote>.
+ </para>
+
+ <para>
+ Examples of suitable formats for Transparent copies include
+ plain ASCII without markup, Texinfo input format, LaTeX input
+ format, SGML or XML using a publicly available DTD, and
+ standard-conforming simple HTML designed for human
+ modification. Opaque formats include PostScript, PDF,
+ proprietary formats that can be read and edited only by
+ proprietary word processors, SGML or XML for which the DTD
+ and/or processing tools are not generally available, and the
+ machine-generated HTML produced by some word processors for
+ output purposes only.
+ </para>
+
+ <para id="fdl-title-page">
+ The <quote>Title Page</quote> means, for a printed book, the
+ title page itself, plus such following pages as are needed to
+ hold, legibly, the material this License requires to appear in
+ the title page. For works in formats which do not have any title
+ page as such, <quote>Title Page</quote> means the text near the
+ most prominent appearance of the work's title, preceding the
+ beginning of the body of the text.
+ </para>
+ </sect1>
+
+ <sect1 id="fdl-section2">
+ <title>2. VERBATIM COPYING</title>
+ <para>
+ You may copy and distribute the <link
+ linkend="fdl-document">Document</link> in any medium, either
+ commercially or noncommercially, provided that this License, the
+ copyright notices, and the license notice saying this License
+ applies to the Document are reproduced in all copies, and that
+ you add no other conditions whatsoever to those of this
+ License. You may not use technical measures to obstruct or
+ control the reading or further copying of the copies you make or
+ distribute. However, you may accept compensation in exchange for
+ copies. If you distribute a large enough number of copies you
+ must also follow the conditions in <link
+ linkend="fdl-section3">section 3</link>.
+ </para>
+
+ <para>
+ You may also lend copies, under the same conditions stated
+ above, and you may publicly display copies.
+ </para>
+ </sect1>
+
+ <sect1 id="fdl-section3">
+ <title>3. COPYING IN QUANTITY</title>
+ <para>
+ If you publish printed copies of the <link
+ linkend="fdl-document">Document</link> numbering more than 100,
+ and the Document's license notice requires <link
+ linkend="fdl-cover-texts">Cover Texts</link>, you must enclose
+ the copies in covers that carry, clearly and legibly, all these
+ Cover Texts: Front-Cover Texts on the front cover, and
+ Back-Cover Texts on the back cover. Both covers must also
+ clearly and legibly identify you as the publisher of these
+ copies. The front cover must present the full title with all
+ words of the title equally prominent and visible. You may add
+ other material on the covers in addition. Copying with changes
+ limited to the covers, as long as they preserve the title of the
+ <link linkend="fdl-document">Document</link> and satisfy these
+ conditions, can be treated as verbatim copying in other
+ respects.
+ </para>
+
+ <para>
+ If the required texts for either cover are too voluminous to fit
+ legibly, you should put the first ones listed (as many as fit
+ reasonably) on the actual cover, and continue the rest onto
+ adjacent pages.
+ </para>
+
+ <para>
+ If you publish or distribute <link
+ linkend="fdl-transparent">Opaque</link> copies of the <link
+ linkend="fdl-document">Document</link> numbering more than 100,
+ you must either include a machine-readable <link
+ linkend="fdl-transparent">Transparent</link> copy along with
+ each Opaque copy, or state in or with each Opaque copy a
+ publicly-accessible computer-network location containing a
+ complete Transparent copy of the Document, free of added
+ material, which the general network-using public has access to
+ download anonymously at no charge using public-standard network
+ protocols. If you use the latter option, you must take
+ reasonably prudent steps, when you begin distribution of Opaque
+ copies in quantity, to ensure that this Transparent copy will
+ remain thus accessible at the stated location until at least one
+ year after the last time you distribute an Opaque copy (directly
+ or through your agents or retailers) of that edition to the
+ public.
+ </para>
+
+ <para>
+ It is requested, but not required, that you contact the authors
+ of the <link linkend="fdl-document">Document</link> well before
+ redistributing any large number of copies, to give them a chance
+ to provide you with an updated version of the Document.
+ </para>
+ </sect1>
+
+ <sect1 id="fdl-section4">
+ <title>4. MODIFICATIONS</title>
+ <para>
+ You may copy and distribute a <link
+ linkend="fdl-modified">Modified Version</link> of the <link
+ linkend="fdl-document">Document</link> under the conditions of
+ sections <link linkend="fdl-section2">2</link> and <link
+ linkend="fdl-section3">3</link> above, provided that you release
+ the Modified Version under precisely this License, with the
+ Modified Version filling the role of the Document, thus
+ licensing distribution and modification of the Modified Version
+ to whoever possesses a copy of it. In addition, you must do
+ these things in the Modified Version:
+ </para>
+
+ <itemizedlist mark="opencircle">
+ <listitem>
+ <formalpara>
+ <title>A</title>
+ <para>
+ Use in the <link linkend="fdl-title-page">Title
+ Page</link> (and on the covers, if any) a title distinct
+ from that of the <link
+ linkend="fdl-document">Document</link>, and from those of
+ previous versions (which should, if there were any, be
+ listed in the History section of the Document). You may
+ use the same title as a previous version if the original
+ publisher of that version gives permission.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>B</title>
+ <para>
+ List on the <link linkend="fdl-title-page">Title
+ Page</link>, as authors, one or more persons or entities
+ responsible for authorship of the modifications in the
+ <link linkend="fdl-modified">Modified Version</link>,
+ together with at least five of the principal authors of
+ the <link linkend="fdl-document">Document</link> (all of
+ its principal authors, if it has less than five).
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>C</title>
+ <para>
+ State on the <link linkend="fdl-title-page">Title
+ Page</link> the name of the publisher of the <link
+ linkend="fdl-modified">Modified Version</link>, as the
+ publisher.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>D</title>
+ <para>
+ Preserve all the copyright notices of the <link
+ linkend="fdl-document">Document</link>.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>E</title>
+ <para>
+ Add an appropriate copyright notice for your modifications
+ adjacent to the other copyright notices.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>F</title>
+ <para>
+ Include, immediately after the copyright notices, a
+ license notice giving the public permission to use the
+ <link linkend="fdl-modified">Modified Version</link> under
+ the terms of this License, in the form shown in the
+ Addendum below.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>G</title>
+ <para>
+ Preserve in that license notice the full lists of <link
+ linkend="fdl-invariant"> Invariant Sections</link> and
+ required <link linkend="fdl-cover-texts">Cover
+ Texts</link> given in the <link
+ linkend="fdl-document">Document's</link> license notice.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>H</title>
+ <para>
+ Include an unaltered copy of this License.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>I</title>
+ <para>
+ Preserve the section entitled <quote>History</quote>, and
+ its title, and add to it an item stating at least the
+ title, year, new authors, and publisher of the <link
+ linkend="fdl-modified">Modified Version </link>as given on
+ the <link linkend="fdl-title-page">Title Page</link>. If
+ there is no section entitled <quote>History</quote> in the
+ <link linkend="fdl-document">Document</link>, create one
+ stating the title, year, authors, and publisher of the
+ Document as given on its Title Page, then add an item
+ describing the Modified Version as stated in the previous
+ sentence.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>J</title>
+ <para>
+ Preserve the network location, if any, given in the <link
+ linkend="fdl-document">Document</link> for public access
+ to a <link linkend="fdl-transparent">Transparent</link>
+ copy of the Document, and likewise the network locations
+ given in the Document for previous versions it was based
+ on. These may be placed in the <quote>History</quote>
+ section. You may omit a network location for a work that
+ was published at least four years before the Document
+ itself, or if the original publisher of the version it
+ refers to gives permission.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>K</title>
+ <para>
+ In any section entitled <quote>Acknowledgements</quote> or
+ <quote>Dedications</quote>, preserve the section's title,
+ and preserve in the section all the substance and tone of
+ each of the contributor acknowledgements and/or
+ dedications given therein.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>L</title>
+ <para>
+ Preserve all the <link linkend="fdl-invariant">Invariant
+ Sections</link> of the <link
+ linkend="fdl-document">Document</link>, unaltered in their
+ text and in their titles. Section numbers or the
+ equivalent are not considered part of the section titles.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>M</title>
+ <para>
+ Delete any section entitled
+ <quote>Endorsements</quote>. Such a section may not be
+ included in the <link linkend="fdl-modified">Modified
+ Version</link>.
+ </para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>N</title>
+ <para>
+ Do not retitle any existing section as
+ <quote>Endorsements</quote> or to conflict in title with
+ any <link linkend="fdl-invariant">Invariant
+ Section</link>.
+ </para>
+ </formalpara>
+ </listitem>
+ </itemizedlist>
+
+ <para>
+ If the <link linkend="fdl-modified">Modified Version</link>
+ includes new front-matter sections or appendices that qualify as
+ <link linkend="fdl-secondary">Secondary Sections</link> and
+ contain no material copied from the Document, you may at your
+ option designate some or all of these sections as invariant. To
+ do this, add their titles to the list of <link
+ linkend="fdl-invariant">Invariant Sections</link> in the
+ Modified Version's license notice. These titles must be
+ distinct from any other section titles.
+ </para>
+
+ <para>
+ You may add a section entitled <quote>Endorsements</quote>,
+ provided it contains nothing but endorsements of your <link
+ linkend="fdl-modified">Modified Version</link> by various
+ parties--for example, statements of peer review or that the text
+ has been approved by an organization as the authoritative
+ definition of a standard.
+ </para>
+
+ <para>
+ You may add a passage of up to five words as a <link
+ linkend="fdl-cover-texts">Front-Cover Text</link>, and a passage
+ of up to 25 words as a <link
+ linkend="fdl-cover-texts">Back-Cover Text</link>, to the end of
+ the list of <link linkend="fdl-cover-texts">Cover Texts</link>
+ in the <link linkend="fdl-modified">Modified Version</link>.
+ Only one passage of Front-Cover Text and one of Back-Cover Text
+ may be added by (or through arrangements made by) any one
+ entity. If the <link linkend="fdl-document">Document</link>
+ already includes a cover text for the same cover, previously
+ added by you or by arrangement made by the same entity you are
+ acting on behalf of, you may not add another; but you may
+ replace the old one, on explicit permission from the previous
+ publisher that added the old one.
+ </para>
+
+ <para>
+ The author(s) and publisher(s) of the <link
+ linkend="fdl-document">Document</link> do not by this License
+ give permission to use their names for publicity for or to
+ assert or imply endorsement of any <link
+ linkend="fdl-modified">Modified Version </link>.
+ </para>
+ </sect1>
+
+ <sect1 id="fdl-section5">
+ <title>5. COMBINING DOCUMENTS</title>
+ <para>
+ You may combine the <link linkend="fdl-document">Document</link>
+ with other documents released under this License, under the
+ terms defined in <link linkend="fdl-section4">section 4</link>
+ above for modified versions, provided that you include in the
+ combination all of the <link linkend="fdl-invariant">Invariant
+ Sections</link> of all of the original documents, unmodified,
+ and list them all as Invariant Sections of your combined work in
+ its license notice.
+ </para>
+
+ <para>
+ The combined work need only contain one copy of this License,
+ and multiple identical <link linkend="fdl-invariant">Invariant
+ Sections</link> may be replaced with a single copy. If there are
+ multiple Invariant Sections with the same name but different
+ contents, make the title of each such section unique by adding
+ at the end of it, in parentheses, the name of the original
+ author or publisher of that section if known, or else a unique
+ number. Make the same adjustment to the section titles in the
+ list of Invariant Sections in the license notice of the combined
+ work.
+ </para>
+
+ <para>
+ In the combination, you must combine any sections entitled
+ <quote>History</quote> in the various original documents,
+ forming one section entitled <quote>History</quote>; likewise
+ combine any sections entitled <quote>Acknowledgements</quote>,
+ and any sections entitled <quote>Dedications</quote>. You must
+ delete all sections entitled <quote>Endorsements.</quote>
+ </para>
+ </sect1>
+
+ <sect1 id="fdl-section6">
+ <title>6. COLLECTIONS OF DOCUMENTS</title>
+ <para>
+ You may make a collection consisting of the <link
+ linkend="fdl-document">Document</link> and other documents
+ released under this License, and replace the individual copies
+ of this License in the various documents with a single copy that
+ is included in the collection, provided that you follow the
+ rules of this License for verbatim copying of each of the
+ documents in all other respects.
+ </para>
+
+ <para>
+ You may extract a single document from such a collection, and
+ dispbibute it individually under this License, provided you
+ insert a copy of this License into the extracted document, and
+ follow this License in all other respects regarding verbatim
+ copying of that document.
+ </para>
+ </sect1>
+
+ <sect1 id="fdl-section7">
+ <title>7. AGGREGATION WITH INDEPENDENT WORKS</title>
+ <para>
+ A compilation of the <link
+ linkend="fdl-document">Document</link> or its derivatives with
+ other separate and independent documents or works, in or on a
+ volume of a storage or distribution medium, does not as a whole
+ count as a <link linkend="fdl-modified">Modified Version</link>
+ of the Document, provided no compilation copyright is claimed
+ for the compilation. Such a compilation is called an
+ <quote>aggregate</quote>, and this License does not apply to the
+ other self-contained works thus compiled with the Document , on
+ account of their being thus compiled, if they are not themselves
+ derivative works of the Document. If the <link
+ linkend="fdl-cover-texts">Cover Text</link> requirement of <link
+ linkend="fdl-section3">section 3</link> is applicable to these
+ copies of the Document, then if the Document is less than one
+ quarter of the entire aggregate, the Document's Cover Texts may
+ be placed on covers that surround only the Document within the
+ aggregate. Otherwise they must appear on covers around the whole
+ aggregate.
+ </para>
+ </sect1>
+
+ <sect1 id="fdl-section8">
+ <title>8. TRANSLATION</title>
+ <para>
+ Translation is considered a kind of modification, so you may
+ distribute translations of the <link
+ linkend="fdl-document">Document</link> under the terms of <link
+ linkend="fdl-section4">section 4</link>. Replacing <link
+ linkend="fdl-invariant"> Invariant Sections</link> with
+ translations requires special permission from their copyright
+ holders, but you may include translations of some or all
+ Invariant Sections in addition to the original versions of these
+ Invariant Sections. You may include a translation of this
+ License provided that you also include the original English
+ version of this License. In case of a disagreement between the
+ translation and the original English version of this License,
+ the original English version will prevail.
+ </para>
+ </sect1>
+
+ <sect1 id="fdl-section9">
+ <title>9. TERMINATION</title>
+ <para>
+ You may not copy, modify, sublicense, or distribute the <link
+ linkend="fdl-document">Document</link> except as expressly
+ provided for under this License. Any other attempt to copy,
+ modify, sublicense or distribute the Document is void, and will
+ automatically terminate your rights under this License. However,
+ parties who have received copies, or rights, from you under this
+ License will not have their licenses terminated so long as such
+ parties remain in full compliance.
+ </para>
+ </sect1>
+
+ <sect1 id="fdl-section10">
+ <title>10. FUTURE REVISIONS OF THIS LICENSE</title>
+ <para>
+ The <ulink type="http"
+ url="http://www.gnu.org/fsf/fsf.html">Free Software
+ Foundation</ulink> may publish new, revised versions of the GNU
+ Free Documentation License from time to time. Such new versions
+ will be similar in spirit to the present version, but may differ
+ in detail to address new problems or concerns. See <ulink
+ type="http"
+ url="http://www.gnu.org/copyleft">http://www.gnu.org/copyleft/</ulink>.
+ </para>
+
+ <para>
+ Each version of the License is given a distinguishing version
+ number. If the <link linkend="fdl-document">Document</link>
+ specifies that a particular numbered version of this License
+ <quote>or any later version</quote> applies to it, you have the
+ option of following the terms and conditions either of that
+ specified version or of any later version that has been
+ published (not as a draft) by the Free Software Foundation. If
+ the Document does not specify a version number of this License,
+ you may choose any version ever published (not as a draft) by
+ the Free Software Foundation.
+ </para>
+ </sect1>
+
+ <sect1 id="fdl-using">
+ <title>Addendum</title>
+ <para>
+ To use this License in a document you have written, include a copy of
+ the License in the document and put the following copyright and
+ license notices just after the title page:
+ </para>
+
+ <blockquote>
+ <para>
+ Copyright YEAR YOUR NAME.
+ </para>
+ <para>
+ Permission is granted to copy, distribute and/or modify this
+ document under the terms of the GNU Free Documentation
+ License, Version 1.1 or any later version published by the
+ Free Software Foundation; with the <link
+ linkend="fdl-invariant">Invariant Sections</link> being LIST
+ THEIR TITLES, with the <link
+ linkend="fdl-cover-texts">Front-Cover Texts</link> being LIST,
+ and with the <link linkend="fdl-cover-texts">Back-Cover
+ Texts</link> being LIST. A copy of the license is included in
+ the section entitled <quote>GNU Free Documentation
+ License</quote>.
+ </para>
+ </blockquote>
+
+ <para>
+ If you have no <link linkend="fdl-invariant">Invariant
+ Sections</link>, write <quote>with no Invariant Sections</quote>
+ instead of saying which ones are invariant. If you have no
+ <link linkend="fdl-cover-texts">Front-Cover Texts</link>, write
+ <quote>no Front-Cover Texts</quote> instead of
+ <quote>Front-Cover Texts being LIST</quote>; likewise for <link
+ linkend="fdl-cover-texts">Back-Cover Texts</link>.
+ </para>
+
+ <para>
+ If your document contains nontrivial examples of program code,
+ we recommend releasing these examples in parallel under your
+ choice of free software license, such as the <ulink type="http"
+ url="http://www.gnu.org/copyleft/gpl.html"> GNU General Public
+ License</ulink>, to permit their use in free software.
+ </para>
+ </sect1>
+</appendix>
+
+
diff --git a/help/C/apx-gloss.sgml b/help/C/apx-gloss.sgml
new file mode 100644
index 0000000000..36ed4ef41c
--- /dev/null
+++ b/help/C/apx-gloss.sgml
@@ -0,0 +1,480 @@
+<glossary id="apx-gloss">
+
+ <title>Glossary</title>
+
+ <glossentry id="assistant">
+ <glossterm>Assistant:</glossterm>
+ <glossdef>
+ <para>
+ A tool which guides a user through a series of steps, usually
+ to configure or set up a program. Equivalent to "Wizard" and
+ "Druid."
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="attachment">
+ <glossterm>Attachment:</glossterm>
+ <glossdef>
+ <para>
+ Any file sent along with an email. Attachments may be embedded in
+ a message or appended to it.
+ </para>
+ </glossdef>
+ </glossentry>
+
+<glossentry id="automatic-indexing">
+ <glossterm>Automatic Indexing:</glossterm>
+ <glossdef>
+ <para>
+ Pre-fetching procedure that allows
+ <application>Evolution</application> to refer to data quickly.
+ It enables faster searches and decreases memory usage for
+ data displays.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="bcc">
+ <glossterm>Bcc (Blind Carbon Copy):</glossterm>
+ <glossdef>
+ <para>
+ A way of addressing a message. Bcc is used to send a group of
+ people an e-mail, while hiding their names and addresses from each
+ other.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="cc">
+ <glossterm>Cc (Carbon Copy):</glossterm>
+ <glossdef>
+ <para>
+ Carbon-copies are used to send a 3rd party a copy of the e-mail,
+ so they an keep up to date on a conversation, without being in the
+ To: list.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="conduit">
+ <glossterm>Conduit:</glossterm>
+ <glossdef>
+ <para>
+ A small application which controls
+ the transfer of data between a handheld device and a desktop
+ computer.
+ </para>
+ </glossdef>
+ </glossentry>
+
+
+ <glossentry id="druid">
+ <glossterm>Druid:</glossterm>
+ <glossdef>
+ <para>
+ See "Assistant."
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="evolution">
+ <glossterm>Evolution:</glossterm>
+ <glossdef>
+ <para>
+ <application>Evolution</application> is the <acronym> GNOME
+ </acronym> groupware application.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="execute">
+ <glossterm>Execute:</glossterm>
+ <glossdef>
+ <para>
+ To run a program. Any file that can be run is called an
+ executable. <application>Evolution</application> can download
+ executable attachments, but before they can be run, the files must
+ be marked as executable with a shell or file manager. This
+ security precaution prevents the automatic or accidental execution
+ of malicious programs. For more information on executables and file
+ permissions, see the documentation for your file manager or shell.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="expunge">
+ <glossterm>Expunge:</glossterm>
+ <glossdef>
+ <para>
+ When messages are marked for deletion, they remain till they are expunged.
+ When a message is expunged, it is permanently deleted, as long as it was
+ marked for deletion.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="filetree">
+ <glossterm>File Tree:</glossterm>
+ <glossdef>
+ <para>
+ A way of describing a group of files on a computer. With the
+ perversity typical of computer (and especially Unix and Linux)
+ nomenclature, the top of the tree is called the root directory,
+ and denoted by <filename>/</filename>.
+ The rest of the "branches" spread downward from the root. Don't
+ confuse the root directory with the root
+ account, or root's home directory, normally
+ <filename>/root</filename>.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="filter">
+ <glossterm>Filter:</glossterm>
+ <glossdef>
+ <para>
+ Within <application>Evolution</application>, a filter is a method
+ of sorting mail automatically when it's downloaded. You can create filters to perform
+ one or more actions on a message that meets any (or all) of a wide
+ range of criteria.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="forward">
+ <glossterm>Forward:</glossterm>
+ <glossdef>
+ <para>
+ If you get a message intended for someone else, you can use
+ message forwarding to send it on to the right person.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="groupware">
+ <glossterm>Groupware:</glossterm>
+ <glossdef>
+ <para>
+ Groupware is a term describing an application which helps groups
+ of people work together. Typically, a groupware application will
+ have several productivity features built into one program,
+ including: email, calendar, and addressbook tools.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="html">
+ <glossterm>HTML:</glossterm>
+ <glossdef>
+ <para>
+ Hyper-text Markup Language (<acronym>HTML</acronym>) is a language
+ for describing page layout in electronic documents like web pages,
+ help files, and email messages. HTML can be used in email and
+ news posts to insert images and apply text treatments.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="hot-key">
+ <glossterm>Hot Key:</glossterm>
+ <glossdef>
+ <para>
+ Hot-keys are keyboard combinations used to do actions on a
+ computer instead of using the mouse.
+ Hot-keys can speed up computer usage.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="ical">
+ <glossterm>iCal:</glossterm>
+ <glossdef>
+ <para>
+ <application>iCal</application> is the program which
+ <application>Evolution</application> uses to manage the calendar
+ section.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="imap">
+ <glossterm>IMAP:</glossterm>
+ <glossdef>
+ <para>
+ Depending upon whom you ask, IMAP stands for the Internet Mail
+ Access Protocol, or the Interim Mail Access Protocol. It allows access to email which is typically (although
+ not always) stored remotely on a server rather than on a local
+ hard disk. Often contrasted with <glossterm>POP:</glossterm>.
+ This will not be on the test.
+ </para>
+ </glossdef>
+ </glossentry>
+
+
+ <glossentry id="inline">
+ <glossterm>Inline:</glossterm>
+ <glossdef>
+ <para>
+ Displayed as part of a message or other document, rather than
+ attached as a separate file. Contrast with <glossterm
+ linkend="attachment">Attachment:</glossterm>.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="ldap">
+ <glossterm>LDAP:</glossterm>
+ <glossdef>
+ <para>
+ LDAP, the Lightweight Directory Access Protocol, allows a client
+ to search through a large database of addresses, phone numbers,
+ and people stored on a server.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="mail-client">
+ <glossterm>Mail Client:</glossterm>
+ <glossdef>
+ <para>
+ A mail client is the application with which a person reads and
+ sends e-mail. Its counterparts are the various types of mail
+ servers, which handle user authentication and direct messages from
+ sender to recipient.
+ </para>
+ </glossdef>
+ </glossentry>
+
+
+ <glossentry id="minicard">
+ <glossterm>Minicard:</glossterm>
+ <glossdef>
+ <para>
+ A format for the display of contact data. Similar in appearance
+ to a small business card.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="nautilus">
+ <glossterm>Nautilus:</glossterm>
+ <glossdef>
+ <para>
+ <application>Nautilus</application> is the next generation file
+ manager for <acronym>GNOME</acronym>.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="pop">
+ <glossterm>POP:</glossterm>
+ <glossdef>
+ <para>
+ POP, the Post Office Protocol, is a mechanism for email
+ transport. In contrast to IMAP, it is used only to get mail from
+ a server and store it locally on your hard disk.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="protocol">
+ <glossterm>Protocol:</glossterm>
+ <glossdef>
+ <para>
+ An agreed-upon method of communication, especially one for
+ sending particular types of information between computer systems.
+ Examples include POP (Post Office Protocol), for email, and HTTP
+ (HypterText Transfer Protocol), for web pages.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="postscript">
+ <glossterm>Postscript:</glossterm>
+ <glossdef>
+ <para>
+ A standard document publishing format. Many printers read raw
+ Postscript, making Postscript quite versatile.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="public-key-encryption">
+ <glossterm>Public Key Encryption:</glossterm>
+ <glossdef>
+ <para>
+ A strong encryption method that uses a set of two "keys," one of
+ which is made public, and one of which is kept private. Data
+ encrypted using the public key can only be decrypted using the
+ private key. The longer the keys, the more difficult it is to
+ break the encryption.
+ </para>
+ </glossdef>
+ </glossentry>
+
+
+
+ <glossentry id="regular-expression">
+ <glossterm>Regular Expression:</glossterm>
+ <glossdef>
+ <para>
+ A regular expression, or "regex", is a way of describing a
+ string of text using metacharacters or wild-card symbols. For
+ example, the statement <userinput>fly.*so[au]p</userinput> means
+ "any phrase beginning with 'fly' and ending in 'soup' or
+ 'soap'". If you searched for that expression, you'd find both
+ "fly in my soup" and "fly in my soap." There's not room here to
+ go into depth, but if you want, have a look at the documentation
+ for the <command>grep</command> command by opening a command
+ line and typing in <command>man grep</command>.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="script">
+ <glossterm>Script:</glossterm>
+ <glossdef>
+ <para>
+ A program written in an interpreted (rather than compiled)
+ language. Often used as a synonym for "macro," to denote a series
+ of pre-recorded commands or actions within an application. Often
+ times, accomplish repetitive and tedious tasks, to save the
+ user time.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="search-base">
+ <glossterm>Search Base:</glossterm>
+ <glossdef>
+ <para>
+ LDAP can break contact lists into many groups. The Search
+ Base tells LDAP the top group to use. How much of the Search
+ Base that is searched is set by the <glossterm
+ linkend="search-scope">Search Scope</glossterm> option.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="search-scope">
+ <glossterm>Search Scope:</glossterm>
+ <glossdef>
+ <para>
+ Search Scope states how much of the <glossterm
+ linkend="search-base">Search Base</glossterm> to search.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="sendmail">
+ <glossterm>Sendmail:</glossterm>
+ <glossdef>
+ <para>
+ As its name implies, <application>sendmail</application> is a
+ program which sends mail. <application>Evolution</application>
+ can use it instead of <glossterm>SMTP:</glossterm>; some people
+ prefer it because it offers more flexibility, but is more
+ difficult to set up.
+ </para>
+ </glossdef>
+ </glossentry>
+
+
+ <glossentry id="shortcut-bar">
+ <glossterm>Shortcut Bar:</glossterm>
+ <glossdef>
+ <para>
+ A portion of <application>Evolution</application> which offers
+ users fast access to the most frequently used portions of the
+ application.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="signature">
+ <glossterm>Signature:</glossterm>
+ <glossdef>
+ <para>
+ In email terms, a signature is a piece of text placed at the end
+ of every email sent, similar to a hand-written signature at the bottom
+ of a written letter. A signature can be anything from a favorite
+ quotation to a link to a web page; courtesy dictates that it be
+ fewer than four lines long.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="SMTP">
+ <glossterm>SMTP:</glossterm>
+ <glossdef>
+ <para>
+ This is the most common way of transporting mail messages from
+ the client's computer (you) to the server. SMTP stands for
+ Simple Mail Transfer Protocol.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="tooltip">
+ <glossterm>Tool-Tip:</glossterm>
+ <glossdef>
+ <para>
+ A small box of explanatory text which appears when the mouse
+ pointer is held motionless over a button or other interface
+ element.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="virus">
+ <glossterm>Virus:</glossterm>
+ <glossdef>
+ <para>
+ A program which inserts itself into other files or programs and
+ which, when executed, spreads to more programs and other
+ computers. A virus can cause substantial damage by clogging
+ networks or disk drives, deleting files, or opening security
+ holes.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="vcard">
+ <glossterm>VCard:</glossterm>
+ <glossdef>
+ <para>
+ A file format for the exchange of contact information. When you
+ get an address card attached to an email, it's probably in VCard
+ format. Not to be confused with <glossterm
+ linkend="vfolder">vFolder:</glossterm>.
+ </para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry id="vfolder">
+ <glossterm>vFolder:</glossterm>
+ <glossdef>
+ <para>
+ An email organization tool. vFolders allows you to create a folder
+ that contains the results of a complex search. vFolder contents are
+ are updated dynamically.
+ </para>
+ </glossdef>
+ </glossentry>
+
+</glossary>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/help/C/apx-gpl.sgml b/help/C/apx-gpl.sgml
new file mode 100644
index 0000000000..8404e9ff3c
--- /dev/null
+++ b/help/C/apx-gpl.sgml
@@ -0,0 +1,417 @@
+<appendix id="apx-gpl">
+<title>GNU General Public License</title>
+<para>
+Copyright (c) 2000 Free Software Foundation, Inc.
+ <address>Free Software Foundation, Inc.
+ <street>59 Temple Place, Suite 330</street>,
+ <city>Boston</city>,
+ <state>MA</state> <postcode>02111-1307</postcode>
+ <country>USA</country>
+ </address>.
+ </para>
+
+<para>
+This is version 2
+</para>
+
+ <para>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+ </para>
+
+
+ <sect1 id="preamble">
+ <title>Preamble</title>
+
+ <para>
+ The licenses for most software are designed to take away your
+ freedom to share and change it. By contrast, the GNU General Public
+ License is intended to guarantee your freedom to share and change
+ free software - to make sure the software is free for all its users.
+ This General Public License applies to most of the Free Software
+ Foundation's software and to any other program whose authors commit
+ to using it. (Some other Free Software Foundation software is covered
+ by the GNU Library General Public License instead.) You can apply it
+ to your programs, too.
+ </para>
+
+ <para>
+ When we speak of free software, we are referring to freedom, not price.
+ Our General Public Licenses are designed to make sure that you have the
+ freedom to distribute copies of free software (and charge for this
+ service if you wish), that you receive source code or can get it if you
+ want it, that you can change the software or use pieces of it in new free
+ programs; and that you know you can do these things.
+ </para>
+
+ <para>
+ To protect your rights, we need to make restrictions that forbid anyone
+ to deny you these rights or to ask you to surrender the rights. These
+ restrictions translate to certain responsibilities for you if you distribute
+ copies of the software, or if you modify it.
+ </para>
+
+ <para>
+ For example, if you distribute copies of such a program, whether gratis or
+ for a fee, you must give the recipients all the rights that you have. You
+ must make sure that they, too, receive or can get the source code. And you
+ must show them these terms so they know their rights.
+ </para>
+
+ <para>
+ We protect your rights with two steps:
+
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>
+ copyright the software, and
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ offer you this license which gives you legal permission to copy,
+ distribute and/or modify the software.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+
+ <para>
+ Also, for each author's protection and ours, we want to make certain that
+ everyone understands that there is no warranty for this free software. If
+ the software is modified by someone else and passed on, we want its
+ recipients to know that what they have is not the original, so that any
+ problems introduced by others will not reflect on the original authors'
+ reputations.
+ </para>
+
+ <para>
+ Finally, any free program is threatened constantly by software patents.
+ We wish to avoid the danger that redistributors of a free program will
+ individually obtain patent licenses, in effect making the program
+ proprietary. To prevent this, we have made it clear that any patent must be
+ licensed for everyone's free use or not licensed at all.
+ </para>
+
+ <para>
+ The precise terms and conditions for copying, distribution and modification
+ follow.
+ </para>
+
+ </sect1>
+
+ <sect1 id="terms">
+ <title>TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION</title>
+
+ <sect2 id="sect0">
+ <title>Section 0</title>
+ <para>
+ This License applies to any program or other work which contains a notice
+ placed by the copyright holder saying it may be distributed under the terms
+ of this General Public License. The "Program", below, refers to any such
+ program or work, and a <quote>work based on the Program</quote> means either
+ the Program or any derivative work under copyright law: that is to say, a
+ work containing the Program or a portion of it, either verbatim or with
+ modifications and/or translated into another language. (Hereinafter, translation
+ is included without limitation in the term <quote>modification</quote>.) Each
+ licensee is addressed as <quote>you</quote>.
+ </para>
+
+ <para>
+ Activities other than copying, distribution and modification are not covered by
+ this License; they are outside its scope. The act of running the Program is not
+ restricted, and the output from the Program is covered only if its contents
+ constitute a work based on the Program (independent of having been made by running
+ the Program). Whether that is true depends on what the Program does.
+ </para>
+ </sect2>
+
+ <sect2 id="sect1">
+ <title>Section 1</title>
+ <para>
+ You may copy and distribute verbatim copies of the Program's source code as you
+ receive it, in any medium, provided that you conspicuously and appropriately
+ publish on each copy an appropriate copyright notice and disclaimer of warranty;
+ keep intact all the notices that refer to this License and to the absence of any
+ warranty; and give any other recipients of the Program a copy of this License
+ along with the Program.
+ </para>
+
+ <para>
+ You may charge a fee for the physical act of transferring a copy, and you may at
+ your option offer warranty protection in exchange for a fee.
+ </para>
+ </sect2>
+
+ <sect2 id="sect2">
+ <title>Section 2</title>
+ <para>
+ You may modify your copy or copies of the Program or any portion of it, thus
+ forming a work based on the Program, and copy and distribute such modifications
+ or work under the terms of <link linkend="sect1">Section 1</link> above, provided
+ that you also meet all of these conditions:
+
+ <orderedlist numeration="loweralpha">
+ <listitem>
+ <para>
+ You must cause the modified files to carry prominent notices stating that
+ you changed the files and the date of any change.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ You must cause any work that you distribute or publish, that in whole or
+ in part contains or is derived from the Program or any part thereof, to be
+ licensed as a whole at no charge to all third parties under the terms of
+ this License.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If the modified program normally reads commands interactively when run, you
+ must cause it, when started running for such interactive use in the most
+ ordinary way, to print or display an announcement including an appropriate
+ copyright notice and a notice that there is no warranty (or else, saying
+ that you provide a warranty) and that users may redistribute the program
+ under these conditions, and telling the user how to view a copy of this
+ License.
+
+ <note>
+ <title>Exception:</title>
+ <para>
+ If the Program itself is interactive but does not normally print such an
+ announcement, your work based on the Program is not required to print an
+ announcement.)
+ </para>
+ </note>
+
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+
+ <para>
+ These requirements apply to the modified work as a whole. If identifiable sections
+ of that work are not derived from the Program, and can be reasonably considered
+ independent and separate works in themselves, then this License, and its terms,
+ do not apply to those sections when you distribute them as separate works. But when
+ you distribute the same sections as part of a whole which is a work based on the
+ Program, the distribution of the whole must be on the terms of this License, whose
+ permissions for other licensees extend to the entire whole, and thus to each and
+ every part regardless of who wrote it.
+ </para>
+
+ <para>
+ Thus, it is not the intent of this section to claim rights or contest your rights
+ to work written entirely by you; rather, the intent is to exercise the right to control
+ the distribution of derivative or collective works based on the Program.
+ </para>
+
+ <para>
+ In addition, mere aggregation of another work not based on the Program with the Program
+ (or with a work based on the Program) on a volume of a storage or distribution medium
+ does not bring the other work under the scope of this License.
+ </para>
+ </sect2>
+
+ <sect2 id="sect3">
+ <title>Section 3</title>
+
+ <para>
+ You may copy and distribute the Program (or a work based on it, under
+ <link linkend="sect2">Section 2</link> in object code or executable form under the terms of
+ <link linkend="sect1">Sections 1</link> and <link linkend="sect2">2</link> above provided that
+ you also do one of the following:
+
+ <orderedlist numeration="loweralpha">
+ <listitem>
+ <para>
+ Accompany it with the complete corresponding machine-readable source code, which
+
+ must be distributed under the terms of Sections 1 and 2 above on a medium
+ customarily used for software interchange; or,
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Accompany it with a written offer, valid for at least three years, to give any
+ third party, for a charge no more than your cost of physically performing source
+ distribution, a complete machine-readable copy of the corresponding source code,
+ to be distributed under the terms of Sections and above on a medium customarily
+ used for software interchange; or,
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Accompany it with the information you received as to the offer to distribute
+ corresponding source code. (This alternative is allowed only for noncommercial
+ distribution and only if you received the program in object code or executable form
+ with such an offer, in accord with Subsection b above.)
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+
+ <para>
+ The source code for a work means the preferred form of the work for making modifications
+ to it. For an executable work, complete source code means all the source code for all modules
+ it contains, plus any associated interface definition files, plus the scripts used to control
+ compilation and installation of the executable. However, as a special exception, the source
+ code distributed need not include anything that is normally distributed (in either source or
+ binary form) with the major components (compiler, kernel, and so on) of the operating system
+ on which the executable runs, unless that component itself accompanies the executable.
+ </para>
+
+ <para>
+ If distribution of executable or object code is made by offering access to copy from a
+ designated place, then offering equivalent access to copy the source code from the same place
+ counts as distribution of the source code, even though third parties are not compelled to
+ copy the source along with the object code.
+ </para>
+ </sect2>
+
+ <sect2 id="sect4">
+ <title>Section 4</title>
+
+ <para>
+ You may not copy, modify, sublicense, or distribute the Program except as expressly provided
+ under this License. Any attempt otherwise to copy, modify, sublicense or distribute the
+ Program is void, and will automatically terminate your rights under this License. However,
+ parties who have received copies, or rights, from you under this License will not have their
+ licenses terminated so long as such parties remain in full compliance.
+ </para>
+ </sect2>
+
+ <sect2 id="sect5">
+ <title>Section 5</title>
+
+ <para>
+ You are not required to accept this License, since you have not signed it. However, nothing
+ else grants you permission to modify or distribute the Program or its derivative works.
+ These actions are prohibited by law if you do not accept this License. Therefore, by modifying
+ or distributing the Program (or any work based on the Program), you indicate your acceptance
+ of this License to do so, and all its terms and conditions for copying, distributing or
+ modifying the Program or works based on it.
+ </para>
+ </sect2>
+
+ <sect2 id="sect6">
+ <title>Section 6</title>
+
+ <para>
+ Each time you redistribute the Program (or any work based on the Program), the recipient
+ automatically receives a license from the original licensor to copy, distribute or modify
+ the Program subject to these terms and conditions. You may not impose any further restrictions
+ on the recipients' exercise of the rights granted herein. You are not responsible for enforcing
+ compliance by third parties to this License.
+ </para>
+ </sect2>
+
+ <sect2 id="sect7">
+ <title>Section 7</title>
+
+ <para>
+ If, as a consequence of a court judgment or allegation of patent infringement or for any other
+ reason (not limited to patent issues), conditions are imposed on you (whether by court order,
+ agreement or otherwise) that contradict the conditions of this License, they do not excuse you
+ from the conditions of this License. If you cannot distribute so as to satisfy simultaneously
+ your obligations under this License and any other pertinent obligations, then as a consequence
+ you may not distribute the Program at all. For example, if a patent license would not permit
+ royalty-free redistribution of the Program by all those who receive copies directly or
+ indirectly through you, then the only way you could satisfy both it and this License would be
+ to refrain entirely from distribution of the Program.
+ </para>
+
+ <para>
+ If any portion of this section is held invalid or unenforceable under any particular circumstance,
+ the balance of the section is intended to apply and the section as a whole is intended to apply
+ in other circumstances.
+ </para>
+
+ <para>
+ It is not the purpose of this section to induce you to infringe any patents or other property
+ right claims or to contest validity of any such claims; this section has the sole purpose of
+ protecting the integrity of the free software distribution system, which is implemented by public
+ license practices. Many people have made generous contributions to the wide range of software
+ distributed through that system in reliance on consistent application of that system; it is up
+ to the author/donor to decide if he or she is willing to distribute software through any other
+ system and a licensee cannot impose that choice.
+ </para>
+
+ <para>
+ This section is intended to make thoroughly clear what is believed to be a consequence of the
+ rest of this License.
+ </para>
+ </sect2>
+
+ <sect2 id="sect8">
+ <title>Section 8</title>
+
+ <para>
+ If the distribution and/or use of the Program is restricted in certain countries either by patents
+ or by copyrighted interfaces, the original copyright holder who places the Program under this License
+ may add an explicit geographical distribution limitation excluding those countries, so that
+ distribution is permitted only in or among countries not thus excluded. In such case, this License
+ incorporates the limitation as if written in the body of this License.
+ </para>
+ </sect2>
+
+ <sect2 id="sect9">
+ <title>Section 9</title>
+
+ <para>
+ The Free Software Foundation may publish revised and/or new versions of the General Public License
+ from time to time. Such new versions will be similar in spirit to the present version, but may differ
+ in detail to address new problems or concerns.
+ </para>
+
+ <para>
+ Each version is given a distinguishing version number. If the Program specifies a version number of
+ this License which applies to it and "any later version", you have the option of following the terms
+ and conditions either of that version or of any later version published by the Free Software
+ Foundation. If the Program does not specify a version number of this License, you may choose any
+ version ever published by the Free Software Foundation.
+ </para>
+ </sect2>
+
+ <sect2 id="sect10">
+ <title>Section 10</title>
+
+ <para>
+ If you wish to incorporate parts of the Program into other free programs whose distribution
+ conditions are different, write to the author to ask for permission. For software which is copyrighted
+ by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions
+ for this. Our decision will be guided by the two goals of preserving the free status of all
+ derivatives of our free software and of promoting the sharing and reuse of software generally.
+ </para>
+ </sect2>
+
+ <sect2 id="sect11">
+ <title>NO WARRANTY</title>
+ <subtitle>Section 11</subtitle>
+
+ <para>
+ BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT
+ PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+ OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
+ INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
+ PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+ </para>
+ </sect2>
+
+ <sect2 id="sect12">
+ <title>Section 12</title>
+
+ <para>
+ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR
+ ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU
+ FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+ USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
+ INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH
+ ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+ DAMAGES.
+ </para>
+ </sect2>
+ </sect1>
+ </appendix> \ No newline at end of file
diff --git a/help/C/config-prefs.sgml b/help/C/config-prefs.sgml
new file mode 100644
index 0000000000..a608dea6f6
--- /dev/null
+++ b/help/C/config-prefs.sgml
@@ -0,0 +1,936 @@
+<!--
+<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
+-->
+<chapter id="config-prefs">
+
+ <title>Advanced Configuration</title>
+ <para>
+ Perhaps your mail server has changed names. Perhaps you've
+ grown tired of a certain layout for your appointments.
+ Whatever the reason, you want to change your
+ <application>Evolution</application> settings. This chapter
+ will tell you how to do just that.
+ </para>
+ <para>
+ Evolution 1.2 brings with it a redesigned comprehensive
+ settings window that you can open by choosing <menuchoice>
+ <guimenu>Tools</guimenu>
+ <guimenuitem>Configure</guimenuitem></menuchoice>, no matter
+ where you are in Evolution. On the left half of the settings
+ window is a column, similar to the Evolution shortcut bar,
+ which lets you choose which portion of Evolution to
+ customize. The right half of the window is where you'll make
+ your actual changes.
+ </para>
+
+
+ <!-- ==============Figure===================== -->
+ <figure id="config-prefs-mail-fig">
+ <title>Changing Mail Settings</title>
+ <screenshot>
+ <screeninfo>Changing Mail Settings</screeninfo>
+ <mediaobject><imageobject><imagedata fileref="figures/config-mail" format="png" srccredit="Aaron Weber">
+ </imageobject></mediaobject>
+ </screenshot>
+ </figure>
+ <!-- ==============End of Figure================-->
+
+ <para>
+ There are eight items you can customize. From top to bottom, they
+ are:
+ <variablelist>
+ <varlistentry>
+ <term>Mail Accounts</term>
+ <listitem>
+ <para>
+ Here, add or change information about your email
+ accounts: the servers to which you connect, the way you
+ download mail, your password authentication mode, and so
+ forth. This is the most complex item in the list, and is
+ covered in <xref linkend="config-prefs-mail-identity">.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Folder Settings</term>
+ <listitem>
+ <para>
+ Here, you can choose the default folders for various
+ components of Evolution, the folders that will be cached
+ locally when you go to offline mode, and the folders that
+ Evolution will use when it is searching for
+ autocompletion information as you address a mail.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Mail Preferences</term>
+ <listitem>
+ <para>
+ These are overall mail reading preferences: display
+ settings, notification options, security, and so
+ forth. These are covered in <xref
+ linkend="config-prefs-mail-display">.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Composer Preferences</term>
+ <listitem>
+ <para>
+ Settings for the way that you use the mail composer:
+ shortcuts, signatures, spelling, and so forth. One fun
+ feature here is the ability to substitute graphical
+ smiley-faces for "emoticons" such as :) that many people
+ use in email. This tool is covered in <xref
+ linkend="config-prefs-mail-composer">.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Calendar and Tasks</term>
+ <listitem>
+ <para>
+ Here, you can set the way the calendar behaves, including
+ your time zone and the length of your work-week.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Directory Servers</term>
+ <listitem>
+ <para>
+ If you want to use a shared directory server (LDAP
+ server), this is the place to set it up.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Font Preferences</term>
+ <listitem>
+ <para>
+ Choose the fonts that Evolution will use to display email
+ here.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Summary Preferences</term>
+ <listitem>
+ <para>
+ Set the mail folders, news feeds, schedule summary
+ length, and weather locations to be displayed here. For
+ news feeds, enter the web address of any RDF file.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </para>
+
+ <sect1 id="config-prefs-mail">
+ <title>Mail Settings</title>
+ <para>
+ The first few tools, with the exception of the folder tool,
+ cover mail tasks:
+ </para>
+
+ <sect2 id="config-prefs-mail-identity">
+ <title>Working with Mail Accounts</title>
+ <para>
+ <application>Ximian Evolution</application> allows you to
+ maintain multiple accounts, or identities. This is useful
+ want to keep personal and professional email separate, or if
+ you wear several hats at work. When you are writing an email
+ message, you can which account to use by selecting from the
+ drop-down list next to the <guilabel>From</guilabel> entry in
+ the message composer.
+ </para>
+
+ <para>
+ Clicking <guibutton>Get Mail</guibutton> will refresh any
+ IMAP, <filename>mh</filename>, or
+ <filename>mbox</filename> listings
+ and check and download mail from all POP servers. In other
+ words, <guibutton>Get Mail</guibutton> gets your mail, no
+ matter how many sources you have, or what types they are. If
+ you don't want to check mail for a given account, select it
+ in the <guilabel>Accounts</guilabel> tab and click the
+ <guibutton>Disable</guibutton> button.
+ </para>
+
+ <para>
+ To add a new account, simply click <guibutton>Add</guibutton>
+ to open the mail configuration assistant. To alter an
+ existing identity, select it in the
+ <interface>Preferences</interface> window, and then click
+ <guibutton>Edit</guibutton> to open the account editor
+ dialog.
+ </para>
+
+ <para>
+ The account editor dialog has six sections:
+ <variablelist>
+
+ <varlistentry>
+ <term>Identity:</term>
+ <listitem>
+ <para>
+ Here, enter the name,
+ email address, and other identifying information for the
+ account.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Receiving Mail</term>
+ <listitem>
+ <para>
+ Here, select the way you will be getting mail: you may
+ download mail from a server (<glossterm
+ linkend="pop">POP</glossterm>), read and keep it on the
+ server (Microsoft Exchange or <glossterm
+ linkend="imap">IMAP</glossterm>), or read it from files
+ that already exist on your desktop computer. If you use
+ a server, it may permit or require you to use a Secure
+ Socket Layer (SSL) connection. To turn SSL connections
+ on, just click the <guibutton>Use Secure Connection
+ (SSL)</guibutton> button.
+
+<note id="config-arbitrary-port">
+<title>Specifying Port Numbers</title>
+<para>
+Your system administrator may ask you to connect to a specific port on
+a mail server. To specify which port you use, just type a colon and
+the port number after the server name. For example, to connect to port
+143 on the server smtp.omniport.com, you would enter
+as
+<userinput>
+smtp.omniport.com:143
+</userinput> as the server name.
+</para>
+</note>
+
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Receiving Options</term>
+ <listitem>
+ <para>
+ Here, decide whether you'd like to check for mail
+ automatically and how often, as well as other message
+ retrieval options.
+
+ <variablelist>
+ <varlistentry>
+ <term>If you chose POP:</term>
+ <listitem>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>Checking for new mail: If you would
+ like <application>Evolution</application>
+ to check for new mail automatically,
+ check the box and select a frequency in
+ minutes.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Message Storage: If you'd like to store
+ copies of your mail on the server, check
+ this option.
+ </para>
+ </listitem>
+
+
+ <listitem>
+ <para>Store Store status headers in
+ Elm/Pine/Mutt format: If you would like to
+ use the X-Status header format used by the
+ mail clients Elm, Pine, and Mutt, select
+ this option. This option is useful if you
+ plan to check your mail with those clients
+ from time to time.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>If you chose Microsoft Exchange:</term>
+ <listitem>
+ <para>
+
+ <itemizedlist> <listitem>
+ <para>Checking for new mail: If you would like
+ <application>Evolution</application> to check for new mail
+ automatically, check the box and select a frequency in
+ minutes.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Exchange Server: If your active directory user name
+ is different from your Exchange mail user name, check this
+ box and enter your mail username here.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Create a Global Address List folder: If you would
+ like to have a separate folder for the Active Directory's
+ Global Address List, leave this box checked. </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Active Directory Server Name: In most organizations,
+ the Active Directory server will be different from
+ the Exchange mail server. If so, check the box and
+ enter the Active Directory server name here.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Limit number of Responses: Select a maximum number
+ of results for an address search. A maximum number of
+ results limits the load on your system and on your network.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>If you chose IMAP:</term>
+ <listitem>
+ <para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Checking for new mail: If you would like
+ <application>Evolution</application> to check for new mail
+ automatically, check the box and select a frequency in
+ minutes.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>If you want <application>Evolution</application>
+ to check for new messages in <emphasis>all</emphasis> your
+ IMAP folders, make sure the <guilabel>Check for new
+ messages in all folders</guilabel> box is selected.</para>
+ </listitem>
+
+ <listitem>
+ <para>Show only subscribed folders: Check this box if you
+ have more folders in your IMAP view than you want to
+ read.</para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Override server-supplied namespace: If you like, enter a
+ specific directory where your server stores mail for
+ you. Typical values are "mail" and "Mail." For more
+ information about how to use IMAP mail, see <xref
+ linkend="usage-mail-subscriptions">.</para>
+ </listitem>
+
+ <listitem>
+ <para>Apply filters to new messages in INBOX on this
+ server: If you'd like your filters to work on this account
+ as well as on locally downloaded mail, check this box.</para>
+ </listitem>
+
+ <listitem>
+ <para>Store Store status headers in Elm/Pine/Mutt format:
+ If you would like to use the X-Status header format used
+ by the mail clients Elm, Pine, and Mutt, select this
+ option. This option is useful if you plan to check your
+ mail with those clients from time to time.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ </variablelist>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Sending Mail</term>
+ <listitem>
+ <para>
+ In this section, you will choose and configure a method
+ for sending mail. You may choose <glossterm
+ linkend="smtp">SMTP</glossterm>, Microsoft Exchange (if
+ you have purchased the Ximian Connector for Microsoft
+ Exchange) or <glossterm
+ linkend="sendmail">sendmail</glossterm>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Special Folders</term>
+ <listitem>
+ <para>
+ Here, you can decide where this account will store the
+ messages that it has sent, and the messages that you
+ save as drafts.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Security</term>
+ <listitem>
+ <para>
+ In this section, you will set the security options for
+ this account. Enter your PGP Key ID and decide how
+ frequently to encrypt and sign your messages. You can
+ learn more about PGP and encryption in <xref
+ linkend="encryption">.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </sect2>
+
+
+ <sect2 id="config-prefs-mail-display">
+ <title>Mail Display Options</title>
+ <para>
+ In this tab you can decide how you would like
+ <application>Ximian Evolution</application> to display your
+ mail: how to display citations, how long to wait before
+ marking a message as read, and so forth.
+ </para>
+ <para>
+ This is also where you can decide how you would like
+ <application>Ximian Evolution</application> to handle inline
+ images in HTML mail that you get. There is a detailed
+ discussion of the issues surrounding these options in <xref
+ linkend="usage-mail-getnsend-get-attach-html">.
+ </para>
+ <para>
+ To change the font which <application>Ximian
+ Evolution</application> uses to display mail, do the
+ following:
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>
+ Open the Evolution preferences dialog by selecting
+ <menuchoice> <guimenu>Tools</guimenu>
+ <guimenuitem>Settings</guimenuitem> </menuchoice>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Select the <guilabel>Font Settings</guilabel> portion of the
+ settings dialog.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Choose the font and font size you would like to use.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+
+ <sect2 id="config-prefs-mail-composer">
+ <title>Message Composer Preferences</title>
+ <para>
+ There are three whole tabs of settings you can change for the
+ message composer. The General tab covers shortcuts and
+ assorted behavior, and the other two control signatures and
+ spell checking. In the General tab, you can set:
+
+ <variablelist>
+
+ <varlistentry>
+ <term>Shortcuts Type</term>
+ <listitem>
+ <para>
+ Choose a keyboard shortcut scheme: do you prefer
+ keyboard shortcuts similar to those of Microsoft
+ Windows, XEmacs, or Emacs?
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Default Behavior</term>
+ <listitem>
+ <para>
+ Choose how you will normally forward and reply
+ messages, what character set they will use, whether
+ they will be in HTML, and whether that HTML can
+ contain smiley face images.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>Alerts</term>
+ <listitem>
+ <para>
+ There are two optional alerts here:
+ <variablelist>
+ <varlistentry>
+ <term>Prompt when sending messages with an empty subject</term>
+ <listitem>
+ <para>
+ The composer will warn you if you try to send a
+ message without a subject.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Prompt when sending messages with only Bcc recipients defined</term>
+ <listitem>
+ <para>
+ The composer will warn you if you try to send a
+ message that has only <guilabel>Bcc</guilabel>
+ recipients. This is important because some mail
+ servers will fail to honor blind carbon copy if you
+ do not have at least one recipient that is visible to
+ all readers.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+
+ <para>
+ The signature editor is new for Evolution 1.2. It allows you
+ to create several different signatures in plain text or in
+ HTML, and to specify which of them will be added to emails
+ you create in the message composer. If you prefer to use an
+ alternate signature or none at all, you can select it from
+ the mail composer itself.
+ </para>
+ <para>
+ In the spell-checking tool, you can set spelling options,
+ including the language or languages you will use. Note that you
+ must install the gnome-spell package, available through Red
+ Carpet, for spell-checking to be available in
+ Evolution. Alternate dictionaries are also available through
+ Red Carpet and are detected automatically if you have installed
+ them.
+ </para>
+ </sect2>
+
+
+<!-- NOT FOR 1.0, see usage-mail.sgml
+ <sect1 id="config-prefs-news">
+ <title>News Servers</title>
+ <para>
+ Newsgroups are so much like mailing lists that there's no
+ reason not to keep them right next to your mail. When you
+ first select the <guilabel>News Servers</guilabel> tab,
+ you will see a blank box with the three familiar buttons
+ on the right: <guibutton>Add</guibutton>,
+ <guibutton>Edit</guibutton>, and
+ <guibutton>Delete</guibutton>.
+ </para>
+ <para>
+ Click <guibutton>Add</guibutton> to add a news server; you
+ will be prompted for its name. Enter the name, click
+ <guibutton>OK</guibutton>, and you're done. You can have
+ as many news servers as you like, of course. News servers
+ will appear next to your IMAP servers in the
+ <interface>folder bar</interface>.
+ </para>
+ </sect2>
+-->
+ </sect1>
+
+ <sect1 id="config-prefs-cal">
+ <title>Calendar and Task List Settings</title>
+ <para>
+ The calendar configuration tool has two tabs
+ <guilabel>General</guilabel> and
+ <guilabel>Display</guilabel>, and is illustrated in <xref
+ linkend="config-prefs-cal-fig">.
+
+ <!-- ==============Figure===================== -->
+ <figure id="config-prefs-cal-fig">
+ <title>Calendar Preferences Dialog</title>
+ <screenshot>
+ <screeninfo>Calendar Configuration</screeninfo>
+ <mediaobject><imageobject><imagedata fileref="figures/config-cal" format="png" srccredit="Aaron Weber">
+ </imageobject></mediaobject>
+ </screenshot>
+ </figure>
+ <!-- ==============End of Figure================-->
+ </para>
+
+ <para>
+ The <guilabel>General</guilabel> tab lets you set the
+ following:
+ <variablelist>
+ <varlistentry>
+ <term>Time zone</term>
+ <listitem>
+ <para>
+ The city you're located in, to judge your time zone.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Time format</term>
+ <listitem>
+ <para>You may choose between twelve-hour (AM/PM) and
+ twenty-four hour time formats here by clicking the
+ appropriate radio button.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Work Week</term>
+ <listitem>
+ <para>
+ When does your work day start, and when does it end?
+ In the day and week views,
+ <application>Evolution</application> displays all the
+ hours in the range you select here, even if there are
+ no appointments for those times. Of course, you can
+ still schedule an appointment outside of these hours,
+ and if you do, the display will be extended to show
+ it.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>First day of the week</term>
+ <listitem>
+ <para>You can set weeks to start on Sunday or on Monday.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Start of day</term>
+ <listitem>
+ <para>
+ Says what time of the day your weekday starts. This
+ will show all times till the end of the day,
+ regardless of there is an appointment during the time
+ period.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>End of day</term>
+ <listitem>
+ <para>
+ Sets the time the day ends at.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>Alerts</term>
+ <listitem>
+ <para>
+ If you'd like to be warned before you delete any
+ appointment, or to have a reminder automatically
+ appear for each event, select the check boxes here.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+
+ <para>
+ The <interface>Display</interface> section lets you choose how
+ your appointments and tasks will appear in your calendar.
+ </para>
+ <para>The display properties you can set are:
+
+ <variablelist>
+ <varlistentry>
+ <term>Time divisions</term>
+ <listitem>
+ <para>
+ Sets the increments shown on the daily view in the
+ calendar. You can set this to be anywhere from five
+ minutes to an hour, in five minute increments.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Show appointment end times in week and month views</term>
+ <listitem>
+ <para>
+ If there is space,
+ <application>Evolution</application> will show the end
+ times in the week and month views for each
+ appointment.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Compress weekends in month view</term>
+ <listitem>
+ <para>
+ If checked, your weekends will be shown in one box,
+ instead of one for each day in the month view.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Show week numbers in date navigator</term>
+ <listitem>
+ <para>
+ This will show the week numbers next to the respective
+ weeks in the calendar.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Tasks due today</term>
+ <listitem>
+ <para>
+ Configures what color to set your tasks that are due
+ today to.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Overdue tasks</term>
+ <listitem>
+ <para>
+ Choose the color for overdue tasks.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </sect1>
+ <sect1 id="config-prefs-contact">
+ <title>Managing the Addressbook</title>
+ <para>
+ Addressbook settings are limited to the usage and
+ configuration of directory servers (LDAP and
+ Exchange). Contact folders for the mailer's autocompletion
+ feature are set in the Folders tool above, and all other
+ addressbook controls are available in the addressbook window
+ itself.
+ </para>
+
+ <sect2 id="config-prefs-contact-ldap-add">
+ <title>Adding Directory Servers</title>
+ <para>
+ To add a new <glossterm linkend="ldap">LDAP</glossterm> server
+ to your available contact folders:
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>
+ Select
+ <menuchoice>
+ <guimenu>Tools</guimenu>
+ <guimenuitem>Settings</guimenuitem>
+ </menuchoice>
+ and then click the <guilabel>Directory
+ Servers</guilabel> button in the settings dialog that appears.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click the <guibutton>Add</guibutton> button on the right
+ side to open a Directory Server addition assistant.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Enter the information requested by the assistant:
+ <variablelist>
+
+ <varlistentry>
+ <term>Server name</term>
+ <listitem>
+ <para>
+ Address of the server where the addressbook is located.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Login Method</term>
+ <listitem>
+ <para>
+ Specify whether your login is anonymous, using
+ an email address, or a "distinguished name." If
+ the login is not anonymous, enter the login name
+ required by the server.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Port</term>
+ <listitem>
+ <para>
+ The internet port
+ <application>Evolution</application> connects to
+ in order to access the LDAP database. This is
+ normally 389.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Use SSL/TLS</term>
+ <listitem>
+ <para>
+ SSL and TLS are security mechanisms. If you
+ select <guilabel>Always</guilabel>, Evolution
+ will not connect unless
+ secure connections are available. The default value is
+ <guilabel>Whenever Possible</guilabel>, which uses
+ secure connections if they are available,
+ but does not cause failure if they are not.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><glossterm linkend="search-base">Search base</glossterm></term>
+ <listitem>
+ <para>
+ The base entry to use for all your searches.
+ Contact your administrator for information about
+ the correct settings.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><glossterm linkend="search-scope">Search scope</glossterm></term>
+ <listitem>
+ <para>
+ How broad the search is in the directory. The
+ following options are available:
+ <variablelist>
+ <varlistentry>
+ <term>One</term>
+ <listitem>
+ <para>
+ Searches the Search Base and one entry
+ below it.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Sub</term>
+ <listitem>
+ <para>
+ Searches the Search Base and all entries
+ below it.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Timeout Limit</term>
+ <listitem>
+ <para>
+ This is the maximum time Evolution will attempt to
+ download data from the server before giving up.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>Download Limit</term>
+ <listitem>
+ <para>
+ Set the maximum number of results for a given
+ search. Most servers refuse to send more than
+ 500, but you can set the number lower if you
+ want to shorten downloads for very broad
+ searches.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>Display name</term>
+ <listitem>
+ <para>
+ The name that you see on the screen. This could
+ be anything you wish.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click <guibutton>OK</guibutton>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click <guibutton>OK</guibutton> to permanently make
+ changes or <guibutton>Apply</guibutton> to temporarily
+ set the changes.
+ </para>
+ </listitem>
+ </orderedlist>
+
+
+<!-- Finish this example:
+
+ <example id="ldap-config-example">
+ <title>LDAP Configuration</title>
+ <para>
+ Rich works at omniport.net and needs to access the
+ company's LDAP server so that he can look up the email
+ addresses of his co-workers.
+ </para>
+ <para>
+ He uses his email address, rich@omniport.net,
+ </para>
+ <para>
+ His Server Name is: ldap.wemakechips.com
+ </para>
+ </example>
+-->
+ </para>
+ </sect2>
+ </sect1>
+</chapter> \ No newline at end of file
diff --git a/help/C/config-sync.sgml b/help/C/config-sync.sgml
new file mode 100644
index 0000000000..6a6503a670
--- /dev/null
+++ b/help/C/config-sync.sgml
@@ -0,0 +1,138 @@
+ <chapter id="config-sync">
+ <title>Setting up your synchronization system</title>
+ <para>
+ Synchronization presents you with two issues you'll need to
+ address.
+ <simplelist>
+ <member>
+ Your computer needs to recognize and access your handheld.
+ At this time, <application>Ximian Evolution</application> only
+ supports Palm-OS devices like the Palm Pilot and the
+ Handspring Visor.
+ </member>
+ <member>
+ You should decide what sort of synchronization behavior you
+ want.
+ </member>
+ </simplelist>
+ </para>
+
+ <para>
+ If you haven't used a handheld device with your computer
+ before, you'll need to run the GNOME <application>Control
+ Center</application> by selecting
+ <menuchoice><guimenu>System</guimenu><guimenuitem>Settings</guimenuitem></menuchoice>,
+ and make sure that <application>Pilot Link</application> is
+ properly configured. You will need to make sure that you have
+ read and write permissions on the device, which is normally
+ /dev/pilot. If that does not work, check /dev/ttyS0 if you have
+ a serial connection, or /dev/ttyUSB0 for a USB connection. You
+ can do this by becoming root and running the command:
+ <userinput>chmod 777 /dev/ttyUSB0</userinput>.
+ </para>
+ <para>
+ Once your computer and your Palm-OS device are talking happily
+ to each other, select the <glossterm
+ linkend="conduit">conduits</glossterm> you want under the
+ <guilabel>Pilot Conduits</guilabel> section of the Control
+ Center. You may use conduits to synchronize data with several
+ applications; the <application>Ximian Evolution</application>
+ conduits are labeled <guilabel>EAddress</guilabel>, for the
+ contacts in your addressbook, <guilabel>ECalendar</guilabel>,
+ for your calendar, and <guilabel>ETodo</guilabel>, for your
+ task list.
+ </para>
+ <para>
+ To enable a conduit, click the
+ <guibutton>Enable</guibutton> to enable it, and click
+ <guibutton>Settings</guibutton> to change what it will do when
+ activated. Your options may vary depending on the conduit,
+ but typically they will be:
+
+ <variablelist>
+ <varlistentry>
+ <term>Disabled:</term>
+ <listitem>
+ <para>
+ Do nothing.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Synchronize:</term>
+ <listitem>
+ <para>
+ Copy new data from the computer to the handheld, and
+ from the handheld to the computer. Remove items
+ that were on both systems but have been deleted on
+ one.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Copy From Pilot:</term>
+ <listitem>
+ <para>
+ If there is any new data on the the handheld device,
+ copy it to the computer.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Copy To Pilot:</term>
+ <listitem>
+ <para>
+ Copy new data from the computer to the handheld.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Merge From Pilot:</term>
+ <listitem>
+ <para>
+ Copy new data from the handheld to the computer, and
+ remove any information from the computer that has
+ been deleted on the handheld.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Merge To Pilot:</term>
+ <listitem>
+ <para>
+ Copy new data from the computer to the handheld, and
+ remove any information from the handheld that has
+ been deleted on the computer.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+
+ <para>
+ Select the behavior you want for each conduit you choose to use.
+ If you're not sure, go ahead and stick with
+ <guilabel>Synchronize</guilabel>. Then, put your handheld on
+ its cradle and press the HotSync button.
+ </para>
+ <para>
+ <tip>
+ <title>Data Loss Prevention</title>
+ <para>
+ It's always a good idea to make a backup. To do that,
+ make a copy of the <filename>evolution</filename>
+ directory inside your home directory.
+ </para>
+ </tip>
+ </para>
+
+ </chapter>
+
+
+
+
diff --git a/help/C/evolution-C.omf b/help/C/evolution-C.omf
new file mode 100644
index 0000000000..348238680f
--- /dev/null
+++ b/help/C/evolution-C.omf
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
+<!DOCTYPE omf PUBLIC "-//OMF//DTD Scrollkeeper OMF Variant V1.0//EN" "http://scrollkeeper.sourceforge.net/dtds/scrollkeeper-omf-1.0/scrollkeeper-omf.dtd">
+<omf>
+ <resource>
+ <creator>
+ Ximian, Inc.
+ </creator>
+ <title>
+ Evolution Manual
+ </title>
+ <date>2002</date>
+ <subject category="GNOME|Applications"/>
+ <format mime="text/html"/>
+ <identifier url="index.html"/>
+ <language code="C"/>
+ <relation seriesid="6a2207d8-8aa4-11d6-8cb4-f0bb5a765891"/>
+ </resource>
+</omf>
diff --git a/help/C/evolution.sgml b/help/C/evolution.sgml
new file mode 100644
index 0000000000..5b199c0fae
--- /dev/null
+++ b/help/C/evolution.sgml
@@ -0,0 +1,111 @@
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN"[
+
+<!ENTITY PREFACE SYSTEM "preface.sgml">
+<!ENTITY USAGE-MAINWINDOW SYSTEM "usage-mainwindow.sgml">
+<!ENTITY USAGE-EXEC-SUMMARY SYSTEM "usage-exec-summary.sgml">
+<!ENTITY USAGE-MAIL SYSTEM "usage-mail.sgml">
+<!ENTITY USAGE-MAIL-ORG SYSTEM "usage-mail-org.sgml">
+<!ENTITY USAGE-CONTACT SYSTEM "usage-contact.sgml">
+<!ENTITY USAGE-CALENDAR SYSTEM "usage-calendar.sgml">
+<!ENTITY USAGE-EXCHANGE SYSTEM "usage-exchange.sgml">
+<!ENTITY USAGE-SYNC SYSTEM "usage-sync.sgml">
+<!ENTITY USAGE-PRINT SYSTEM "usage-print.sgml">
+<!ENTITY CONFIG-PREFS SYSTEM "config-prefs.sgml">
+<!ENTITY CONFIG-SYNC SYSTEM "config-sync.sgml">
+<!ENTITY MENUREF SYSTEM "menuref.sgml">
+<!ENTITY APX-GLOSS SYSTEM "apx-gloss.sgml">
+<!ENTITY APX-COMMON-TASKS SYSTEM "apx-common-tasks.sgml">
+<!ENTITY APX-BUGS SYSTEM "apx-bugs.sgml">
+<!ENTITY APX-AUTHORS SYSTEM "apx-authors.sgml">
+<!ENTITY APX-FDL SYSTEM "apx-fdl.sgml">
+<!ENTITY APX-GPL SYSTEM "apx-gpl.sgml">
+
+]>
+
+
+<!-- Almost every chapter is an entity. Files, Chapter id's, and
+entity names correspond. APX is for appendix. -->
+
+<book id="index">
+ <bookinfo>
+ <title>A User's Guide to Ximian Evolution</title>
+ <authorgroup>
+ <author><firstname>Aaron</firstname><surname>Weber</surname></author>
+ <author><firstname>Kevin</firstname><surname>Breit</surname></author>
+ <author><firstname>Ettore</firstname><surname>Perazzoli</surname></author>
+ <author><firstname>Duncan</firstname><surname>Mak</surname></author>
+ </authorgroup>
+ <copyright>
+ <year>2000-2002</year>
+ <holder>Ximian, Inc.</holder>
+ </copyright>
+
+ <legalnotice id="legalnotice">
+ <para>
+ See the preface for legal information regarding the GNU
+ General Public License and Free Documentation License.
+ </para>
+ </legalnotice>
+
+ <releaseinfo>
+ This is version 1.2 of the Ximian Evolution manual. It describes
+ version 1.2 of the Ximian Evolution groupware suite.
+ </releaseinfo>
+
+ </bookinfo>
+
+ &PREFACE;
+
+ <part id="usage">
+ <title>Getting Started with Ximian Evolution</title>
+ <partintro>
+ <para>
+ Part one of the <application>Ximian Evolution</application> manual
+ describes how to use <application>Ximian Evolution</application> for
+ email, contact management, and appointment and task
+ scheduling. You'll find as you go along that there's more
+ than one way to do things, and you can pick whichever method
+ you like best.
+ </para>
+ </partintro>
+
+ &USAGE-MAINWINDOW;
+ &USAGE-EXEC-SUMMARY;
+ &USAGE-MAIL;
+ &USAGE-MAIL-ORG;
+ &USAGE-CONTACT;
+ &USAGE-CALENDAR;
+ &USAGE-EXCHANGE;
+ &USAGE-SYNC;
+ &USAGE-PRINT;
+ </part>
+ <part id="config">
+ <title>Configuring and Managing Ximian Evolution</title>
+ <partintro>
+ <para>
+ <application>Ximian Evolution</application> is highly
+ configurable. Usually, when developers say that, they mean
+ that they didn't test it out thoroughly and have left it to
+ other programmers to "configure" themselves a working
+ system. In the case of <application>Ximian
+ Evolution</application>, "configurable" means that, while you
+ can expect the program to work perfectly well with the default
+ settings, it's also easy to alter its behavior in a wide
+ variety of ways, so that it fits your needs exactly. This
+ part of the book will describe that process, from the quickest
+ glimpse of the Setup Assistant to an in-depth guide to obscure
+ preferences settings.
+ </para>
+ </partintro>
+
+ &CONFIG-PREFS;
+ &CONFIG-SYNC;
+ </part>
+
+ &MENUREF;
+ &APX-GLOSS;
+ &APX-BUGS;
+ &APX-AUTHORS;
+ &APX-FDL;
+ &APX-GPL;
+</book> \ No newline at end of file
diff --git a/help/C/preface.sgml b/help/C/preface.sgml
new file mode 100644
index 0000000000..8de709bde8
--- /dev/null
+++ b/help/C/preface.sgml
@@ -0,0 +1,412 @@
+ <preface id="introduction">
+ <title>Introduction</title>
+
+ <para>
+ Welcome to the users guide for Ximian Evolution and Ximian
+ Connector for Microsoft Exchange 2000. This section of the
+ manual will tell you a bit about what you've got waiting for
+ you. First, however, we have some legal information.
+ </para>
+
+ <sect1 id="actual-legal-info">
+ <title>Legal Information and Licensing</title>
+ <para>
+ Permission is granted to copy, distribute and/or modify this
+ document under the terms of the GNU Free Documentation
+ License, Version 1.1 or any later version published by the
+ Free Software Foundation with no Invariant Sections, no
+ Front-Cover Texts, and no Back-Cover Texts. You will find a
+ copy of the <citetitle>GNU Free Documentation
+ License</citetitle> attached to this manual in <xref
+ linkend="apx-fdl">. You may also obtain a copy of the
+ license from the Free Software Foundation by visiting <ulink
+ type="http" url="http://www.fsf.org">their Web site</ulink>
+ or by writing to: Free Software Foundation, Inc., 59 Temple
+ Place - Suite 330, Boston, MA 02111-1307, USA.
+ </para>
+
+ <para>
+ The actual application Ximian Evolution is covered by the GNU
+ General Public License (GPL), and its source code is
+ available from the GNOME cvs repository at <ulink
+ url="http://cvs.gnome.org">cvs.gnome.org</ulink>. You will
+ find a copy of the GPL attached to this document in <xref
+ linkend="apx-gpl">. You may also obtain a copy of the license
+ from the Free Software Foundation by visiting <ulink
+ type="http" url="http://www.fsf.org">their Web site</ulink>
+ or by writing to: Free Software Foundation, Inc., 59 Temple
+ Place - Suite 330, Boston, MA 02111-1307, USA.
+ </para>
+
+ <para>
+ Ximian Connector for Microsoft Exchange 2000 is not Free
+ Software. There are certain restrictions on its usage, and it
+ may not be redistributed. Before downloading it you must
+ agree to the terms of license, which will be (or have been)
+ presented to you upon download. You may review the terms of
+ license for Ximian Connector at <ulink
+ url="http://support.ximian.com/q?92">http://support.ximian.com/q?92</ulink>.
+ </para>
+ </sect1>
+
+ <sect1 id="organization">
+ <title>How This Book is Organized</title>
+ <para>
+ This book is divided into two parts, with several
+ appendices. The first part is a <link linkend="usage">guided
+ tour</link>, which will explain how to use
+ <application>Evolution</application>. If you are new to
+ <application>Evolution</application> or to groupware in
+ general, this section is for you. The second section, covering
+ <link linkend="config">configuration</link>, is targeted at
+ more advanced users, but anyone who wants to change the way
+ <application>Evolution</application> looks or acts can benefit
+ from reading it.
+ </para>
+ </sect1>
+
+ <sect1 id="typography">
+ <title>Typographical Conventions</title>
+ <para>
+ In this book, we'll mark some words with special typography:
+ <simplelist>
+ <member><application>Applications</application></member>
+ <member><command>Commands</command> you type at the command line</member>
+ <member><guilabel>Labels</guilabel> for buttons and other portions of the graphical interface</member>
+
+ <member> Menu selections look like this:
+ <menuchoice>
+ <guimenu>Menu</guimenu>
+ <guisubmenu>Submenu</guisubmenu>
+ <guimenuitem>Menu Item</guimenuitem>
+ </menuchoice>
+ </member>
+ <member><guibutton>Buttons</guibutton> you can
+ click</member> <member><userinput>Anything you type
+ in</userinput></member> <member><computeroutput>Text
+ output from a computer</computeroutput></member>
+ <member><glossterm linkend="apx-gloss">Words</glossterm>
+ that are defined in the <xref linkend="apx-gloss">.</member>
+ </simplelist>
+</para>
+<para>
+We'll provide assorted bits of additional information in tips set off from the rest of the book, as well.
+
+ <tip id="example-tip">
+ <title>Tip</title>
+ <para>
+ Tips and bits of extra information will look like
+ this.
+ </para>
+ </tip>
+</para>
+
+<para>
+Examples are also set off from the rest of the text. They look like this:
+
+ <example>
+ <title>Example Example</title>
+ <para>
+ This is what an example looks like. We'll provide
+ examples for some of the more complicated tasks you
+ might be performing.
+ </para>
+ </example>
+</para>
+<para>
+Lastly, we'll have warnings, in cases where you should be careful:
+
+ <warning id="example-warning">
+ <title>Example Warning</title>
+ <para>
+ This is what a warning looks like. If there's a chance
+ you'll run into trouble, we'll warn you beforehand.
+ </para>
+ </warning>
+ </para>
+ </sect1>
+
+
+ <sect1 id="other-help">
+ <title>Additional Help Sources</title>
+ <para>
+ You can find additional help in three places. For information
+ about command-line options, open a terminal window and type
+ <command> man evolution</command> or <command>evolution
+ --help</command>. For support, late-breaking news, and errata,
+ visit the Ximian support center at <ulink
+ url="http://support.ximian.com">support.ximian.com</ulink>.
+ </para>
+ </sect1>
+
+ <sect1 id="whats-new-in-one-two">
+ <title>What's New in Evolution 1.2</title>
+ <para>
+ If you're already familiar with Ximian Evolution 1.0, our new
+ version has a lot to add. Here are some of the new and
+ changed features. Ximian Connector for Microsoft Exchange also
+ has new features, which are covered in "new-in-connector-one-two">.
+ <variablelist>
+ <varlistentry>
+ <term>Evolution Settings Interface</term>
+ <listitem>
+ <para>
+ The preferences dialogs have been completely
+ overhauled. There is now a single configuration dialog
+ window for all components of the program, and you can
+ access it from anywhere. To change your preferences,
+ select
+ <menuchoice>
+ <guimenu>
+ Tools
+ </guimenu>
+ <guimenuitem>
+ Preferences
+ </guimenuitem>
+ </menuchoice>. Detailed help for the preferences
+ dialogs has been added to <xref
+ linkend="config-prefs">.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>Mail Composer Autocomplete</term>
+ <listitem>
+ <para>
+ Email addresses in the message composer can now work
+ with LDAP address books. Add your LDAP address book to
+ the list of folders searched for address completion in
+ the <guilabel>Folder Settings</guilabel> section of
+ the Settings dialog.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Performance Improvements</term>
+ <listitem>
+ <para>
+ Startup time has decreased, POP server interactions
+ are more efficient, and indexing of locally cached
+ mail is now faster.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>Mail Composer HTML Improvements</term>
+ <listitem>
+ <para>
+ Pasting into the mail composer from another message
+ or from a web page preserves the HTML formatting of
+ the source document. Multiple levels of reply
+ quotation in messages are clearer and use a vertical
+ blue line on the left side to indicate quotation. Text
+ "smileys" are now automatically converted to small
+ images displaying the appropriate emotion. You can
+ turn this option off in the
+ <guilabel>Composer</guilabel> section of the Settings
+ dialog.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Signature Editor</term>
+ <listitem>
+ <para>
+ There is now a signature editor, which can be used to
+ create plain text or HTML signatures.
+ click the the <guilabel>Signatures</guilabel> tab in
+ the Composer Settings section of the Evolution
+ Settings window.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>Keyboard Navigation Overhaul</term>
+ <listitem>
+ <para>
+ All unmodified letter keys have changed function-- the
+ <keycap>N</keycap> and <keycap>P</keycap> keys, for
+ example, no longer take you to the next you to the
+ next or previous message. Pressing a letter will now
+ take you to the nearest message whose data in the sort
+ column begins with that letter. That is, if you press
+ N and you are sorting your list by sender, you will
+ move to a message from Nadine. If you are sorting by
+ subject, you'll move to the message about
+ nectarines. This should also work in the folder list
+ for folder navigation.
+ </para>
+ <para>
+ This means that the old single letter shortcuts have
+ changed as well. The new shortcuts:
+ <simplelist>
+ <member>
+ <keycap>,</keycap> (comma) and <keycap>.</keycap>
+ (period) are now the keyboard shortcuts for Next
+ and Previous unread messages. You can also use the
+ square brackets <keycap>]</keycap> and
+ <keycap>[</keycap>.
+ </member>
+ <member>
+ <keycap>`</keycap> (backtick) toggles
+ the message preview pane.
+ </member>
+ </simplelist>
+ Shortcuts that use the <keycap>Control</keycap> key
+ have not changed.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Added Functionality for the "New" Button</term>
+ <listitem>
+ <para>
+ The <guibutton>New</guibutton> now has a menu next to
+ it. As in Evolution 1.0, you can click the button once
+ to get a new item for the Evolution tool you're
+ using. However, if you click the small arrow menu to
+ the right of the button, you will find a menu that
+ allows you to create new items for the rest of
+ Evolution: All day appointments, regular appointments,
+ tasks and meetings for the calendar; mail messages for
+ the mail tool; and contacts and contact lists for the
+ address book.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Import Tool Now Imports Netscape Filters</term>
+ <listitem>
+ <para>
+ You can now import your filters, as well as your email
+ messages, from the Netscape mail client.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Folder Naming Internationalization</term>
+ <listitem>
+ <para>
+ You can now use Unicode (UTF-8) characters in the
+ names for IMAP folders.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Executive Summary now Reads IMAP</term>
+ <listitem>
+ <para>
+ The Executive Summary tool in Evolution now displays
+ email messages in IMAP as well as local mail folders.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Filters and vFolders Notice Moved or Missing Folders</term>
+ <listitem>
+ <para>
+ vFolders and filters now notice if you move or delete
+ a folder that they use.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>vFolder "Original Location" Feature</term>
+ <listitem>
+ <para>
+ vFolders can now display the actual folder location
+ for each message they contain. To do so, right click
+ on the column headers in the message list of any
+ vFolder, select <guimenuitem>Add a
+ Column</guimenuitem>, and drag the <guibutton>Original
+ Location</guibutton> item into position.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>New Criteria and Actions</term>
+ <listitem>
+ <para>
+ There are many new filter criteria and actions,
+ including additional message flags such as Flag for
+ Followup.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Folder Selection for Offline Mode</term>
+ <listitem>
+ <para>
+ You may now select which network folders which will be
+ cached locally when you go into Offline mode. This
+ setting may be changed from the Folders section of the
+ Evolution Settings window.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Redirect (Bounce) Feature Added</term>
+ <listitem>
+ <para>
+ This feature is also sometimes known as "Bounce" or
+ "Resend." To resend a message with all its headers
+ instead of merely forwarding it, select the message and
+ choose
+ <menuchoice>
+ <guimenu>
+ Actions
+ </guimenu>
+ <guisubmenu>
+ Forward
+ </guisubmenu>
+ <guimenuitem>
+ Redirect
+ </guimenuitem>
+ </menuchoice>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Digest-mode Display of Forwarded Messages</term>
+ <listitem>
+ <para>
+ Messages that contain multiple forwarded messages are
+ now displayed as a digest rather than inline or as a
+ series of attachments.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>New Mail Notification</term>
+ <listitem>
+ <para>
+ When new mail arrives, you may opt to have Evolution
+ beep or play a sound file that you specify.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
+ </sect1>
+</preface>
+
diff --git a/help/C/usage-contact.sgml b/help/C/usage-contact.sgml
new file mode 100644
index 0000000000..a28dd936e9
--- /dev/null
+++ b/help/C/usage-contact.sgml
@@ -0,0 +1,571 @@
+<!--
+<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
+-->
+
+<chapter id="usage-contact">
+ <title>Working with Your Contacts</title>
+ <para>
+ This chapter will show you how to use the
+ <application>Evolution</application> addressbook to organize
+ any amount of contact information, share addresses over a
+ network, and several ways to save time with everyday tasks. To
+ learn about configuring the addressbook, see <xref
+ linkend="config-prefs-contact">. You can import contacts from
+ other contact management tools with the Import tool by
+ selecting
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Import</guimenuitem></menuchoice>,
+ or by mailing them to yourself as vCard attachments.
+ </para>
+
+ <para>
+ The toolbar for the addressbook is quite simple.
+ <itemizedlist>
+ <listitem><para>
+ Click <guibutton>New Contact</guibutton> to create a new card, or double-click
+ in a blank space in the contact list.
+ </para></listitem>
+
+ <listitem><para>
+ Click <guibutton>New List</guibutton> to create a new card, or double-click
+ in a blank space in the contact list.
+ </para></listitem>
+
+ <listitem><para> The <guiicon>printer</guiicon> icon sends one
+ or more of your cards to the printer. </para></listitem>
+
+ <listitem><para> The <guiicon>stop sign</guiicon> icon stops loading
+ contact data from the network. This button is only
+ relevant if you are looking at contact information on a
+ network. </para></listitem>
+ </itemizedlist>
+ </para>
+
+ <para>
+ Your contact information fills the rest of the display. Move
+ through the cards alphabetically with the buttons and the
+ scrollbar to the right of the window. Of course, if you have
+ more than a few people listed, you'll want some way of finding
+ them more quickly, which is why there's a search feature.
+ </para>
+
+ <sect1 id="usage-contact-cards">
+ <title>The Contact Editor</title>
+ <para>
+ To delete a contact:
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>
+ Click once on the contact.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Press the <guibutton>Delete</guibutton> button.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <para>
+ If you want to add or change cards, you'll use the contact
+ editor. To change a card that already exists, double click on
+ it to open the contact editor window. If you want to create a new
+ card, clicking the <guibutton>New</guibutton> button in the
+ toolbar will open the same window, with blank entry boxes for
+ you to fill in.
+ </para>
+
+ <para>
+ The contact editor window has two tabs,
+ <guilabel>General</guilabel>, for basic contact information, and
+ <guilabel>Details</guilabel>, for a more specific description of
+ the person. In addition, it contains a <guimenu>File</guimenu>
+ menu and a toolbar with three items: <guilabel>Save and
+ Close</guilabel>, <guilabel>Print</guilabel>, and
+ <guilabel>Delete</guilabel>.
+ </para>
+
+ <figure id="usage-contact-editor-fig">
+ <title>Evolution Contact Editor</title>
+ <screenshot>
+ <screeninfo>Evolution Contact Editor</screeninfo>
+ <mediaobject><imageobject><imagedata
+ fileref="figures/contact-editor" format="png" srccredit="Aaron
+ Weber">
+ </imageobject></mediaobject>
+ </screenshot>
+ </figure>
+
+ <para> The <guilabel>General</guilabel> tab has seven sections,
+ each with an icon: a face, for name and company; a telephone
+ for phone numbers; an envelope for email address; a globe for
+ web page address; a house for postal address; a file folder
+ for contacts, and a briefcase for categories.
+ </para>
+ <para>
+ <variablelist>
+
+ <varlistentry>
+ <term>Full Name</term>
+ <listitem>
+ <para>
+ The <guilabel>Full Name</guilabel> field has two
+ major features:
+ <itemizedlist>
+ <listitem>
+ <para>
+ You can enter a name into the <guibutton>Full
+ Name</guibutton> field, but you can also click the
+ <guibutton>Full Name</guibutton> button to bring
+ up a small dialog box with a few text boxes
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Title: </guilabel></term>
+ <listitem> <para>
+ Enter an honorific or select one from the menu.
+ </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>First: </guilabel></term>
+ <listitem> <para>
+ Enter the first, or given, name.
+ </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Middle: </guilabel></term>
+ <listitem> <para>
+ Enter the middle name or initial, if any.
+ </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Last: </guilabel></term>
+ <listitem> <para>
+ Enter the last name (surname).
+ </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Suffix: </guilabel></term>
+ <listitem> <para>
+ Enter suffixes such as "Jr." or "III."
+ </para></listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ The <guilabel>Full Name</guilabel> field also
+ interacts with the <guilabel>File As</guilabel>
+ box to help you organize your contacts.
+ </para>
+ <para>
+ To see how it works, type a name in the
+ <guilabel>Full Name</guilabel> field. As an example,
+ we'll use the Ximian mascot, <userinput>Rupert
+ T. Monkey</userinput>. You'll notice that the
+ <guilabel>File As</guilabel> field also fills in,
+ but in reverse: <computeroutput>Monkey,
+ Rupert</computeroutput>. You can pick
+ <computeroutput>Rupert Monkey </computeroutput> from
+ the drop-down, or type in your own, such as
+ <userinput> T. Rupert Monkey </userinput>.
+ </para>
+ <tip>
+ <title>Filing Suggestion</title>
+ <para>
+ Don't enter something entirely different from the
+ actual name, since you might forget that you've filed
+ Rupert's information under "F" for "Fictitious Ximian
+ Employee."
+ </para>
+ </tip>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Multiple Values for Fields:</term>
+ <listitem>
+ <para>
+ If you click on the downward pointing triangle buttons
+ next to the <guilabel>Primary Email</guilabel> field,
+ you can also choose <guilabel>Email 2</guilabel> and
+ <guilabel>Email 3</guilabel>. Although the contact
+ editor will only display one of those at any given
+ time, <application>Evolution</application> will store
+ them all. Entries that have information in them have
+ a check mark next to them. The buttons next to the
+ telephone and postal address fields work in the same
+ way.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <para>
+ The last item in the <guilabel>General</guilabel> tab is the
+ <guilabel>Categories</guilabel> organization tool; for
+ information on that, read <xref
+ linkend="usage-contact-organize">.
+ </para>
+ <para>
+ The <guilabel>Details</guilabel> tab is much simpler:
+ <itemizedlist>
+ <listitem>
+ <para>
+ The briefcase - Describes the person's professional life
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The face - Describes the person's personal life
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The globe - Miscellanious notes
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <tip>
+ <title>Contact Shortcuts</title>
+ <para>
+ You can add cards from within an email message or calendar
+ appointment. While looking at an email, right-click on
+ any email address or message, and choose
+ <guimenuitem>Create Card for this Address</guimenuitem> or
+ <guimenuitem>Create Card for this Sender</guimenuitem>
+ from the menu.
+ </para>
+ </tip>
+ </para>
+ </sect1>
+
+ <sect1 id="contact-search">
+ <title>Searching for Contacts</title>
+ <para>
+ <application>Evolution</application> allows searching through contacts
+ quickly and easily.
+ </para>
+ <para>
+ To search through contacts:
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>
+ Select your search focus in the search bar.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Enter your query.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Press return to search.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <para>
+ To perform a complex search through your contacts:
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>
+ Open
+ <menuchoice>
+ <guimenu>Tools</guimenu>
+ <guimenuitem>Search for contacts</guimenuitem>
+ </menuchoice>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Name the rule in the <guilabel>Rule Name</guilabel> field.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Setup your criteria information in the <guilabel>If</guilabel> section.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If you want to add more criteria, click the <guibutton>Add
+ Criterion</guibutton> button.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click <guibutton>Search</guibutton>.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <para>
+ To show all your contacts, select <guibutton>Show All</guibutton> in the
+ <guilabel>Search Bar</guilabel> or search with an empty query.
+ </para>
+
+ </sect1>
+
+ <sect1 id="usage-contact-organize">
+ <title>Organizing your Addressbook</title>
+ <para>
+ Organizing your addressbook is a lot like organizing your
+ mail. You can have folders and searches the same way you can
+ with mail, but the addressbook does not allow Virtual Folders. It
+ does, however, allow each card to fall under several
+ categories, and allow you to create your own categories. To
+ learn about categories, read <xref
+ linkend="usage-contact-organize-group-category">.
+ </para>
+
+<!-- UNIMPLEMENTED FEATURE
+ <para>
+ Another useful <application>Evolution</application> feature is
+ its ability to recognize when people live or work together. If
+ several people in your addressbook share an address, and you
+ change the address for one of them,
+ <application>Evolution</application> will ask you if you wish to
+ change the address for all of them, or just for one.
+ </para>
+-->
+
+ <sect2 id="usage-contact-organize-group">
+ <title>Groups of contacts</title>
+ <para>
+ <application>Evolution</application> offers two ways for you
+ to organize your cards. The first way is to use folders;
+ this works the same way mail folders do. For more
+ flexibility, you can also mark contacts as elements of
+ different categories. To better integrate with email tools,
+ you can also create lists of contacts that you can send mail
+ to as a single person.
+ </para>
+
+ <sect3 id="usage-contact-organize-group-folder">
+ <title>Grouping with Folders</title>
+ <para>
+ The simplest way to group address cards is to use folders.
+ By default, cards start in the
+ <guilabel>Contacts</guilabel> folder. If you've read <xref
+ linkend="usage-mainwindow"> then you already know that you
+ can create a new folder by selecting
+ <menuchoice>
+ <guimenu>File</guimenu>
+ <guisubmenu>New</guisubmenu>
+ <guimenuitem>Folder</guimenuitem>
+ </menuchoice>
+ and that you can put new folders anywhere you like. Just
+ like with mail, cards must be in a card folder, and no card
+ can be in two places at once. If you want more
+ flexibility, try <xref
+ linkend="usage-contact-organize-group-category">.
+ </para>
+ <para>
+ To put a card into a folder, just drag it there from the
+ folder view. Remember that contact cards can only go in
+ contact folders, just like mail can only go in mail folders,
+ and calendars in calendar folders.
+ </para>
+ </sect3>
+
+ <sect3 id="usage-contact-organize-group-category">
+ <title>Grouping with Categories</title>
+ <para>
+ The other way to group cards is to mark them as belonging
+ to different categories.
+ That means that you
+ can mark a card as being in several categories or no
+ category at all. For example, I put my friend Matthew's
+ card in the "Business" category, because he works with me,
+ the "Friends" category, because he's also my friend, and
+ the "Frequent" category, because I call him all the time
+ and can never remember his phone number.
+ </para>
+ <para>
+ To mark a card as belonging to a category, click the
+ <guibutton>Categories</guibutton> button at the lower
+ right. From the dialog box that appears, you can check as
+ many or as few categories as you like.
+ </para>
+
+ <!-- Feature Not Implemented
+ <para>
+
+ If the master list of categories doesn't suit you, you can
+ add your own. Just enter the new category's name in the
+ text box, then click <guibutton>Categories</guibutton> and
+ choose <guilabel>Add to Master List</guilabel> in the
+ window that appears.
+ </para>
+ -->
+
+ </sect3>
+
+ <sect3 id="usage-contact-organize-group-list">
+ <title>Creating a List of Contacts</title>
+ <para>
+ To create a list of contacts:
+
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>
+ Open the list creation dialog box by clicking the
+ <guibutton>New List</guibutton> button or selecting
+ <menuchoice>
+ <guimenu>
+ File
+ </guimenu>
+ <guisubmenu>
+ New
+ </guisubmenu>
+ <guimenuitem>
+ Contact List
+ </guimenuitem>
+ </menuchoice>.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Enter a name for the list.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Enter names or email addresses of contacts, or just
+ drag contacts from the main window into the list.
+ </para>
+ </listitem>
+
+ <list