diff options
Diffstat (limited to 'scoop.1')
-rw-r--r-- | scoop.1 | 76 |
1 files changed, 46 insertions, 30 deletions
diff --git a/scoop.1 b/scoop.1 index 51ad6c7..8687e5d 100644 --- a/scoop.1 +++ b/scoop.1 @@ -1,4 +1,4 @@ -.Dd May 20, 2020 +.Dd May 18, 2021 .Dt SCOOP 1 .Os . @@ -8,7 +8,7 @@ . .Sh SYNOPSIS .Nm -.Op Fl Lgpqsv +.Op Fl Lgipqrsv .Op Fl D Ar date .Op Fl F Ar format .Op Fl N Ar network @@ -53,22 +53,25 @@ The arguments are as follows: Match events which occurred on .Ar date , of the format -.Ar YYYY-MM-DD -or the keyword -.Cm now . +.Ar YYYY-MM-DD . . .It Fl F Ar format Format timestamps using the .Ar format string, similar to -.Xr strftime 3 , -see -.Aq Lk https://www.sqlite.org/lang_datefunc.html . -The default format is ISO 8601. +.Xr strftime 3 . +The default format is +.Qq %Y-%m-%dT%H:%M:%S . . .It Fl L -Output timestamps in local time. +Output timestamps in local time +and interpret timestamps in +.Fl D , +.Fl a +and +.Fl b +as local time. . .It Fl N Ar network Match events from @@ -85,9 +88,10 @@ Match events .Po of type .Cm kick , -.Cm nick -or +.Cm nick , .Cm ban +or +.Cm unban .Pc with the target nickname or mask .Ar target . @@ -117,19 +121,20 @@ The default path is as in .It Fl f Ar format Set the output format to one of .Cm plain , -.Cm color , +.Cm color +or .Cm irc . +The default format is +.Cm color +if standard output is a terminal, +.Cm plain +otherwise. The .Cm irc format outputs events as IRC protocol with .Sy server-time tags. -The default format is -.Cm color -if standard output is a terminal, -.Cm plain -otherwise. . .It Fl g Group events by network and channel or query name. @@ -140,9 +145,14 @@ Implies Match events from users with the hostname .Ar host . . +.It Fl i +Use case-insensitive regular expression matching +with +.Fl m . +. .It Fl l Ar limit Limit the number of events matched, -ordered by most recent. +ordered by most recently inserted. Implies .Fl s . . @@ -152,6 +162,9 @@ matching the modern regular expression .Ar regexp . See .Xr re_format 7 . +To match case-insensitively, +use with +.Fl i . . .It Fl n Ar nick Match events from users with the nickname @@ -163,14 +176,18 @@ Match only events from channels. .It Fl q Match only events from queries. . +.It Fl r +Output results in reverse order. +. .It Fl s 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 +.It Fl t Ar types Match events of -.Ar type . +the comma-separated list of +.Ar types . The types are .Cm privmsg , .Cm notice , @@ -208,8 +225,6 @@ The searchable columns are .Li user , .Li target , .Li message . -For search query syntax, see -.Aq Lk https://www.sqlite.org/fts5.html#full_text_query_syntax . .El . .Sh ENVIRONMENT @@ -218,18 +233,19 @@ For search query syntax, see The command to pipe terminal output to. The default is .Ev PAGER=less . -.It Ev SHELL -The shell used to run -.Ev PAGER . -The default is -.Pa /bin/sh . .El . .Sh SEE ALSO .Xr litterbox 1 +.Bl -item +.It +.Lk https://www.sqlite.org/lang_datefunc.html "Date and Time Functions" +.It +.Lk https://www.sqlite.org/fts5.html#full_text_query_syntax "Full-text Query Syntax" +.El . .Sh AUTHORS -.An June Bug Aq Mt june@causal.agency +.An June McEnroe Aq Mt june@causal.agency . .Sh BUGS Send mail to @@ -237,4 +253,4 @@ Send mail to or join .Li #ascii.town on -.Li chat.freenode.net . +.Li irc.tilde.chat . |