<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet
 href="urn:x-daps:xslt:profiling:docbook45-profile.xsl"
 type="text/xml"
 title="Profiling step"?>
<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.docbook.org/xml/4.5/docbookx.dtd"
[<!ENTITY % entities SYSTEM "entity-decl.ent">
%entities;
]>
<preface id="pre.daps.user">
 <title>About This Guide</title>
 <para>
  &daps-description-short;
 </para>
 <sect1>
  <title>Target Audience</title>

  <para>
   &audience;
  </para>

 </sect1>
 <sect1 id="sec.daps.user.intro.doc">
  <title>Available Documentation</title>

  <para>
   This guide contains links to additional documentation resources. The
   following manuals are available for &dapsacr;:
  </para>


  <variablelist>
   <varlistentry>
    <term>
      <xref linkend="art.daps.quick" os="quick"/>
      <phrase os="noquick">&dapsquick;</phrase>
    </term>
    <listitem>
     <para>
      &daps-quickstart-abstract;
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><xref linkend="book.daps.user"/>
    </term>
    <listitem>
     <para>
      &daps-userguide-abstract;
     </para>
    </listitem>
   </varlistentry>
  <!-- <varlistentry>
    <term><xref linkend="art.tutorial"/></term>
    <listitem>
     <para>The tutorial is for &dapsacr; beginners and anybody who already
      worked a little bit with &dapsacr;. Using the example of a recipe for
      a chili sauce, the tutorial explains step-by-step how to set up your
      document, which basic XML tags to use for writing it, and in the end, how
      to convert the document into HTML output. No previous XML knowledge is
      necessary.</para></listitem>
   </varlistentry>-->
   
   <!--taroth 2012-02-06: planned for future revisions-->
<!--<varlistentry>
   <term>
     <xref linkend="book.daps.dev"/>
    </term>
    <listitem>
     <para>Reference guide for developers.
     </para>
    </listitem>
   </varlistentry>-->
<!--taroth 2011-12-28: to add: svn doc, docmanager doc, xmleditor doc, etc.-->
  </variablelist>
 </sect1>
 <sect1 id="sec.daps.user.intro.feedback">
  <title>Feedback</title>
    &daps-feedback;
 </sect1>
 <sect1 id="sec.daps.user.intro.typo">
  <title>Documentation Conventions</title>

  <para>
   The following typographical conventions are used in this manual:
  </para>

  <itemizedlist>
   <listitem>
    <para>
     <filename>/etc/passwd</filename>: directory names and file names
    </para>
   </listitem>
   <listitem>
    <para>
     <replaceable>placeholder</replaceable>: replace
     <replaceable>placeholder</replaceable> with the actual value
    </para>
   </listitem>
   <listitem>
    <para>
     <envar>PATH</envar>: the environment variable PATH
    </para>
   </listitem>
   <listitem>
    <para>
     <command>ls</command>, <option>--help</option>: commands, options, and
     parameters
    </para>
   </listitem>
   <listitem>
    <para>
     <systemitem class="username">user</systemitem>: users or groups
    </para>
   </listitem>
   <listitem>
    <para>
     <keycap function="alt"/>,
     <keycombo><keycap function="alt"/><keycap>F1</keycap></keycombo>:
     a key to press or a key combination; keys are shown in
     uppercase as on a keyboard
    </para>
   </listitem>
   <listitem>
    <para>
     <guimenu>File</guimenu>, <menuchoice> <guimenu>File</guimenu>
     <guimenu>Save As</guimenu> </menuchoice>: menu items, buttons
    </para>
   </listitem>
   <listitem>
    <para>
     <emphasis>Dancing Penguins</emphasis> (Chapter
     <emphasis>Penguins</emphasis>, &uarr;Another Manual): This is a
     reference to a chapter in another manual.
    </para>
   </listitem>
  </itemizedlist>
 </sect1>
 <sect1 id="sec.daps.user.intro.making">
  <title>About the Making of This Document</title>

  <para>
   This documentation is written in DocBook (see
   <ulink url="http://www.docbook.org"/>) and generated by &dapsacr;.
  </para>
 </sect1>
</preface>
