bos@559: <!-- vim: set filetype=docbkxml shiftwidth=2 autoindent expandtab tw=77 : -->
bos@26: 
bos@559: <preface id="chap:preface">
bos@587:   <?dbhtml filename="preface.html"?>
bos@559:   <title>Preface</title>
bos@26: 
bos@583:   <sect1>
bos@704:     <title>Conventions Used in This Book</title>
bos@583: 
bos@704:     <para>The following typographical conventions are used in this
bos@704:       book:</para>
bos@583: 
bos@704:     <variablelist>
bos@704:       <varlistentry>
bos@704:         <term>Italic</term>
bos@583: 
bos@704:         <listitem>
bos@704:           <para>Indicates new terms, URLs, email addresses, filenames,
bos@704: 	    and file extensions.</para>
bos@704:         </listitem>
bos@704:       </varlistentry>
bos@583: 
bos@704:       <varlistentry>
bos@704:         <term><literal>Constant width</literal></term>
bos@583: 
bos@704:         <listitem>
bos@704:           <para>Used for program listings, as well as within
bos@704: 	    paragraphs to refer to program elements such as variable
bos@704: 	    or function names, databases, data types, environment
bos@704: 	    variables, statements, and keywords.</para>
bos@704:         </listitem>
bos@704:       </varlistentry>
bos@583: 
bos@704:       <varlistentry>
bos@704:         <term><userinput>Constant width bold</userinput></term>
bos@583: 
bos@704:         <listitem>
bos@704:           <para>Shows commands or other text that should be typed
bos@704: 	    literally by the user.</para>
bos@704:         </listitem>
bos@704:       </varlistentry>
bos@583: 
bos@704:       <varlistentry>
bos@704:         <term><replaceable>Constant width italic</replaceable></term>
bos@583: 
bos@704:         <listitem>
bos@704:           <para>Shows text that should be replaced with user-supplied
bos@704: 	    values or by values determined by context.</para>
bos@704:         </listitem>
bos@704:       </varlistentry>
bos@704:     </variablelist>
bos@583: 
bos@704:     <tip>
bos@704:       <para>This icon signifies a tip, suggestion, or general
bos@704: 	note.</para>
bos@704:     </tip>
bos@583: 
bos@704:     <caution>
bos@704:       <para>This icon indicates a warning or caution.</para>
bos@704:     </caution>
bos@583:   </sect1>
bos@26: 
bos@559:   <sect1>
bos@704:     <title>Using Code Examples</title>
bos@26: 
bos@704:     <para>This book is here to help you get your job done. In general,
bos@704:       you may use the code in this book in your programs and
bos@704:       documentation. You do not need to contact us for permission
bos@704:       unless you’re reproducing a significant portion of the code. For
bos@704:       example, writing a program that uses several chunks of code from
bos@704:       this book does not require permission. Selling or distributing a
bos@704:       CD-ROM of examples from O’Reilly books does require permission.
bos@704:       Answering a question by citing this book and quoting example
bos@704:       code does not require permission. Incorporating a significant
bos@704:       amount of example code from this book into your product’s
bos@704:       documentation does require permission.</para>
bos@200: 
bos@704:     <para>We appreciate, but do not require, attribution. An
bos@704:       attribution usually includes the title, author, publisher, and
bos@704:       ISBN. For example: “<emphasis>Book Title</emphasis> by Some
bos@704:       Author. Copyright 2008 O’Reilly Media, Inc.,
bos@704:       978-0-596-xxxx-x.”</para>
bos@200: 
bos@704:     <para>If you feel your use of code examples falls outside fair use
bos@704:       or the permission given above, feel free to contact us at
bos@704:       <email>permissions@oreilly.com</email>.</para>
bos@559:   </sect1>
bos@583: 
bos@583:   <sect1>
bos@704:     <title>Safari® Books Online</title>
bos@583: 
bos@704:     <note role="safarienabled">
bos@704:       <para>When you see a Safari® Books Online icon on the cover of
bos@704: 	your favorite technology book, that means the book is
bos@704: 	available online through the O’Reilly Network Safari
bos@704: 	Bookshelf.</para>
bos@704:     </note>
bos@583: 
bos@704:     <para>Safari offers a solution that’s better than e-books. It’s a
bos@704:       virtual library that lets you easily search thousands of top
bos@704:       tech books, cut and paste code samples, download chapters, and
bos@704:       find quick answers when you need the most accurate, current
bos@704:       information. Try it for free at <ulink role="orm:hideurl:ital"
bos@704: 	url="http://my.safaribooksonline.com/?portal=oreilly">http://my.safaribooksonline.com</ulink>.</para>
bos@583:   </sect1>
bos@583: 
bos@583:   <sect1>
bos@704:     <title>How to Contact Us</title>
bos@583: 
bos@704:     <para>Please address comments and questions concerning this book
bos@704:       to the publisher:</para>
bos@583: 
bos@704:     <simplelist type="vert">
bos@704:       <member>O’Reilly Media, Inc.</member>
bos@583: 
bos@704:       <member>1005 Gravenstein Highway North</member>
bos@583: 
bos@704:       <member>Sebastopol, CA 95472</member>
bos@583: 
bos@704:       <member>800-998-9938 (in the United States or Canada)</member>
bos@583: 
bos@704:       <member>707-829-0515 (international or local)</member>
bos@583: 
bos@704:       <member>707 829-0104 (fax)</member>
bos@704:     </simplelist>
bos@583: 
bos@704:     <para>We have a web page for this book, where we list errata,
bos@704:       examples, and any additional information. You can access this
bos@704:       page at:</para>
bos@583: 
bos@704:     <simplelist type="vert">
bos@704:       <member><ulink url="http://www.oreilly.com/catalog/&lt;catalog
bos@704: 	  page&gt;"></ulink></member>
bos@704:     </simplelist>
bos@583: 
bos@704:     <remark>Don’t forget to update the &lt;url&gt; attribute,
bos@704:       too.</remark>
bos@583: 
bos@704:     <para>To comment or ask technical questions about this book, send
bos@704:       email to:</para>
bos@26: 
bos@704:     <simplelist type="vert">
bos@704:       <member><email>bookquestions@oreilly.com</email></member>
bos@704:     </simplelist>
bos@26: 
bos@704:     <para>For more information about our books, conferences, Resource
bos@704:       Centers, and the O’Reilly Network, see our web site at:</para>
bos@559: 
bos@704:     <simplelist type="vert">
bos@704:       <member><ulink url="http://www.oreilly.com"></ulink></member>
bos@704:     </simplelist>
bos@559:   </sect1>
bos@559: </preface>
bos@704: 
bos@559: <!--
bos@559: local variables: 
bos@559: sgml-parent-document: ("00book.xml" "book" "preface")
bos@559: end:
bos@559: -->