1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
<?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>, ↑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>
|
