All sgml files replaced with xml files. XML files validated. Two new XML

2002-11-04  Aaron Weber  <aaron@ximian.com>

	* C/*.sgml: All sgml files replaced with xml files. XML files
	validated. Two new XML files added: apx-fdl.xml and legal.xml

	* C/evolution-C.omf: Altered to fit the GDP template. This may now
	work with the GNOME 2.0 DTD, although I could be wrong.

	* sgmldocs.make: removed and replaced with xmldocs.make. This will
	break all translations until they are also ported to XML. I will
	probably begin doing that tomorrow, since it's just markup and not
	language stuff.

	* C/Makefile.am: added two files to the list. Does this
	Makefile get included in another, somewhere, or is it just
	detected?

svn path=/trunk/; revision=18538

1 files changed, 480 insertions, 0 deletions

diff --git a/help/C/apx-gloss.xml b/help/C/apx-gloss.xml
new file mode 100644
index 0000000000..e3b945e488
--- /dev/null
+++ b/help/C/apx-gloss.xml
@@ -0,0 +1,480 @@
+<glossary id="apx-gloss">
+  
+  <title>Glossary</title>
+  
+  <glossentry id="assistant">
+    <glossterm>Assistant:</glossterm>
+    <glossdef>
+      <para>
+	See 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>
+    A tool which guides a user through a series of steps, usually to
+    configure or set up a program.  Equivalent to "Assistant" and
+    "Wizard."
+   </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 downwards 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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+