aboutsummaryrefslogtreecommitdiffstats
path: root/docbook/edg_src/EDG_preface.xml
blob: 1961b265e247044da0d467d39573674bfe07e1a8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
<!-- $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="&EtherealDevsGuidePage;">&EtherealDevsGuidePage;</ulink>
	  in PDF (A4 and US letter), HTML (single and chunked) and CHM format.
    </para>
  </section>

  <section id="PreFeedback">
    <title>Providing feedback about this document</title>
    <para>
      Should you have any feedback about this document, please send it 
      to the authors through <ulink url="mailto:&EtherealDevMailList;">&EtherealDevMailList;</ulink>.
    </para>
  </section>
</preface>