From fc3f061829aa4ba20589bd4caa802aee1756f083 Mon Sep 17 00:00:00 2001
From: David Perry <boolean263@protonmail.com>
Date: Fri, 11 Feb 2022 01:54:53 +0000
Subject: Differentiate `-c` from `-a packets:`

---
 doc/dumpcap.adoc   | 4 ++--
 doc/tshark.adoc    | 8 ++++++--
 doc/wireshark.adoc | 4 ++--
 3 files changed, 10 insertions(+), 6 deletions(-)

(limited to 'doc')

diff --git a/doc/dumpcap.adoc b/doc/dumpcap.adoc
index dd64413875..68298de584 100644
--- a/doc/dumpcap.adoc
+++ b/doc/dumpcap.adoc
@@ -88,7 +88,7 @@ stop writing to the current capture file and switch to the next one if filesize
 is reached.  Note that the filesize is limited to a maximum value of 2 GiB.
 
 *packets*:__value__ Stop writing to a capture file after __value__ packets
-have been written. Same as *-c* <capture packet count>.
+have been written. Acts the same as *-c* <capture packet count>.
 --
 
 -b|--ring-buffer  <capture ring buffer option>::
@@ -170,7 +170,7 @@ the default capture buffer size is used instead.
 +
 --
 Set the maximum number of packets to read when capturing live
-data. Same as *-a packets:*<capture packet count>.
+data. Acts the same as *-a packets:*<capture packet count>.
 --
 
 -C  <byte limit>::
diff --git a/doc/tshark.adoc b/doc/tshark.adoc
index 63bcaa383d..10c75b5c1d 100644
--- a/doc/tshark.adoc
+++ b/doc/tshark.adoc
@@ -184,7 +184,9 @@ packet  will be read, so more bytes than this number may be read).  Note that
 the filesize is limited to a maximum value of 2 GiB.
 
 *packets*:__value__ switch to the next file after it contains __value__
-packets. Same as *-c*<capture packet count>.
+packets.
+This does not include any packets that do not pass the display filter, so it
+may differ from *-c*<capture packet count>.
 --
 
 -A  <user>:<password>::
@@ -279,8 +281,10 @@ the default capture buffer size is used instead.
 +
 --
 Set the maximum number of packets to read when capturing live
-data. Same as *-a packets:*<capture packet count>.
+data.
 If reading a capture file, set the maximum number of packets to read.
+This includes any packets that do not pass the display filter, so it
+may differ from *-a packets:*<capture packet count>.
 --
 
 -C  <configuration profile>::
diff --git a/doc/wireshark.adoc b/doc/wireshark.adoc
index bfc1501daa..0a9861ab7f 100644
--- a/doc/wireshark.adoc
+++ b/doc/wireshark.adoc
@@ -189,7 +189,7 @@ filesize is reached.  Note that the filesize is limited to a maximum value of
 2 GiB.
 
 *packets*:__value__ Stop writing to a capture file after it contains __value__
-packets. Same as *-c*<capture packet count>.
+packets. Acts the same as *-c*<capture packet count>.
 --
 
 -b|--ring-buffer  <capture ring buffer option>::
@@ -266,7 +266,7 @@ the default capture buffer size is used instead.
 +
 --
 Set the maximum number of packets to read when capturing live
-data. Same as *-a packets:*<capture packet count>.
+data. Acts the same as *-a packets:*<capture packet count>.
 --
 
 -C  <configuration profile>::
-- 
cgit v1.2.3