Skip to content

docs(man): add save and replay examples#35

Merged
sunng87 merged 1 commit into
mainfrom
docs/man-save-replay-examples
Jul 22, 2026
Merged

docs(man): add save and replay examples#35
sunng87 merged 1 commit into
mainfrom
docs/man-save-replay-examples

Conversation

@sunng87

@sunng87 sunng87 commented Jul 22, 2026

Copy link
Copy Markdown
Owner

What

Adds save/replay usage to the EXAMPLES section of the manpage. The SAVED
SESSIONS prose and the --save/--replay OPTIONS entries already landed in
#32, but the EXAMPLES section only covered pcap/mitm/TUI-filter usage.

Why

So the manpage is self-contained and matches the README, which already shows
--save and --replay invocations.

Changes

man/sections.md — three new examples (pandoc → roff via gen_manpage):

  • tapgres --save session.jsonl — tee every decoded record to versioned JSONL
  • tapgres --replay session.jsonl --tui — reopen a saved session in the TUI
  • tapgres --replay session.jsonl -Y 'message.type == "Query"' — replay through a display filter

Verification

  • Regenerated man/tapgres.1 (git-ignored, produced at packaging time).
  • man --warnings -l man/tapgres.10 warnings.
  • New examples and the existing SAVED SESSIONS / OPTIONS sections render correctly.

Notes

  • man/tapgres.1 is git-ignored and rebuilt from man/sections.md + clap
    doc-comments by examples/gen_manpage.rs (see flake.nix:70-72), so this is
    the only source file that needs to change.

The SAVED SESSIONS section and OPTIONS entries for --save/--replay landed
in #32, but the EXAMPLES section only covered pcap/mitm/TUI-filter usage.
Add three examples mirroring the README so the manpage stands alone:

  tapgres --save session.jsonl
  tapgres --replay session.jsonl --tui
  tapgres --replay session.jsonl -Y 'message.type == "Query"'
@sunng87
sunng87 merged commit 65a1a26 into main Jul 22, 2026
2 checks passed
@sunng87
sunng87 deleted the docs/man-save-replay-examples branch July 22, 2026 06:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant