rev |
line source |
bos@559
|
1 <!-- vim: set filetype=docbkxml shiftwidth=2 autoindent expandtab tw=77 : -->
|
bos@26
|
2
|
bos@559
|
3 <preface id="chap:preface">
|
bos@587
|
4 <?dbhtml filename="preface.html"?>
|
bos@559
|
5 <title>Preface</title>
|
bos@26
|
6
|
bos@583
|
7 <sect1>
|
bos@704
|
8 <title>Conventions Used in This Book</title>
|
bos@583
|
9
|
bos@704
|
10 <para>The following typographical conventions are used in this
|
bos@704
|
11 book:</para>
|
bos@583
|
12
|
bos@704
|
13 <variablelist>
|
bos@704
|
14 <varlistentry>
|
bos@704
|
15 <term>Italic</term>
|
bos@583
|
16
|
bos@704
|
17 <listitem>
|
bos@704
|
18 <para>Indicates new terms, URLs, email addresses, filenames,
|
bos@704
|
19 and file extensions.</para>
|
bos@704
|
20 </listitem>
|
bos@704
|
21 </varlistentry>
|
bos@583
|
22
|
bos@704
|
23 <varlistentry>
|
bos@704
|
24 <term><literal>Constant width</literal></term>
|
bos@583
|
25
|
bos@704
|
26 <listitem>
|
bos@704
|
27 <para>Used for program listings, as well as within
|
bos@704
|
28 paragraphs to refer to program elements such as variable
|
bos@704
|
29 or function names, databases, data types, environment
|
bos@704
|
30 variables, statements, and keywords.</para>
|
bos@704
|
31 </listitem>
|
bos@704
|
32 </varlistentry>
|
bos@583
|
33
|
bos@704
|
34 <varlistentry>
|
bos@704
|
35 <term><userinput>Constant width bold</userinput></term>
|
bos@583
|
36
|
bos@704
|
37 <listitem>
|
bos@704
|
38 <para>Shows commands or other text that should be typed
|
bos@704
|
39 literally by the user.</para>
|
bos@704
|
40 </listitem>
|
bos@704
|
41 </varlistentry>
|
bos@583
|
42
|
bos@704
|
43 <varlistentry>
|
bos@704
|
44 <term><replaceable>Constant width italic</replaceable></term>
|
bos@583
|
45
|
bos@704
|
46 <listitem>
|
bos@704
|
47 <para>Shows text that should be replaced with user-supplied
|
bos@704
|
48 values or by values determined by context.</para>
|
bos@704
|
49 </listitem>
|
bos@704
|
50 </varlistentry>
|
bos@704
|
51 </variablelist>
|
bos@583
|
52
|
bos@704
|
53 <tip>
|
bos@704
|
54 <para>This icon signifies a tip, suggestion, or general
|
bos@704
|
55 note.</para>
|
bos@704
|
56 </tip>
|
bos@583
|
57
|
bos@704
|
58 <caution>
|
bos@704
|
59 <para>This icon indicates a warning or caution.</para>
|
bos@704
|
60 </caution>
|
bos@583
|
61 </sect1>
|
bos@26
|
62
|
bos@559
|
63 <sect1>
|
bos@704
|
64 <title>Using Code Examples</title>
|
bos@26
|
65
|
bos@704
|
66 <para>This book is here to help you get your job done. In general,
|
bos@704
|
67 you may use the code in this book in your programs and
|
bos@704
|
68 documentation. You do not need to contact us for permission
|
bos@704
|
69 unless you’re reproducing a significant portion of the code. For
|
bos@704
|
70 example, writing a program that uses several chunks of code from
|
bos@704
|
71 this book does not require permission. Selling or distributing a
|
bos@704
|
72 CD-ROM of examples from O’Reilly books does require permission.
|
bos@704
|
73 Answering a question by citing this book and quoting example
|
bos@704
|
74 code does not require permission. Incorporating a significant
|
bos@704
|
75 amount of example code from this book into your product’s
|
bos@704
|
76 documentation does require permission.</para>
|
bos@200
|
77
|
bos@704
|
78 <para>We appreciate, but do not require, attribution. An
|
bos@704
|
79 attribution usually includes the title, author, publisher, and
|
bos@704
|
80 ISBN. For example: “<emphasis>Book Title</emphasis> by Some
|
bos@704
|
81 Author. Copyright 2008 O’Reilly Media, Inc.,
|
bos@704
|
82 978-0-596-xxxx-x.”</para>
|
bos@200
|
83
|
bos@704
|
84 <para>If you feel your use of code examples falls outside fair use
|
bos@704
|
85 or the permission given above, feel free to contact us at
|
bos@704
|
86 <email>permissions@oreilly.com</email>.</para>
|
bos@559
|
87 </sect1>
|
bos@583
|
88
|
bos@583
|
89 <sect1>
|
bos@704
|
90 <title>Safari® Books Online</title>
|
bos@583
|
91
|
bos@704
|
92 <note role="safarienabled">
|
bos@704
|
93 <para>When you see a Safari® Books Online icon on the cover of
|
bos@704
|
94 your favorite technology book, that means the book is
|
bos@704
|
95 available online through the O’Reilly Network Safari
|
bos@704
|
96 Bookshelf.</para>
|
bos@704
|
97 </note>
|
bos@583
|
98
|
bos@704
|
99 <para>Safari offers a solution that’s better than e-books. It’s a
|
bos@704
|
100 virtual library that lets you easily search thousands of top
|
bos@704
|
101 tech books, cut and paste code samples, download chapters, and
|
bos@704
|
102 find quick answers when you need the most accurate, current
|
bos@704
|
103 information. Try it for free at <ulink role="orm:hideurl:ital"
|
bos@704
|
104 url="http://my.safaribooksonline.com/?portal=oreilly">http://my.safaribooksonline.com</ulink>.</para>
|
bos@583
|
105 </sect1>
|
bos@583
|
106
|
bos@583
|
107 <sect1>
|
bos@704
|
108 <title>How to Contact Us</title>
|
bos@583
|
109
|
bos@704
|
110 <para>Please address comments and questions concerning this book
|
bos@704
|
111 to the publisher:</para>
|
bos@583
|
112
|
bos@704
|
113 <simplelist type="vert">
|
bos@704
|
114 <member>O’Reilly Media, Inc.</member>
|
bos@583
|
115
|
bos@704
|
116 <member>1005 Gravenstein Highway North</member>
|
bos@583
|
117
|
bos@704
|
118 <member>Sebastopol, CA 95472</member>
|
bos@583
|
119
|
bos@704
|
120 <member>800-998-9938 (in the United States or Canada)</member>
|
bos@583
|
121
|
bos@704
|
122 <member>707-829-0515 (international or local)</member>
|
bos@583
|
123
|
bos@704
|
124 <member>707 829-0104 (fax)</member>
|
bos@704
|
125 </simplelist>
|
bos@583
|
126
|
bos@704
|
127 <para>We have a web page for this book, where we list errata,
|
bos@704
|
128 examples, and any additional information. You can access this
|
bos@704
|
129 page at:</para>
|
bos@583
|
130
|
bos@704
|
131 <simplelist type="vert">
|
bos@704
|
132 <member><ulink url="http://www.oreilly.com/catalog/<catalog
|
bos@704
|
133 page>"></ulink></member>
|
bos@704
|
134 </simplelist>
|
bos@583
|
135
|
bos@704
|
136 <remark>Don’t forget to update the <url> attribute,
|
bos@704
|
137 too.</remark>
|
bos@583
|
138
|
bos@704
|
139 <para>To comment or ask technical questions about this book, send
|
bos@704
|
140 email to:</para>
|
bos@26
|
141
|
bos@704
|
142 <simplelist type="vert">
|
bos@704
|
143 <member><email>bookquestions@oreilly.com</email></member>
|
bos@704
|
144 </simplelist>
|
bos@26
|
145
|
bos@704
|
146 <para>For more information about our books, conferences, Resource
|
bos@704
|
147 Centers, and the O’Reilly Network, see our web site at:</para>
|
bos@559
|
148
|
bos@704
|
149 <simplelist type="vert">
|
bos@704
|
150 <member><ulink url="http://www.oreilly.com"></ulink></member>
|
bos@704
|
151 </simplelist>
|
bos@559
|
152 </sect1>
|
bos@559
|
153 </preface>
|
bos@704
|
154
|
bos@559
|
155 <!--
|
bos@559
|
156 local variables:
|
bos@559
|
157 sgml-parent-document: ("00book.xml" "book" "preface")
|
bos@559
|
158 end:
|
bos@559
|
159 -->
|