aboutsummaryrefslogtreecommitdiffstats
path: root/docbook
diff options
context:
space:
mode:
authorMoshe Kaplan <me@moshekaplan.com>2019-04-12 14:23:44 -0400
committerGerald Combs <gerald@wireshark.org>2019-04-12 20:20:37 +0000
commit75b03ac485935e35a7dcc97d91acd832daba89a5 (patch)
tree82f4222c0bdb32f7eeeac0975711e9e2eb24396a /docbook
parent6f57aa72a8a14ee2247ea9180a34dcd21dd6ed3b (diff)
Improve phrasing in wsug-preface
Change-Id: I3460abadb36f77ec9d3eaac694a070b9a8eccdd0 Reviewed-on: https://code.wireshark.org/review/32838 Reviewed-by: Gerald Combs <gerald@wireshark.org>
Diffstat (limited to 'docbook')
-rw-r--r--docbook/wsug_src/WSUG_preface.adoc23
1 files changed, 10 insertions, 13 deletions
diff --git a/docbook/wsug_src/WSUG_preface.adoc b/docbook/wsug_src/WSUG_preface.adoc
index 599105aa7a..dabf7dc623 100644
--- a/docbook/wsug_src/WSUG_preface.adoc
+++ b/docbook/wsug_src/WSUG_preface.adoc
@@ -4,13 +4,10 @@
=== Foreword
-Wireshark is one of those programs that many network managers would love to be
-able to use, but they are often prevented from getting what they would like from
-Wireshark because of the lack of documentation.
-
-This document is part of an effort by the Wireshark team to improve the
-usability of Wireshark.
-
+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]]
@@ -19,9 +16,9 @@ We hope that you find it useful and look forward to your comments.
The intended audience of this book is anyone using Wireshark.
-This book will explain all the basics and also some of the advanced features
-that Wireshark provides. As Wireshark has become a very complex program since
-the early days, not every feature of Wireshark may be explained in this book.
+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
@@ -32,7 +29,7 @@ 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) users of Wireshark.
+for new (and sometimes even advanced) Wireshark users.
[[PreAck]]
@@ -52,11 +49,11 @@ In particular, the authors would like to thank:
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.
+* Pat Eyler, for his suggestions on improving the example on generating a backtrace.
* Martin Regner, for his various suggestions and corrections.
-* Graeme Hewson, for a lot of grammatical 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: