diff options
-rw-r--r-- | scoop.1 | 164 |
1 files changed, 164 insertions, 0 deletions
diff --git a/scoop.1 b/scoop.1 new file mode 100644 index 0000000..6d12d22 --- /dev/null +++ b/scoop.1 @@ -0,0 +1,164 @@ +.Dd December 29, 2019 +.Dt SCOOP 1 +.Os +. +.Sh NAME +.Nm scoop +.Nd query IRC logs +. +.Sh SYNOPSIS +.Nm +.Op Fl pqv +.Op Fl A Ar time +.Op Fl B Ar time +.Op Fl C Ar time +.Op Fl N Ar network +.Op Fl T Ar target +.Op Fl c Ar context +.Op Fl d Ar path +.Op Fl h Ar host +.Op Fl l Ar limit +.Op Fl n Ar nick +.Op Fl t Ar type +.Op Fl u Ar user +.Op Ar search +.Nm +.Fl s +. +.Sh DESCRIPTION +The +.Nm +utility queries the +.Xr litterbox 1 +IRC log database. +If standard output is a terminal, +colored output is piped to +.Ev PAGER +with +.Ev LESS=FRX +if it is not already set. +. +.Pp +The arguments are as follows: +.Bl -tag -width Ds +.It Fl A Ar time +Show events from the same context following each match. +Events which occurred up to +.Ar time +seconds after the matched event are shown. +The +.Ar time +argument may be suffixed with +.Cm s , +.Cm m +or +.Cm h +for seconds, minutes or hours, respectively. +. +.It Fl B Ar time +Show events from the same context preceding each match. +See +.Fl A +for the meaning of +.Ar time . +. +.It Fl C Ar time +Show events from the same context preceding and following each match. +This is equivalent to setting both +.Fl A +and +.Fl B . +. +.It Fl N Ar network +Match events from the specified network. +. +.It Fl T Ar target +Match events +.Po +of type +.Cm kick +or +.Cm nick +.Pc +with the specified +.Ar target . +. +.It Fl c Ar context +Match events from the specified context, +either channel or query name. +. +.It Fl d Ar path +Set the database path. +The database must have been initialized by +.Xr litterbox 1 . +The default path is as in +.Xr litterbox 1 . +. +.It Fl h Ar host +Match events from users with the specified hostname. +. +.It Fl l Ar limit +Limit the number of most recent results. +. +.It Fl n Ar nick +Match events from users with the specified nickname. +. +.It Fl p +Match only events from channels. +. +.It Fl q +Match only events from queries. +. +.It Fl s +Instead of performing a query, +launch the +.Xr sqlite3 1 +shell for the database. +. +.It Fl t Ar type +Match events of the specified +.Ar type . +The types are +.Cm privmsg , +.Cm notice , +.Cm action , +.Cm join , +.Cm part , +.Cm quit , +.Cm kick , +.Cm nick , +.Cm topic . +. +.It Fl u Ar user +Match events from users with the specified username. +. +.It Fl v +Print the SQL query being used on standard error. +. +.It Ar search +Match events using full-text search. +The searchable columns are +.Li network , +.Li channel , +.Li query , +.Li nick , +.Li user , +.Li target , +.Li message . +For search query syntax, see +.Lk https://www.sqlite.org/fts5.html#full_text_query_syntax +.El +. +.Sh SEE ALSO +.Xr litterbox 1 +. +.Sh AUTHORS +.An June Bug Aq Mt june@causal.agency +. +.Sh BUGS +Send mail to +.Aq Mt june@causal.agency +or join +.Li #ascii.town +on +.Li chat.freenode.net . |