path: root/help/C/apx-gloss.xml

<appendix id="outlook-migration">
  <title>Outlook to Evolution Migration</title>
  <para>If you are using Microsoft Outlook, but not Microsoft Exchange,
    this section will help you switch to Evolution.</para>

  <sect1 id="outlook-migration-mail">
    <title>Migrating Local Outlook Mail Folders</title>
    <para>Exchange and IMAP mail is stored on the server, so you do not
      need to migrate it to your Linux partition. However, if you have
      stored mail on your computer, you may wish to make it accessible to
      Evolution.</para>
    <para>First, while using Windows, prepare your messages for
      import:</para>

    <orderedlist>

      <listitem><para>Clean up your mail: Delete messages and folders you
          do not need, and select <menuchoice>
          <guimenu>File</guimenu>
          <guisubmenu>Folders</guisubmenu>
          <guisubmenu>Properties</guisubmenu>
          <guisubmenu>Advanced</guisubmenu>
          <guimenuitem>Compact</guimenuitem>
        </menuchoice> to erase old, deleted messages from your PST
        file.</para></listitem>

    <listitem>
      <para>If you nest your folders one inside another, you may wish to
        rename subfolders so that you can tell which folder they
        belong to. You will have to re-nest them after you load them
        into Evolution.</para>
    </listitem>

      <listitem><para>Import the files into Mozilla Mail (or
          another mailer, such as Netscape or Eudora, that uses the
          standard mbox format). Linux mailers cannot do this task,
          because it requires a library available only under
          Windows. In Mozilla, import by selecting
          <menuchoice><guimenu>Window</guimenu> <guisubmenu>Mail &amp;
          Newsgroups</guisubmenu> <guisubmenu>Tools</guisubmenu>
          <guimenuitem>Import</guimenuitem> </menuchoice>.</para></listitem>

      <listitem>
        <para>Mozilla will create a set of files in the directory
<filename>Windows\Application_Data\Mozilla\Profiles\(User
Name)\(Random Letters)\Mail\Local Folders\Outlook
Mail\</filename>. The data files are those that have no
file extension.</para>

        <para>If you are using Windows XP or Windows 2000, your
          Windows hard drive is probably in the NTFS format,
          which some Linux systems will not read without additional
          software. You may find it simpler to copy the mail folders to a
          different drive or to burn a CD.</para>
      </listitem>
    </orderedlist>
    
    <para>Now that you have your mail in a format Evolution can
      understand, reboot to Linux. Then:</para>
      <orderedlist>
        <listitem><para>Mount your Windows drive or the
            disk where you saved the mail files.</para></listitem>
        
        <listitem><para>Copy all the mail files into your home directory or
            another convenient place.</para></listitem>
        
        <listitem><para>Start Evolution.</para></listitem>

        <listitem><para>
            Press
            <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap>
            <keycap>F</keycap></keycombo> or select <menuchoice>
            <guimenu>File</guimenu><guisubmenu>New</guisubmenu>
            <guimenuitem>Folder</guimenuitem></menuchoice> to create
            the folders you want. This is where your previous
            organization pays off.
          </para></listitem>
      </orderedlist>

      <para>Now you are ready to import the data files:</para>
      <orderedlist>
        <listitem>
          <para>In Evolution, open the file import assistant by selecting
            <menuchoice>
              <guimenu>File</guimenu><guimenuitem>Import</guimenuitem></menuchoice>.</para>
        </listitem>

        <listitem><para>
            Click <guilabel>Next</guilabel>, and select
          <guilabel>Import a single file</guilabel>. 
          </para></listitem>
        <listitem><para>
             Leave the file
            type as <guilabel>automatic</guilabel> and click
            <guilabel>Browse</guilabel> to select the data
            file. Remember, the data files are the files that have no
            file extension.
          </para></listitem>

        <listitem>
          <para>Select the folder where you want to put the imported data
            file.</para>
        </listitem>
        <listitem>
          <para>Repeat the import steps until you have imported all your
            mail.</para>
        </listitem>
    </orderedlist>
  </sect1>


  <!--
  <sect1 id="outlook-import-contacts">
    <title>Importing Contacts from Outlook</title>

    <para>
       To import contacts, you will again have to use Mozilla as an
      intermediary. This time, you will use Outlook to save your data
      to a comma separated value (CSV) file, then import it to
      Mozilla. From Mozilla, you will save it as an an LDIF file,
      which Evolution will import.
    </para>
    <orderedlist>
      <listitem>
        <para>
          In Windows, export each Outlook address book as .csv. It is
          best to select the <guilabel>Export All Fields</guilabel> option,
        rather than choose a subset of fields. Be aware that if you
        have multiple address books, Outlook will suggest the same
        name for each exported file, so be sure to choose a new name
        each time you export a new address book.
        </para>
      </listitem>

      <listitem>
        <para>
        </para>
      </listitem>

      <listitem>
        <para>
        </para>
      </listitem>

      <listitem>
        <para>
        </para>
      </listitem>

      <listitem>
        <para>
        </para>
      </listitem>
    </orderedlist>

  </sect1>      
