From e24b354bc5609834bbd1ff18512e9a348cf21914 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Stig=20Bj=C3=B8rlykke?= <stig@bjorlykke.org>
Date: Fri, 1 Jan 2010 17:00:17 +0000
Subject: [PATCH] Document the ignore packets functions. Update the mark
 packets functions.

svn path=/trunk/; revision=31399
---
 docbook/wsug_src/WSUG_chapter_use.xml  | 31 +++++++++++++++--
 docbook/wsug_src/WSUG_chapter_work.xml | 47 ++++++++++++++++++++++++--
 2 files changed, 73 insertions(+), 5 deletions(-)

diff --git a/docbook/wsug_src/WSUG_chapter_use.xml b/docbook/wsug_src/WSUG_chapter_use.xml
index f6f887d48a..0b58e55ac6 100644
--- a/docbook/wsug_src/WSUG_chapter_use.xml
+++ b/docbook/wsug_src/WSUG_chapter_use.xml
@@ -733,10 +733,10 @@
 		  </para></entry>
 	      </row>
 	      <row>
-		<entry><command>Mark All Packets</command></entry>
+		<entry><command>Mark All Displayed Packets</command></entry>
 		<entry></entry>
 		<entry><para>
-		    This menu item "marks" all packets.
+		    This menu item "marks" all displayed packets.
 		  </para></entry>
 	      </row>
 	      <row>
@@ -750,6 +750,33 @@
 		<entry></entry>
 		<entry></entry>
 	      </row>
+	      <row>
+		<entry><command>Ignore Packet (toggle)</command></entry>
+		<entry>Ctrl+X</entry>
+		<entry><para>
+		    This menu item marks the currently selected packet as ignored.
+		    See <xref linkend="ChWorkIgnorePacketSection"/> for details.
+		  </para></entry>
+	      </row>
+	      <row>
+		<entry><command>Ignore All Displayed Packets</command></entry>
+		<entry>Shift-Ctrl-Alt-X</entry>
+		<entry><para>
+		    This menu item marks all displayed packets as ignored.
+		  </para></entry>
+	      </row>
+	      <row>
+		<entry><command>Un-Ignore All Packets</command></entry>
+		<entry>Shift-Ctrl-X</entry>
+		<entry><para>
+		    This menu item unmarks all ignored packets.
+		  </para></entry>
+	      </row>
+	      <row>
+		<entry><command>------</command></entry>
+		<entry></entry>
+		<entry></entry>
+	      </row>
 	      <row>
 		<entry><command>Set Time Reference (toggle)</command></entry>
 		<entry>Ctrl+T</entry>
diff --git a/docbook/wsug_src/WSUG_chapter_work.xml b/docbook/wsug_src/WSUG_chapter_work.xml
index c7d96981a1..4cfd0f8413 100644
--- a/docbook/wsug_src/WSUG_chapter_work.xml
+++ b/docbook/wsug_src/WSUG_chapter_work.xml
@@ -1417,8 +1417,8 @@ eth.src[1-2] == 00:83
 		</listitem>
 		<listitem>
     		<para>
-			<command>Mark all packets</command> set the mark state of all 
-			packets.
+			<command>Mark all displayed packets</command> set the mark state of all 
+			displayed packets.
     		</para>
 		</listitem>
 		<listitem>
@@ -1428,12 +1428,53 @@ eth.src[1-2] == 00:83
     		</para>
 		</listitem>
 	</itemizedlist>
-	These mark function are available from the "Edit" menu, and the 
+	These mark functions are available from the "Edit" menu, and the 
 	"Mark packet (toggle)" function is also available from the pop-up menu of 
 	the "Packet List" pane.
     </para>
   </section>
 	
+  <section id="ChWorkIgnorePacketSection"><title>Ignoring packets</title>
+    <para>
+	You can ignore packets in the "Packet List" pane.  Wireshark will then pretend that this
+	packets does not exist in the capture file. 
+	An ignored packet will be shown with white background and gray foreground, regardless
+	of the coloring rules set.
+    </para>
+    <warning><title>Warning!</title>
+    <para>
+	The packet ignored marks are not stored in the capture file or anywhere else, 
+	so all packet ignored marks will be lost if you close the capture file.
+    </para>
+    </warning>
+    <para>
+	There are three functions to manipulate the ignored state of a packet:
+	<itemizedlist>
+		<listitem>
+    		<para>
+			<command>Ignore packet (toggle)</command> toggles the ignored state 
+			of a single packet.
+    		</para>
+		</listitem>
+		<listitem>
+    		<para>
+			<command>Ignore all displayed packets</command> set the ignored state of all 
+			displayed packets.
+    		</para>
+		</listitem>
+		<listitem>
+    		<para>
+			<command>Un-Ignore all packets</command> reset the ignored state of all 
+			packets.
+    		</para>
+		</listitem>
+	</itemizedlist>
+	These ignore functions are available from the "Edit" menu, and the 
+	"Ignore packet (toggle)" function is also available from the pop-up menu of 
+	the "Packet List" pane.
+    </para>
+  </section>
+	
   <section id="ChWorkTimeFormatsSection"><title>Time display formats and time 
   references</title>
 	<para>