]> source.dussan.org Git - rspamd.git/commitdiff
[Minor] Update help/man pages
authorVsevolod Stakhov <vsevolod@highsecure.ru>
Sat, 28 Jul 2018 14:13:30 +0000 (15:13 +0100)
committerVsevolod Stakhov <vsevolod@highsecure.ru>
Sat, 28 Jul 2018 14:13:30 +0000 (15:13 +0100)
doc/rspamc.1
doc/rspamc.1.md
src/client/rspamc.c

index 0100cb41b7baf1015f28a90f704517f4fc5867d1..338f8053d924ce341fc6c4d3eac7756934cb552f 100644 (file)
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pandoc 1.17.2
+.\" Automatically generated by Pandoc 2.2.2.1
 .\"
 .TH "RSPAMC" "1" "" "Rspamd User Manual" ""
 .hy
@@ -7,13 +7,13 @@
 \f[C]rspamc\f[] \- rspamd command line client
 .SH SYNOPSIS
 .PP
-rspamc [\f[I]options\f[]] [\f[I]command\f[]] [\f[I]input\-file\f[]]...
+rspamc [\f[I]options\f[]] [\f[I]command\f[]] [\f[I]input\-file\f[]]\&...
 .PP
-rspamc \-\-help
+rspamc \[en]help
 .SH DESCRIPTION
 .PP
-\f[C]rspamc\f[] is a simple client for checking messages using rspamd or
-for learning rspamd by messages.
+\f[C]rspamc\f[] is a simple rspamd client, primarily for classifying or
+learning messages.
 \f[C]rspamc\f[] supports the following commands:
 .IP \[bu] 2
 Scan commands:
@@ -49,17 +49,21 @@ graphs)
 \f[C]add_action\f[]: add or modify action settings
 .RE
 .PP
-Control commands that modifies rspamd state are considered as privileged
-and basically requires a password to be specified with \f[C]\-P\f[]
-option (see \f[B]OPTIONS\f[], below, for details).
-This depends on a controller\[aq]s settings and is discussed in
-\f[C]rspamd\-workers\f[] page.
+Control commands that modify rspamd state are considered privileged and
+require a password to be specified with the \f[C]\-P\f[] option (see
+\f[B]OPTIONS\f[], below, for details).
+.PD 0
+.P
+.PD
+This depends on a controller's settings and is discussed in the
+\f[C]rspamd\-workers\f[] page (see \f[B]SEE ALSO\f[], below, for
+details).
 .PP
 \f[C]Input\ files\f[] may be either regular file(s) or a directory to
 scan.
 If no files are specified \f[C]rspamc\f[] reads from the standard input.
-Controller commands usually does not accept any input, however learn*
-and fuzzy* commands requires input.
+Controller commands usually do not accept any input, however learn* and
+fuzzy* commands requires input.
 .SH OPTIONS
 .TP
 .B \-h \f[I]host[:port]\f[], \-\-connect=\f[I]host[:port]\f[]
@@ -108,7 +112,8 @@ Emulate that message was received from specified authenticated user
 .RE
 .TP
 .B \-d \f[I]user\@domain\f[], \-\-deliver=\f[I]user\@domain\f[]
-Emulate that message is delivered to specified user (for LDA/statistics)
+Emulate that message was delivered to specified user (for
+LDA/statistics)
 .RS
 .RE
 .TP
@@ -134,8 +139,8 @@ MTA)
 .RE
 .TP
 .B \-t \f[I]seconds\f[], \-\-timeout=\f[I]seconds\f[]
-Timeout for waiting for a reply (can be floating point number, e.g.
-0.1)
+Timeout for waiting for a reply (can be floating point number,
+e.g.\ 0.1)
 .RS
 .RE
 .TP
@@ -197,7 +202,7 @@ This option can be repeated multiple times.
 .B \-\-sort=\f[I]type\f[]
 Sort output according to a specific field.
 For \f[C]counters\f[] command the allowed values for this key are
-\f[C]name\f[], \f[C]weight\f[], \f[C]frequency\f[] and \f[C]time\f[].
+\f[C]name\f[], \f[C]weight\f[], \f[C]frequency\f[] and \f[C]hits\f[].
 Appending \f[C]:desc\f[] to any of these types inverts sorting order.
 .RS
 .RE
@@ -268,7 +273,7 @@ rspamc\ uptime
 \f[]
 .fi
 .PP
-Add custom rule\[aq]s weight:
+Add custom rule's weight:
 .IP
 .nf
 \f[C]
@@ -276,7 +281,7 @@ rspamc\ add_symbol\ test\ 1.5
 \f[]
 .fi
 .PP
-Add custom action\[aq]s weight:
+Add custom action's weight:
 .IP
 .nf
 \f[C]
@@ -285,5 +290,5 @@ rspamc\ add_action\ reject\ 7.1
 .fi
 .SH SEE ALSO
 .PP
-Rspamd documentation and source codes may be downloaded from
+Rspamd documentation and source code may be downloaded from
 <https://rspamd.com/>.
index f15ca186d1615ce58e50054876c8bc6f6c78cf7b..11e2f461cf4e5c7ad14db45405aaf9a665653869 100644 (file)
@@ -114,7 +114,7 @@ requires input.
 :      Add custom HTTP header for a request. You may specify header in format `name=value` or just `name` for an empty header. This option can be repeated multiple times.
 
 \--sort=*type*
-:      Sort output according to a specific field. For `counters` command the allowed values for this key are `name`, `weight`, `frequency` and `time`. Appending `:desc` to any of these types inverts sorting order.
+:      Sort output according to a specific field. For `counters` command the allowed values for this key are `name`, `weight`, `frequency` and `hits`. Appending `:desc` to any of these types inverts sorting order.
 
 \--commands
 :      List available commands
index 58bb89a49c4977a03f099969895da271a1a68352..072aa583d8f39c62ad705ff26ba4f7963d3f33e4 100644 (file)
@@ -141,7 +141,7 @@ static GOptionEntry entries[] =
        {"exclude", 0, 0, G_OPTION_ARG_STRING_ARRAY, &exclude_patterns,
                "Exclude specific glob patterns in file names (can be repeated)", NULL},
        {"sort", 0, 0, G_OPTION_ARG_STRING, &sort,
-               "Sort output in a specific order (name, weight, time)", NULL},
+               "Sort output in a specific order (name, weight, frequency, hits)", NULL},
        { "empty", 'E', 0, G_OPTION_ARG_NONE, &empty_input,
           "Allow empty input instead of reading from stdin", NULL },
        { "fuzzy-symbol", 'S', 0, G_OPTION_ARG_STRING, &fuzzy_symbol,