From 3ceddc57d32ee619f229b6038ba916766a2a6756 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Irene=20R=C3=BCngeler?= <I.Ruengeler@fh-muenster.de>
Date: Tue, 14 Aug 2012 07:56:36 +0000
Subject: Add some explanations for the change Capture options Dialog

svn path=/trunk/; revision=44484
---
 docbook/user-guide.xml                             |   1 +
 docbook/wsug_graphics/captureOptions.png           | Bin 0 -> 139877 bytes
 .../ws-capture-options-compile-selected-bpfs.png   | Bin 0 -> 55945 bytes
 docbook/wsug_graphics/ws-capture-options.png       | Bin 137389 -> 139877 bytes
 docbook/wsug_src/WSUG_chapter_capture.xml          |  45 +++++++++++++++++++++
 5 files changed, 46 insertions(+)
 create mode 100644 docbook/wsug_graphics/captureOptions.png
 create mode 100644 docbook/wsug_graphics/ws-capture-options-compile-selected-bpfs.png

(limited to 'docbook')

diff --git a/docbook/user-guide.xml b/docbook/user-guide.xml
index ad5a651466..a89e167ef1 100644
--- a/docbook/user-guide.xml
+++ b/docbook/user-guide.xml
@@ -260,6 +260,7 @@ FILE SECTION
   <!ENTITY WiresharkCaptureInterfacesDialogWin32 SYSTEM "./wsug_graphics/ws-capture-interfaces-win32.png" NDATA PNG>
   <!ENTITY WiresharkCaptureOptionsDialog SYSTEM "./wsug_graphics/ws-capture-options.png" NDATA PNG>
   <!ENTITY WiresharkCaptureEditInterfacesSettingsDialog SYSTEM "./wsug_graphics/ws-capture-options-settings.png" NDATA PNG>
+  <!ENTITY WiresharkCaptureCompileSelectedBPFsDialog SYSTEM "./wsug_graphics/ws-capture-options-compile-selected-bpfs.png" NDATA PNG>
   <!ENTITY WiresharkCaptureManageInterfacesDialog SYSTEM "./wsug_graphics/ws-capture-options-manage-interfaces.png" NDATA PNG>
   <!ENTITY WiresharkCaptureManageInterfacesPipesDialog SYSTEM "./wsug_graphics/ws-capture-options-manage-interfaces-pipes.png" NDATA PNG>
   <!ENTITY WiresharkCaptureManageInterfacesLocalDialog SYSTEM "./wsug_graphics/ws-capture-options-manage-interfaces-local.png" NDATA PNG>
diff --git a/docbook/wsug_graphics/captureOptions.png b/docbook/wsug_graphics/captureOptions.png
new file mode 100644
index 0000000000..4cb2e97449
Binary files /dev/null and b/docbook/wsug_graphics/captureOptions.png differ
diff --git a/docbook/wsug_graphics/ws-capture-options-compile-selected-bpfs.png b/docbook/wsug_graphics/ws-capture-options-compile-selected-bpfs.png
new file mode 100644
index 0000000000..9c66c05dad
Binary files /dev/null and b/docbook/wsug_graphics/ws-capture-options-compile-selected-bpfs.png differ
diff --git a/docbook/wsug_graphics/ws-capture-options.png b/docbook/wsug_graphics/ws-capture-options.png
index da9d26bb3b..4cb2e97449 100644
Binary files a/docbook/wsug_graphics/ws-capture-options.png and b/docbook/wsug_graphics/ws-capture-options.png differ
diff --git a/docbook/wsug_src/WSUG_chapter_capture.xml b/docbook/wsug_src/WSUG_chapter_capture.xml
index b84bef1bfb..9ac0de8768 100644
--- a/docbook/wsug_src/WSUG_chapter_capture.xml
+++ b/docbook/wsug_src/WSUG_chapter_capture.xml
@@ -358,6 +358,35 @@ wireshark -i eth0 -k
 	      </para>
 	    </listitem>
 	  </varlistentry>
+	  <varlistentry><term><command>Capture Filter</command></term>
+	    <listitem>
+	      <para>
+		This field allows you to specify a capture filter for all interfaces
+		that are currently selected. Once a filter has been entered in this field,
+		the newly selected interfaces will inherit the filter.
+		Capture filters are discussed in more details in 
+		<xref linkend="ChCapCaptureFilterSection"/>. It defaults to empty, or 
+		  no filter.
+	      </para>
+	      <para>
+		You can also click on the button labeled "Capture Filter", and Wireshark 
+		will bring up the Capture Filters dialog box and allow you to create 
+		and/or select a filter.  Please see 
+		<xref linkend="ChWorkDefineFilterSection"/>
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry><term><command>Compile selected BPFs</command></term>
+	    <listitem>
+	      <para>
+		This button allows you to compile the capture filter into BPF code and
+		pop up a window showing you the resulting pseudo code. This can help in 
+		understanding the working of the capture filter you created.
+		The "Compile selected BPFs" button leads you to 
+		<xref linkend="ChCapCompileSelectedBpfsDialog"/>.
+	      </para>
+	    </listitem>
+	  </varlistentry>
 	  <varlistentry>
 	    <term>
               <command>Manage Interfaces</command>
@@ -744,6 +773,22 @@ wireshark -i eth0 -k
       </variablelist>
     </section>
 
+     <section id="ChCapCompileSelectedBpfsSection">
+      <title>The "Compile Results" dialog box</title>
+      <para>
+	This figure shows the compile results of the selected interfaces. 
+      </para>
+      	<figure id="ChCapCompileSelectedBpfsDialog">
+      <title>The "Compile Results" dialog box</title>
+      <graphic entityref="WiresharkCaptureCompileSelectedBPFsDialog" format="PNG"/>
+      </figure>
+ <para>
+ In the left window the interface names are listed. A green bullet indicates a successful 
+ compilation, a red bullet a failure. The results of an individual interface are shown
+ in the right window, when it is selected.
+ </para>
+ </section>
+	
    <section id="ChCapManageInterfacesSection">
       <title>The "Add New Interfaces" dialog box</title>
       <para>
-- 
cgit v1.2.3