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