diff options
Diffstat (limited to 'pw.1')
| -rw-r--r-- | pw.1 | 52 |
1 files changed, 50 insertions, 2 deletions
@@ -156,8 +156,12 @@ Scroll the display to the right. Reset scroll to first column. .IP \fISpace\fP -Suspend the refresh of the display. In suspended mode, input continues to pass -through the FIFO, but all display refresh is stopped. The status indicator +Suspend the acquisition of new snapshots. In suspended mode, +input continues to pass through the FIFO, but new snapshots of data aren't +taken. The display updates only due to horizontal scrolling, history +browsing, resize, or +.B Ctrl-Z +suspend and resume. The status indicator .B SUSPENDED is displayed below the data. If the the status is already .B EOF @@ -299,6 +303,50 @@ less recently received items, closer to the tail of the FIFO. The advance/delay commands will not move any trigger to a position which corresponds to a line that is not displayed. +.IP "\fBk\fP, \fIUp Arrow\fP" +Switch the display to earlier snapshot. Each time +.I pw +updates the display with a snapshot of data, the existing snapshot +is entered into a history window, where it becomes snapshot 1. +The previous snapshot 1 becomes 2, and so on. 19 snapshots are retained. +The +.B k +command switches to an older snapshot: from current to 1, or from +1 to 2, and so on. When snapshot 1 to 19 is being displayed, +the status line shows +.BI HIST num +where +.I num +is the snapshot number. + +Tip: the snapshot history is particularly useful when it is gathered by +triggering. See the +.B / +and +.B ? +commands above. Triggered snapshots can reveal recurring patterns in the input. +The history can be used to identify differences among triggered snapshots which +appear and disappear too rapidly to be read in real time. One of the possible +uses of that information is to refine the trigger patterns in order to capture +snapshots that are more similar to each other. In the absence of triggering, +historic snapshots may be completely unrelated. + +Tip: it is usually useful to pause the acquisition of snapshots when browsing +the history: see the +.B Space +command above. Snapshot acquisition is be observed while browsing the history, +since every historic snapshot moves to a higher number when a snapshot is +taken, while the displayed number stays the same, and the display updates +accordingly. + +.IP "\fBl\fP, \fIDown Arrow\fP" +Go back to earlier snapshot in history. If snapshot 1 is +currently being displayed, then +.I pw +switches to the current snapshot and the +.B HIST +indicator in the status line disappears. + .IP "[\fIcount\fP]\fB+\fP" Increases the display size by .I count |