diff options
author | Moshe Kaplan <me@moshekaplan.com> | 2019-04-12 14:23:44 -0400 |
---|---|---|
committer | Gerald Combs <gerald@wireshark.org> | 2019-04-12 20:20:37 +0000 |
commit | 75b03ac485935e35a7dcc97d91acd832daba89a5 (patch) | |
tree | 82f4222c0bdb32f7eeeac0975711e9e2eb24396a /docbook | |
parent | 6f57aa72a8a14ee2247ea9180a34dcd21dd6ed3b (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.adoc | 23 |
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: |