Basically, the .cvs files will contain a top line with column titles
(one per record field), and as many lines as there are contact entries
(records). (Sorry, no idea about "groups" of contacts as subsets of an
address book. Can you help?)

A bit of massaging is useful, because while the Outlook set of columns is very comprehensive, other programs like Mozilla and Evolution have fewer and not entirely consistent, field names.

For example,

* Outlook offers 3 fields for email, Evolution just two, so I move the 3rd Outlook email address to the Notes field.

* Outlook offers First, Middle, Last name fields, the others just First, Last, so I add the Middle Name to the First Name field.

* Outlook offers three lines for the street address, instead of two (although the 3rd is rarely used, since most data end up in the City, State, ZIP/Postcode, Country fields).

2) Switch to Linux. Start OpenOffice.org Calc. Open all the .csv files. A dialog will let you choose the right separators.

3) Copy all records (lines) from all books (if you have multiple books) into the same file, using header lines to separate them. Thus you will massage all books in one shot. Save it.


4.1) For names, add a few columns (by header, to write in the 1st line) FIRSTNAMECALC, FIRSTNAMENEW, SPACE.

4.2) In the 1st record under SPACE insert a space; under FIRSTNAMECALC insert the formula:

=CONCATENATE([cell under FIRSTNAME];[cell under SPACE];[cell under MIDDLE NAME])

4.3) Copy these two cells all the way down to the last record. Check if first and middle names have been merged OK.

4.4) Copy the whole FIRSTNAMECALC column.

4.5) Paste-Special it over the FIRSTNAMENEW column, as "strings" - i.e. just the result, without formula.

4.6) Rename this column to FIRSTANDMIDDLE, delete the FIRSTNAMECALC, FIRTSTNAME, MIDDLENAME, SPACE columns.

If you care about those things (Continental Europe?), you may likewise concatenate more fields, as to have the FIRSTNAME column contain the whole sequence: Title First-Name Middle-Name (perhaps a space and comma) Suffix.


5.1 - 5.6) For the 3rd email: first check if some exist. If they do, repear the procedure like for the names, until the 3rd email addresses are attached to the end of the Notes field.

Likewise, depending on the data you actually have, you may want to plan to enter it into fields that may not be ideal, but at least similar.

6) Seek & delete all empty columns, so at later steps you won't risk importing lots of nothing, and leave out lots of something.

7) Save the file as many times as there are address books you want to have. Specify .csv, but select TAB as field separator and select double quote (") for text marker. 

8) Open each file, delete the excess records (lines) but KEEP THE TOP LINE where the column names are, save it as before, and finally once the file is saved, CHANGE THE FILENAME ENDING TO .tab - Mozilla likes them that way. For some reason, it won't recognize a tab-separated file that is not named in .tab, as if Calc did not mark it the file-type properly. This is not exactly Unix-like, but that's how it works. It may be a quirk of my setup, as one can instruct a filemanager to recognize filetypes from the 3-letter subfixes, like in Windows.

9) Start Mozilla, import all the first address book as "single file".

10) Carefully select which destination field (left colum) will suck up which source fields (right column). You do that by moving the destination fields. IMPORTANT: least you go nuts, start from the top and work your way down. Punch OK. Peruse the results. Don't do more imports until satisfied. Field mapping is sticky, so you'll do it only once.

11) Repeat for the other files.  (I still have some doubts: sometimes contacts end up in the main Contacts folder istead of the one I select.  I still need to investigate.  Hints anyone?)
    -->


</appendix>

<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
     Evolution 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>
    Evolution 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.  Evolution 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 Evolution, 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 address book 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
    Evolution 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 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.  Evolution
    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 Evolution 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>