path: root/help/C/preface.sgml

<!--
<!DOCTYPE preface PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
-->
  <preface id="introduction">
    <title>About this Book</title> 
      <sect1 id="organization">
        <title>Organization</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>
</preface>