X-Git-Url: http://git.samba.org/samba.git/?a=blobdiff_plain;f=docbook%2Fedg_src%2FEDG_preface.xml;fp=docbook%2Fedg_src%2FEDG_preface.xml;h=fcb5fcd830f20eb86f3538a528089cceab4db12f;hb=94f354b2b834a1f410e10913eb62006485b5016a;hp=0000000000000000000000000000000000000000;hpb=1bd388b90bb62e92e42aca7d8006909d2b174025;p=obnox%2Fwireshark%2Fwip.git

diff --git a/docbook/edg_src/EDG_preface.xml b/docbook/edg_src/EDG_preface.xml
new file mode 100644
index 0000000000..fcb5fcd830
--- /dev/null
+++ b/docbook/edg_src/EDG_preface.xml
@@ -0,0 +1,142 @@
+<!-- $Id$ -->
+
+<preface id="Preface">
+  <title>Preface</title>
+  <section id="PreForeword">
+  <title>Foreword</title>
+  <para>
+	This book tries to give you a guide to start your own experiments into 
+	the wonderful world of Ethereal development.
+  </para>
+  <para>
+	Developers who are new to Ethereal are often having a hard time getting 
+	their development environment up and running. This is
+	especially true for win32 developers, as a lot of the tools and methods
+	used when building Ethereal are much more common in the unix world than
+	on win32.
+  </para>
+  <para>
+	The first part of this book will describe how to set up the environment 
+	needed to develop Ethereal.
+  </para>
+  <para>
+	The second part of this book will describe how to change the Ethereal 
+	source code.
+  </para>
+  <para>
+    We hope that you find this book useful, and look forward to your comments.
+  </para>
+  </section>
+
+  <section id="PreAudience">
+  <title>Who should read this document?</title>
+  <para>
+  The intended audience of this book is anyone going into the development of 
+  Ethereal.
+  </para>
+  <para>
+  This book is not intended to explain the usage of Ethereal in general. 
+  Please refer the 
+  <ulink url="&EtherealUsersGuidePage;">Ethereal User's Guide</ulink> 
+  about Ethereal usage.
+  </para>
+  <para>
+  By reading this book, you will learn how to develop Ethereal. It will 
+  hopefully guide you around some common problems that frequently appears for 
+  new (and sometimes even advanced) developers of Ethereal.
+  </para>
+  </section>
+
+  <section id="PreAck">
+  <title>Acknowledgements</title>
+  <para>
+    The authors would like to thank the whole Ethereal team for their 
+	assistance. In particular, the authors would like to thank:
+    <itemizedlist>
+      <listitem>
+	<para>
+	  Gerald Combs, for initiating the Ethereal project.
+	</para>
+      </listitem>
+      <listitem>
+	<para>
+      Guy Harris, for many helpful hints and his effort in maintaining
+      the various contributions on the mailing lists.
+	</para>
+      </listitem>
+    </itemizedlist>
+  </para>
+  <para>
+    The authors would also like to thank the following people for their 
+	helpful feedback on this document:
+    <itemizedlist>
+      <listitem>
+      <para>XXX - Please give feedback :-)
+      </para>
+      </listitem>
+    </itemizedlist>
+	And of course a big thank you to the many, many contributors of the 
+	Ethereal development community!
+  </para>
+  </section>
+
+  <section id="PreAbout">
+    <title>About this document</title>
+    <para>
+      This book was developed by 
+      <ulink url="mailto:&AuthorEmail;">Ulf Lamping</ulink>.
+    </para>
+    <para>
+      It is written in DocBook/XML.
+    </para>
+    <para>
+	You will find some specially marked parts in this book:
+    </para>
+    <warning><title>This is a warning!</title>
+	<para>
+	You should pay attention to a warning, as otherwise data loss might occur.
+	</para>
+    </warning>
+    <note><title>This is a note!</title>
+	<para>
+	A note will point you to common mistakes and things that might not be 
+	obvious.
+	</para>
+    </note>
+    <tip><title>This is a tip!</title>
+	<para>
+	Tips will be helpful for your everyday work developing Ethereal.
+	</para>
+    </tip>
+  </section>
+  
+  <section id="PreDownload">
+    <title>Where to get the latest copy of this document?</title>
+    <para>
+      The latest copy of this documentation can always be found at: 
+     <!-- <ulink url="&LatestVersionWebsite;">&LatestVersionWebsite;</ulink>; 
+      and at: --> 
+      <ulink url="&EtherealWebSite;/docs/developer-guide/"/>.
+	  XXX - is that true?
+    </para>
+   <!-- <para>
+      In addition, you can find a PDF version of the guide at: 
+      <ulink url="&LatestVersionPDFWebsiteA4;">
+	&LatestVersionPDFWebsiteA4;
+      </ulink> 
+      in A4 and 
+      <ulink url="&LatestVersionPDFWebsiteUSLetter;">
+	&LatestVersionPDFWebsiteUSLetter
+      </ulink> 
+      in US Letter.
+    </para> -->    
+  </section>
+
+  <section id="PreFeedback">
+    <title>Providing feedback about this document</title>
+    <para>
+      Should you have any feedback about this document, please send them 
+      to the authors through <ulink url="mailto:&EtherealDevMailList;">&EtherealDevMailList;</ulink>.
+    </para>
+  </section>
+</preface>