services: getmail: Fix some configuration documentation strings.

* gnu/services/getmail.scm (getmail-retriever-configuration): Specify proper
documentation strings for some of the fields.
* doc/guix.texi (Mail Services): Update the documentation accordingly.
This commit is contained in:
Christopher Baines 2020-01-20 19:02:32 +00:00
parent 147a7f1fd2
commit 2e1a314871
No known key found for this signature in database
GPG key ID: 5E28A33B0B84F577
2 changed files with 14 additions and 14 deletions

View file

@ -17715,21 +17715,21 @@ Defaults to @samp{"SimpleIMAPSSLRetriever"}.
@end deftypevr
@deftypevr {@code{getmail-retriever-configuration} parameter} string server
Space separated list of arguments to the userdb driver.
Username to login to the mail server with.
Defaults to @samp{unset}.
@end deftypevr
@deftypevr {@code{getmail-retriever-configuration} parameter} string username
Space separated list of arguments to the userdb driver.
Username to login to the mail server with.
Defaults to @samp{unset}.
@end deftypevr
@deftypevr {@code{getmail-retriever-configuration} parameter} non-negative-integer port
Space separated list of arguments to the userdb driver.
Port number to connect to.
Defaults to @samp{#f}.
@ -17750,28 +17750,28 @@ Defaults to @samp{()}.
@end deftypevr
@deftypevr {@code{getmail-retriever-configuration} parameter} string keyfile
PEM-formatted key file to use for the TLS negotiation
PEM-formatted key file to use for the TLS negotiation.
Defaults to @samp{""}.
@end deftypevr
@deftypevr {@code{getmail-retriever-configuration} parameter} string certfile
PEM-formatted certificate file to use for the TLS negotiation
PEM-formatted certificate file to use for the TLS negotiation.
Defaults to @samp{""}.
@end deftypevr
@deftypevr {@code{getmail-retriever-configuration} parameter} string ca-certs
CA certificates to use
CA certificates to use.
Defaults to @samp{""}.
@end deftypevr
@deftypevr {@code{getmail-retriever-configuration} parameter} parameter-alist extra-parameters
Extra retriever parameters
Extra retriever parameters.
Defaults to @samp{()}.

View file

@ -112,13 +112,13 @@ (define-configuration getmail-retriever-configuration
@samp{passwd} and @samp{static}.")
(server
(string 'unset)
"Space separated list of arguments to the userdb driver.")
"Name or IP adddress of the server to retrieve mail from.")
(username
(string 'unset)
"Space separated list of arguments to the userdb driver.")
"Username to login to the mail server with.")
(port
(non-negative-integer #f)
"Space separated list of arguments to the userdb driver.")
"Port number to connect to.")
(password
(string "")
"Override fields from passwd.")
@ -127,16 +127,16 @@ (define-configuration getmail-retriever-configuration
"Override fields from passwd.")
(keyfile
(string "")
"PEM-formatted key file to use for the TLS negotiation")
"PEM-formatted key file to use for the TLS negotiation.")
(certfile
(string "")
"PEM-formatted certificate file to use for the TLS negotiation")
"PEM-formatted certificate file to use for the TLS negotiation.")
(ca-certs
(string "")
"CA certificates to use")
"CA certificates to use.")
(extra-parameters
(parameter-alist '())
"Extra retriever parameters"))
"Extra retriever parameters."))
(define (serialize-getmail-destination-configuration field-name val)
(serialize-configuration val getmail-destination-configuration-fields))