diff options
Diffstat (limited to 'docbook/wsdg_src/WSDG_preface.xml')
-rw-r--r-- | docbook/wsdg_src/WSDG_preface.xml | 80 |
1 files changed, 28 insertions, 52 deletions
diff --git a/docbook/wsdg_src/WSDG_preface.xml b/docbook/wsdg_src/WSDG_preface.xml index bd68748339..7c8cded6d8 100644 --- a/docbook/wsdg_src/WSDG_preface.xml +++ b/docbook/wsdg_src/WSDG_preface.xml @@ -5,22 +5,22 @@ <section id="PreForeword"> <title>Foreword</title> <para> - This book tries to give you a guide to start your own experiments into + This book tries to give you a guide to start your own experiments into the wonderful world of Wireshark development. </para> <para> - Developers who are new to Wireshark often have a hard time getting + Developers who are new to Wireshark often have 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 Wireshark 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 + The first part of this book will describe how to set up the environment needed to develop Wireshark. </para> <para> - The second part of this book will describe how to change the Wireshark + The second part of this book will describe how to change the Wireshark source code. </para> <para> @@ -31,18 +31,18 @@ <section id="PreAudience"> <title>Who should read this document?</title> <para> - The intended audience of this book is anyone going into the development of + The intended audience of this book is anyone going into the development of Wireshark. </para> <para> - This book is not intended to explain the usage of Wireshark in general. - Please refer the - <ulink url="&WiresharkUsersGuidePage;">Wireshark User's Guide</ulink> + This book is not intended to explain the usage of Wireshark in general. + Please refer the + <ulink url="&WiresharkUsersGuidePage;">Wireshark User's Guide</ulink> about Wireshark usage. </para> <para> - By reading this book, you will learn how to develop Wireshark. It will - hopefully guide you around some common problems that frequently appear for + By reading this book, you will learn how to develop Wireshark. It will + hopefully guide you around some common problems that frequently appear for new (and sometimes even advanced) developers of Wireshark. </para> </section> @@ -50,7 +50,7 @@ <section id="PreAck"> <title>Acknowledgements</title> <para> - The authors would like to thank the whole Wireshark team for their + The authors would like to thank the whole Wireshark team for their assistance. In particular, the authors would like to thank: <itemizedlist> <listitem> @@ -67,7 +67,7 @@ </itemizedlist> </para> <para> - The authors would also like to thank the following people for their + The authors would also like to thank the following people for their helpful feedback on this document: <itemizedlist> <listitem> @@ -75,7 +75,7 @@ </para> </listitem> </itemizedlist> - And of course a big thank you to the many, many contributors of the + And of course a big thank you to the many, many contributors of the Wireshark development community! </para> </section> @@ -83,61 +83,37 @@ <section id="PreAbout"> <title>About this document</title> <para> - This book was developed by + This book was developed by <ulink url="mailto:&AuthorEmail;">Ulf Lamping</ulink>. </para> <para> It is written in DocBook/XML. </para> <para> - Portions of this book were originally contained in - the file <filename>doc/README.developer</filename> whose contributors - were listed as: - </para> - <literallayout class="monospaced"> - James Coe <jammer[AT]cin.net> - Gilbert Ramirez <gram[AT]alumni.rice.edu> - Jeff Foster <jfoste[AT]woodward.com> - Olivier Abad <oabad[AT]cybercable.fr> - Laurent Deniel <laurent.deniel[AT]free.fr> - Gerald Combs <gerald[AT]wireshark.org> - Guy Harris <guy[AT]alum.mit.edu> - Ulf Lamping <ulf.lamping[AT]web.de> - </literallayout> - <para> - <filename>README.developer</filename> was converted to DocBook/XML - and integrated into this book by - <literal>Bill Meier <wmeier[AT]newsguy.com></literal> - </para> - </section> - - <section id="PreNotation"> - <title>Notation</title> - <para> - You will find some specially marked parts in this book: + 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> + <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> + <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 Wireshark. - </para> + <para> + Tips will be helpful for your everyday work developing Wireshark. + </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: + The latest copy of this documentation can always be found at: <ulink url="&WiresharkDevsGuidePage;">&WiresharkDevsGuidePage;</ulink> in PDF (A4 and US letter), HTML (single and chunked) and CHM format. </para> @@ -146,7 +122,7 @@ <section id="PreFeedback"> <title>Providing feedback about this document</title> <para> - Should you have any feedback about this document, please send it + Should you have any feedback about this document, please send it to the authors through <ulink url="mailto:&WiresharkDevMailList;">&WiresharkDevMailList;</ulink>. </para> </section> |