summaryrefslogtreecommitdiffstats
path: root/doc/wsug_src/wsug_preface.adoc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/wsug_src/wsug_preface.adoc')
-rw-r--r--doc/wsug_src/wsug_preface.adoc91
1 files changed, 91 insertions, 0 deletions
diff --git a/doc/wsug_src/wsug_preface.adoc b/doc/wsug_src/wsug_preface.adoc
new file mode 100644
index 00000000..c343a805
--- /dev/null
+++ b/doc/wsug_src/wsug_preface.adoc
@@ -0,0 +1,91 @@
+[#Preface]
+["preface",id="Preface"]
+== Preface
+
+[#PreForeword]
+
+=== Foreword
+
+Wireshark is the world’s foremost network protocol analyzer,
+but the rich feature set can be daunting for the unfamiliar.
+This document is part of an effort by the Wireshark team to improve
+Wireshark's usability.
+We hope that you find it useful and look forward to your comments.
+
+[#PreAudience]
+
+=== Who should read this document?
+
+The intended audience of this book is anyone using Wireshark.
+
+This book explains all of the basic and some advanced features
+of Wireshark. As Wireshark has become a very complex program,
+not every feature may be explained in this book.
+
+This book is not intended to explain network sniffing in general and it
+will not provide details about specific network protocols. A lot of
+useful information regarding these topics can be found at the Wireshark
+Wiki at link:{wireshark-wiki-url}[].
+
+By reading this book, you will learn how to install Wireshark, how to use the
+basic elements of the graphical user interface (such as the menu) and what’s
+behind some of the advanced features that are not always obvious at first sight.
+It will hopefully guide you around some common problems that frequently appear
+for new (and sometimes even advanced) Wireshark users.
+
+[#PreAck]
+
+=== Acknowledgements
+
+The authors would like to thank the whole Wireshark team for their assistance.
+In particular, the authors would like to thank:
+
+* Gerald Combs, for initiating the Wireshark project and funding to do this
+ documentation.
+
+* Guy Harris, for many helpful hints and a great deal of patience in reviewing
+ this document.
+
+* Gilbert Ramirez, for general encouragement and helpful hints along the way.
+
+The authors would also like to thank the following people for their helpful
+feedback on this document:
+
+* Pat Eyler, for his suggestions on improving the example on generating a backtrace.
+
+* Martin Regner, for his various suggestions and corrections.
+
+* Graeme Hewson, for many grammatical corrections.
+
+The authors would like to acknowledge those man page and README authors for the
+Wireshark project from who sections of this document borrow heavily:
+
+* Scott Renfro from whose `mergecap` man page <<AppToolsmergecap>> is derived.
+
+* Ashok Narayanan from whose `text2pcap` man page <<AppToolstext2pcap>> is derived.
+
+[#PreAbout]
+
+=== About this document
+
+This book was originally developed by mailto:{wsug-author-email2}[Richard
+Sharpe] with funds provided from the Wireshark Fund. It was updated by
+mailto:{wsug-author-email3}[Ed Warnicke] and more recently redesigned and
+updated by mailto:{wsug-author-email}[Ulf Lamping].
+
+It was originally written in DocBook/XML and converted to AsciiDoc by
+Gerald Combs.
+
+[#PreDownload]
+
+=== Where to get the latest copy of this document?
+
+The latest copy of this documentation can always be found at
+{wireshark-users-guide-url}.
+
+[#PreFeedback]
+
+=== Providing feedback about this document
+
+Should you have any feedback about this document, please send it to the
+authors through mailto:{wireshark-dev-list-email}[].