aboutsummaryrefslogtreecommitdiffstats
path: root/docbook/wsug_src/WSUG_preface.asciidoc
diff options
context:
space:
mode:
authorGerald Combs <gerald@zing.org>2014-11-09 18:13:57 -0800
committerGerald Combs <gerald@wireshark.org>2014-11-10 05:30:10 +0000
commit62289300d6331b0c23100ae152fddfdc20811733 (patch)
tree5248ee2cdda7131c4172cfdbbb77cfe03605cf4c /docbook/wsug_src/WSUG_preface.asciidoc
parent055e4768ece1033afaf952e161a1e5d75a62961f (diff)
Finish converting the User's Guide to AsciiDoc.
As with the Developer's Guide, add user-guide-docinfo.xml, which lets us carry over DocBook front matter. Remove the meta_info chapter. Most of its contents are now in user-guide-docinfo.xml. Add a DocBook revision history based on hints from the Git/SVN/CVS revision history. Remove the various makefile targets for converting AsciiDoc files to DocBook chapters. Remove GPL_appendix.xml. We use the AsciiDoc version. Change-Id: I543fa2a92f2c735c5f00c97ec65cff2187e09e3a Reviewed-on: https://code.wireshark.org/review/5216 Petri-Dish: Gerald Combs <gerald@wireshark.org> Tested-by: Petri Dish Buildbot <buildbot-no-reply@wireshark.org> Reviewed-by: Gerald Combs <gerald@wireshark.org>
Diffstat (limited to 'docbook/wsug_src/WSUG_preface.asciidoc')
-rw-r--r--docbook/wsug_src/WSUG_preface.asciidoc46
1 files changed, 22 insertions, 24 deletions
diff --git a/docbook/wsug_src/WSUG_preface.asciidoc b/docbook/wsug_src/WSUG_preface.asciidoc
index 6dd63ea463..3b00a89380 100644
--- a/docbook/wsug_src/WSUG_preface.asciidoc
+++ b/docbook/wsug_src/WSUG_preface.asciidoc
@@ -1,8 +1,6 @@
-[[Preface]]
-
-[preface]
-
-== Preface
+++++++++++++++++++++++++++++++++++++++
+<!-- WSUG Preface -->
+++++++++++++++++++++++++++++++++++++++
[[PreForeword]]
@@ -15,7 +13,7 @@ Wireshark because of the lack of documentation.
This document is part of an effort by the Wireshark team to improve the
usability of Wireshark.
-We hope that you find it useful and look forward to your comments.
+We hope that you find it useful and look forward to your comments.
[[PreAudience]]
@@ -36,14 +34,14 @@ 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) users of Wireshark.
[[PreAck]]
=== Acknowledgements
The authors would like to thank the whole Wireshark team for their assistance.
-In particular, the authors would like to thank:
+In particular, the authors would like to thank:
* Gerald Combs, for initiating the Wireshark project and funding to do this
documentation.
@@ -51,23 +49,23 @@ In particular, the authors would like to thank:
* 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.
+* 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:
+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.
+* Martin Regner, for his various suggestions and corrections.
-* Graeme Hewson, for a lot of grammatical corrections.
+* Graeme Hewson, for a lot of 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:
+Wireshark project from who sections of this document borrow heavily:
-* Scott Renfro from whose `mergecap` man page <<AppToolsmergecap>> is derived.
+* Scott Renfro from whose `mergecap` man page <<AppToolsmergecap>> is derived.
-* Ashok Narayanan from whose `text2pcap` man page <<AppToolstext2pcap>> is derived.
+* Ashok Narayanan from whose `text2pcap` man page <<AppToolstext2pcap>> is derived.
[[PreAbout]]
@@ -76,39 +74,39 @@ Wireshark project from who sections of this document borrow heavily:
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].
+updated by mailto:wsug-author-email:[][Ulf Lamping].
-It was originally written in DocBook/XML and converted to AsciiDoc by Gerald Combs.
+It was originally written in DocBook/XML and converted to AsciiDoc by Gerald Combs.
-You will find some specially marked parts in this book:
+You will find some specially marked parts in this book:
[WARNING]
.This is a warning
====
-You should pay attention to a warning, otherwise data loss might occur.
+You should pay attention to a warning, otherwise data loss might occur.
====
[NOTE]
.This is a note
====
-A note will point you to common mistakes and things that might not be obvious.
+A note will point you to common mistakes and things that might not be obvious.
====
[TIP]
.This is a tip
====
-Tips are helpful for your everyday work using Wireshark.
+Tips are helpful for your everyday work using Wireshark.
====
[[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:[][].
+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:[][wireshark-dev-list-email:[]].
+through mailto:wireshark-dev-list-email:[][wireshark-dev-list-email:[]].