From a6e1441bec7609a121e442bb75100a61a43f0258 Mon Sep 17 00:00:00 2001
From: "C. McEnroe" <june@causal.agency>
Date: Thu, 21 May 2020 13:55:25 -0400
Subject: Do not sort results in scoop by default

The -s flag now enables sorting (-g and -l also imply it), while the -S
flag now launches the sqlite3 shell.

Avoiding sorting by default is much faster and less memory-intensive as
it doesn't require loading the entire result set into memory at once.
---
 scoop.1 | 25 +++++++++++++++----------
 1 file changed, 15 insertions(+), 10 deletions(-)

(limited to 'scoop.1')

diff --git a/scoop.1 b/scoop.1
index e4eedfd..fddd749 100644
--- a/scoop.1
+++ b/scoop.1
@@ -8,7 +8,7 @@
 .
 .Sh SYNOPSIS
 .Nm
-.Op Fl Lgpqv
+.Op Fl Lgpqsv
 .Op Fl D Ar date
 .Op Fl F Ar format
 .Op Fl N Ar network
@@ -27,7 +27,7 @@
 .Op Fl w Ar expr
 .Op Ar search
 .Nm
-.Fl s
+.Fl S
 .
 .Sh DESCRIPTION
 The
@@ -37,10 +37,6 @@ utility queries the
 IRC log database,
 matching events on the intersection
 of the criteria specified in arguments.
-With no arguments,
-all events in the database are matched.
-Events are output in order
-from oldest to newest.
 .
 .Pp
 If standard output is a terminal,
@@ -78,6 +74,12 @@ Output timestamps in local time.
 Match events from
 .Ar network .
 .
+.It Fl S
+Instead of performing a query,
+launch the
+.Xr sqlite3 1
+shell for the database.
+.
 .It Fl T Ar target
 Match events
 .Po
@@ -131,6 +133,8 @@ otherwise.
 .
 .It Fl g
 Group events by network and channel or query name.
+Implies
+.Fl s .
 .
 .It Fl h Ar host
 Match events from users with the hostname
@@ -139,6 +143,8 @@ Match events from users with the hostname
 .It Fl l Ar limit
 Limit the number of events matched,
 ordered by most recent.
+Implies
+.Fl s .
 .
 .It Fl m Ar regexp
 Match events with messages
@@ -158,10 +164,9 @@ Match only events from channels.
 Match only events from queries.
 .
 .It Fl s
-Instead of performing a query,
-launch the
-.Xr sqlite3 1
-shell for the database.
+Sort the results from oldest to newest.
+By default events are output
+in the order they appear in the database.
 .
 .It Fl t Ar type
 Match events of
-- 
cgit 1.4.1