1[[Preface]]
2["preface",id="Preface"]
3== Preface
4
5[[PreForeword]]
6
7=== Foreword
8
9This book tries to give you a guide to start your own experiments into
10the wonderful world of Wireshark development.
11
12Developers who are new to Wireshark often have a hard time getting
13their development environment up and running. This is
14especially true for Win32 developers, as a lot of the tools and methods
15used when building Wireshark are much more common in the UNIX world than
16on Win32.
17
18The first part of this book will describe how to set up the environment
19needed to develop Wireshark.
20
21The second part of this book will describe how to change the Wireshark
22source code.
23
24We hope that you find this book useful, and look forward to your comments.
25
26[[PreAudience]]
27
28=== Who should read this document?
29
30The intended audience of this book is anyone going into the development of
31Wireshark.
32
33This book is not intended to explain the usage of Wireshark in general.
34Please refer the
35{wireshark-users-guide-url}[Wireshark User’s Guide] about Wireshark usage.
36
37By reading this book, you will learn how to develop Wireshark. It will
38hopefully guide you around some common problems that frequently appear for
39new (and sometimes even advanced) developers of Wireshark.
40
41[[PreAck]]
42
43=== Acknowledgements
44
45The authors would like to thank the whole Wireshark team for their
46assistance. In particular, the authors would like to thank:
47
48* Gerald Combs, for initiating the Wireshark project.
49
50* Guy Harris, for many helpful hints and his effort in maintaining
51the various contributions on the mailing lists.
52
53* Frank Singleton from whose `README.idl2wrs` <<ChDissectIdl2wrs>> is derived.
54
55The authors would also like to thank the following people for their
56helpful feedback on this document:
57
58* XXX - Please give feedback :-)
59
60And of course a big thank you to the many, many contributors of the
61Wireshark development community!
62
63[[PreAbout]]
64
65=== About this document
66
67This book was developed by mailto:{wsdg-author-email}[Ulf Lamping],
68updated for VS2013 by mailto:{wsdg-author-email2}[Graham Bloice],
69and updated for later versions of Visual Studio by various contributors.
70
71It is written in AsciiDoc.
72
73[[PreDownload]]
74
75=== Where to get the latest copy of this document?
76
77The latest copy of this documentation can always be found at
78{wireshark-developers-guide-url}.
79
80[[PreFeedback]]
81
82=== Providing feedback about this document
83
84Should you have any feedback about this document, please send it to the
85authors through mailto:{wireshark-dev-list-email}[].
86
87
88