Feature: highlight numbers of triggering lines.

When a triggered snapshot is recorded, a flag is set
in all the lines which matched the trigger patterns.
Whenever highlighting is enabled, the line numbers of
those lines are shown in inverse.

1 files changed, 10 insertions, 1 deletions

diff --git a/pw.1 b/pw.1
index 446d7da..80f8df7 100644
--- a/pw.1
+++ b/pw.1
@@ -281,13 +281,22 @@ than refreshing the display.
 
 .IP "\fBCtrl-I, Tab\fP"
 Toggle the highlighting of separator characters appearing in the line
-display. The when toggled on, the
+display, and of the line numbers of snapshot lines which activated
+a trigger. When toggled on, the
 .BR > ,
 .B <
 and
 .B |
 characters which indicate line truncation and pane separation are
 shown in inverse video (dark foreground, light background).
+At the moment when the conditions are met for recording a new triggered
+snapshot, all lines targeted by trigger patterns (which must necessarily all
+have matched) are flagged for highlighting. Whenever line numbers
+are enabled with the
+.I #
+command, and highlighting is enabled, then the line numbers of the flagged
+lines are shown in inverse video. Once a line is flagged, it stays flagged
+as it moves through the FIFO and through the snapshot history.
 
 .IP [\fIcount\fP]\fBt\fP
 Set the tab stop size. If count is omitted, zero, or greater than 16,