doc: Quote all list values.

* doc/guix.texi (System Configuration)[Services]: Replace all () by
'(), and similar quotings.
(Home Configuration)[Home Services]: Likewise.
This commit is contained in:
Florian Pelz 2023-05-30 16:22:27 +02:00
parent 5a8bb79c1c
commit 718eb55104
No known key found for this signature in database
GPG key ID: 300888CB39C63817

View file

@ -19611,7 +19611,7 @@ Available @code{mcron-configuration} fields are:
@item @code{mcron} (default: @code{mcron}) (type: file-like) @item @code{mcron} (default: @code{mcron}) (type: file-like)
The mcron package to use. The mcron package to use.
@item @code{jobs} (default: @code{()}) (type: list-of-gexps) @item @code{jobs} (default: @code{'()}) (type: list-of-gexps)
This is a list of gexps (@pxref{G-Expressions}), where each gexp This is a list of gexps (@pxref{G-Expressions}), where each gexp
corresponds to an mcron job specification (@pxref{Syntax, mcron job corresponds to an mcron job specification (@pxref{Syntax, mcron job
specifications,, mcron,GNU@tie{}mcron}). specifications,, mcron,GNU@tie{}mcron}).
@ -21030,7 +21030,7 @@ Whether to detach from the controlling terminal.
File containing the @dfn{host key}. This file must be readable by File containing the @dfn{host key}. This file must be readable by
root only. root only.
@item @code{interfaces} (default: @code{()}) (type: list) @item @code{interfaces} (default: @code{'()}) (type: list)
List of host names or addresses that @command{lshd} will listen on. List of host names or addresses that @command{lshd} will listen on.
If empty, @command{lshd} listens for connections on all the network If empty, @command{lshd} listens for connections on all the network
interfaces. interfaces.
@ -22328,7 +22328,7 @@ When unspecified, listen for any hosts/IP addresses.
@item @code{vnc-server-port} (default: @code{5900}) (type: number) @item @code{vnc-server-port} (default: @code{5900}) (type: number)
The TCP port the VNC server should listen to. The TCP port the VNC server should listen to.
@item @code{extra-config} (default: @code{()}) (type: list-of-strings) @item @code{extra-config} (default: @code{'()}) (type: list-of-strings)
Extra configuration values to append to the LightDM configuration file. Extra configuration values to append to the LightDM configuration file.
@end table @end table
@ -22377,7 +22377,7 @@ The accessibility features to enable, given as list of symbols.
@item @code{reader} (type: maybe-file-like) @item @code{reader} (type: maybe-file-like)
The command to use to launch a screen reader. The command to use to launch a screen reader.
@item @code{extra-config} (default: @code{()}) (type: list-of-strings) @item @code{extra-config} (default: @code{'()}) (type: list-of-strings)
Extra configuration values to append to the LightDM GTK Greeter Extra configuration values to append to the LightDM GTK Greeter
configuration file. configuration file.
@ -22415,7 +22415,7 @@ The Xorg server command to run.
@item @code{session-wrapper} (type: file-like) @item @code{session-wrapper} (type: file-like)
The xinitrc session wrapper to use. The xinitrc session wrapper to use.
@item @code{extra-config} (default: @code{()}) (type: list-of-strings) @item @code{extra-config} (default: @code{'()}) (type: list-of-strings)
Extra configuration values to append to the seat configuration section. Extra configuration values to append to the seat configuration section.
@end table @end table
@ -22442,11 +22442,11 @@ This is a list of font directories to add to the server's @dfn{font path}.
@item @code{drivers} (default: @code{'()}) @item @code{drivers} (default: @code{'()})
This must be either the empty list, in which case Xorg chooses a graphics This must be either the empty list, in which case Xorg chooses a graphics
driver automatically, or a list of driver names that will be tried in this driver automatically, or a list of driver names that will be tried in this
order---e.g., @code{("modesetting" "vesa")}. order---e.g., @code{'("modesetting" "vesa")}.
@item @code{resolutions} (default: @code{'()}) @item @code{resolutions} (default: @code{'()})
When @code{resolutions} is the empty list, Xorg chooses an appropriate screen When @code{resolutions} is the empty list, Xorg chooses an appropriate screen
resolution. Otherwise, it must be a list of resolutions---e.g., @code{((1024 resolution. Otherwise, it must be a list of resolutions---e.g., @code{'((1024
768) (640 480))}. 768) (640 480))}.
@cindex keyboard layout, for Xorg @cindex keyboard layout, for Xorg
@ -22974,13 +22974,13 @@ Specifies the URI path to which the access control applies.
Access controls for all access to this path, in the same format as the Access controls for all access to this path, in the same format as the
@code{access-controls} of @code{operation-access-control}. @code{access-controls} of @code{operation-access-control}.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{location-access-controls} parameter} method-access-control-list method-access-controls @deftypevr {@code{location-access-controls} parameter} method-access-control-list method-access-controls
Access controls for method-specific access to this path. Access controls for method-specific access to this path.
Defaults to @samp{()}. Defaults to @samp{'()}.
Available @code{method-access-controls} fields are: Available @code{method-access-controls} fields are:
@ -22994,14 +22994,14 @@ Defaults to @samp{#f}.
@deftypevr {@code{method-access-controls} parameter} method-list methods @deftypevr {@code{method-access-controls} parameter} method-list methods
Methods to which this access control applies. Methods to which this access control applies.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{method-access-controls} parameter} access-control-list access-controls @deftypevr {@code{method-access-controls} parameter} access-control-list access-controls
Access control directives, as a list of strings. Each string should be Access control directives, as a list of strings. Each string should be
one directive, such as @samp{"Order allow,deny"}. one directive, such as @samp{"Order allow,deny"}.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@end deftypevr @end deftypevr
@end deftypevr @end deftypevr
@ -23134,7 +23134,7 @@ Defaults to @samp{900}.
Passes the specified environment variable(s) to child processes; a list Passes the specified environment variable(s) to child processes; a list
of strings. of strings.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{cups-configuration} parameter} policy-configuration-list policies @deftypevr {@code{cups-configuration} parameter} policy-configuration-list policies
@ -23193,7 +23193,7 @@ notify-subscriber-user-name notify-user-data"}.
@deftypevr {@code{policy-configuration} parameter} operation-access-control-list access-controls @deftypevr {@code{policy-configuration} parameter} operation-access-control-list access-controls
Access control by IPP operation. Access control by IPP operation.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@end deftypevr @end deftypevr
@ -23275,7 +23275,7 @@ values are of the form @var{address}:@var{port}, where @var{address} is
either an IPv6 address enclosed in brackets, an IPv4 address, or either an IPv6 address enclosed in brackets, an IPv4 address, or
@code{*} to indicate all addresses. @code{*} to indicate all addresses.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{cups-configuration} parameter} ssl-options ssl-options @deftypevr {@code{cups-configuration} parameter} ssl-options ssl-options
@ -23289,7 +23289,7 @@ TLS v1.0. The @code{DenyCBC} option disables all CBC cipher suites. The
@code{DenyTLS1.0} option disables TLS v1.0 support - this sets the minimum @code{DenyTLS1.0} option disables TLS v1.0 support - this sets the minimum
protocol version to TLS v1.1. protocol version to TLS v1.1.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{cups-configuration} parameter} boolean strict-conformance? @deftypevr {@code{cups-configuration} parameter} boolean strict-conformance?
@ -23586,7 +23586,7 @@ Data type representing the configuration for @code{dbus-root-service-type}.
@item @code{dbus} (default: @code{dbus}) (type: file-like) @item @code{dbus} (default: @code{dbus}) (type: file-like)
Package object for dbus. Package object for dbus.
@item @code{services} (default: @code{()}) (type: list) @item @code{services} (default: @code{'()}) (type: list)
List of packages that provide an @file{etc/dbus-1/system.d} directory List of packages that provide an @file{etc/dbus-1/system.d} directory
containing additional D-Bus configuration and policy files. containing additional D-Bus configuration and policy files.
For example, to allow avahi-daemon to use the system bus, @var{services} For example, to allow avahi-daemon to use the system bus, @var{services}
@ -25078,7 +25078,7 @@ the ManageSieve service, before authentication. These may differ from the
capabilities offered to authenticated users. If this field is left empty, capabilities offered to authenticated users. If this field is left empty,
report what the Sieve interpreter supports by default. report what the Sieve interpreter supports by default.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{protocol-configuration} parameter} space-separated-string-list managesieve-sieve-capability @deftypevr {@code{protocol-configuration} parameter} space-separated-string-list managesieve-sieve-capability
@ -25087,7 +25087,7 @@ the ManageSieve service, before authentication. These may differ from the
capabilities offered to authenticated users. If this field is left empty, capabilities offered to authenticated users. If this field is left empty,
report what the Sieve interpreter supports by default. report what the Sieve interpreter supports by default.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -25121,7 +25121,7 @@ The service kind. Valid values include @code{director},
Listeners for the service. A listener is either a Listeners for the service. A listener is either a
@code{unix-listener-configuration}, a @code{fifo-listener-configuration}, or @code{unix-listener-configuration}, a @code{fifo-listener-configuration}, or
an @code{inet-listener-configuration}. an @code{inet-listener-configuration}.
Defaults to @samp{()}. Defaults to @samp{'()}.
Available @code{unix-listener-configuration} fields are: Available @code{unix-listener-configuration} fields are:
@ -25239,7 +25239,7 @@ Available @code{dict-configuration} fields are:
@deftypevr {@code{dict-configuration} parameter} free-form-fields entries @deftypevr {@code{dict-configuration} parameter} free-form-fields entries
A list of key-value pairs that this dict should hold. A list of key-value pairs that this dict should hold.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@end deftypevr @end deftypevr
@ -25283,7 +25283,7 @@ Defaults to @samp{""}.
@deftypevr {@code{userdb-configuration} parameter} free-form-args override-fields @deftypevr {@code{userdb-configuration} parameter} free-form-args override-fields
Override fields from passwd. Override fields from passwd.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@end deftypevr @end deftypevr
@ -25361,7 +25361,7 @@ Defaults to @samp{#t}.
@deftypevr {@code{namespace-configuration} parameter} mailbox-configuration-list mailboxes @deftypevr {@code{namespace-configuration} parameter} mailbox-configuration-list mailboxes
List of predefined mailboxes in this namespace. List of predefined mailboxes in this namespace.
Defaults to @samp{()}. Defaults to @samp{'()}.
Available @code{mailbox-configuration} fields are: Available @code{mailbox-configuration} fields are:
@ -25379,7 +25379,7 @@ Defaults to @samp{"no"}.
List of IMAP @code{SPECIAL-USE} attributes as specified by RFC 6154. List of IMAP @code{SPECIAL-USE} attributes as specified by RFC 6154.
Valid values are @code{\All}, @code{\Archive}, @code{\Drafts}, Valid values are @code{\All}, @code{\Archive}, @code{\Drafts},
@code{\Flagged}, @code{\Junk}, @code{\Sent}, and @code{\Trash}. @code{\Flagged}, @code{\Junk}, @code{\Sent}, and @code{\Trash}.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@end deftypevr @end deftypevr
@ -25402,12 +25402,12 @@ allowed to override their IP addresses and ports (for logging and for
authentication checks). @samp{disable-plaintext-auth} is also ignored authentication checks). @samp{disable-plaintext-auth} is also ignored
for these networks. Typically you would specify your IMAP proxy servers for these networks. Typically you would specify your IMAP proxy servers
here. here.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{dovecot-configuration} parameter} space-separated-string-list login-access-sockets @deftypevr {@code{dovecot-configuration} parameter} space-separated-string-list login-access-sockets
List of login access check sockets (e.g.@: tcpwrap). List of login access check sockets (e.g.@: tcpwrap).
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{dovecot-configuration} parameter} boolean verbose-proctitle? @deftypevr {@code{dovecot-configuration} parameter} boolean verbose-proctitle?
@ -25480,7 +25480,7 @@ List of realms for SASL authentication mechanisms that need them.
You can leave it empty if you don't want to support multiple realms. You can leave it empty if you don't want to support multiple realms.
Many clients simply use the first one listed here, so keep the default Many clients simply use the first one listed here, so keep the default
realm first. realm first.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{dovecot-configuration} parameter} string auth-default-realm @deftypevr {@code{dovecot-configuration} parameter} string auth-default-realm
@ -25596,13 +25596,13 @@ List of wanted authentication mechanisms. Supported mechanisms are:
List of IPs or hostnames to all director servers, including ourself. List of IPs or hostnames to all director servers, including ourself.
Ports can be specified as ip:port. The default port is the same as what Ports can be specified as ip:port. The default port is the same as what
director service's @samp{inet-listener} is using. director service's @samp{inet-listener} is using.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{dovecot-configuration} parameter} space-separated-string-list director-mail-servers @deftypevr {@code{dovecot-configuration} parameter} space-separated-string-list director-mail-servers
List of IPs or hostnames to all backend mail servers. Ranges are List of IPs or hostnames to all backend mail servers. Ranges are
allowed too, like 10.0.0.10-10.0.0.30. allowed too, like 10.0.0.10-10.0.0.30.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{dovecot-configuration} parameter} string director-user-expire @deftypevr {@code{dovecot-configuration} parameter} string director-user-expire
@ -25901,7 +25901,7 @@ too). This setting doesn't affect @samp{login-chroot}
which local users can modify, that may lead to root exploit. Usually which local users can modify, that may lead to root exploit. Usually
this should be done only if you don't allow shell access for users. this should be done only if you don't allow shell access for users.
<doc/wiki/Chrooting.txt>. <doc/wiki/Chrooting.txt>.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{dovecot-configuration} parameter} string mail-chroot @deftypevr {@code{dovecot-configuration} parameter} string mail-chroot
@ -25929,7 +25929,7 @@ Defaults to @samp{"/usr/lib/dovecot"}.
@deftypevr {@code{dovecot-configuration} parameter} space-separated-string-list mail-plugins @deftypevr {@code{dovecot-configuration} parameter} space-separated-string-list mail-plugins
List of plugins to load for all services. Plugins specific to IMAP, List of plugins to load for all services. Plugins specific to IMAP,
LDA, etc.@: are added to this list in their own .conf files. LDA, etc.@: are added to this list in their own .conf files.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{dovecot-configuration} parameter} non-negative-integer mail-cache-min-mail-count @deftypevr {@code{dovecot-configuration} parameter} non-negative-integer mail-cache-min-mail-count
@ -26357,7 +26357,7 @@ Show \Noselect flags for LSUB replies with LAYOUT=fs (e.g.@: mbox).
This makes Thunderbird realize they aren't selectable and show them This makes Thunderbird realize they aren't selectable and show them
greyed out, instead of only later giving "not selectable" popup error. greyed out, instead of only later giving "not selectable" popup error.
@end table @end table
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{dovecot-configuration} parameter} string imap-urlauth-host @deftypevr {@code{dovecot-configuration} parameter} string imap-urlauth-host
@ -26570,7 +26570,7 @@ Defaults to @samp{""}.
@deftypevr {@code{getmail-retriever-configuration} parameter} list password-command @deftypevr {@code{getmail-retriever-configuration} parameter} list password-command
Override fields from passwd. Override fields from passwd.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -26598,7 +26598,7 @@ Defaults to @samp{""}.
@deftypevr {@code{getmail-retriever-configuration} parameter} parameter-alist extra-parameters @deftypevr {@code{getmail-retriever-configuration} parameter} parameter-alist extra-parameters
Extra retriever parameters. Extra retriever parameters.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -26628,7 +26628,7 @@ Defaults to @samp{""}.
@deftypevr {@code{getmail-destination-configuration} parameter} parameter-alist extra-parameters @deftypevr {@code{getmail-destination-configuration} parameter} parameter-alist extra-parameters
Extra destination parameters Extra destination parameters
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -26743,7 +26743,7 @@ Defaults to @samp{#f}.
@deftypevr {@code{getmail-options-configuration} parameter} parameter-alist extra-parameters @deftypevr {@code{getmail-options-configuration} parameter} parameter-alist extra-parameters
Extra options to include. Extra options to include.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -26756,14 +26756,14 @@ A list of mailboxes that getmail should wait on the server for new mail
notifications. This depends on the server supporting the IDLE notifications. This depends on the server supporting the IDLE
extension. extension.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{getmail-configuration} parameter} list environment-variables @deftypevr {@code{getmail-configuration} parameter} list environment-variables
Environment variables to set for getmail. Environment variables to set for getmail.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -26937,7 +26937,7 @@ Defaults to @samp{"/var/lib/prosody"}.
@deftypevr {@code{prosody-configuration} parameter} file-object-list plugin-paths @deftypevr {@code{prosody-configuration} parameter} file-object-list plugin-paths
Additional plugin directories. They are searched in all the specified Additional plugin directories. They are searched in all the specified
paths in order. See @url{https://prosody.im/doc/plugins_directory}. paths in order. See @url{https://prosody.im/doc/plugins_directory}.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{prosody-configuration} parameter} file-name certificates @deftypevr {@code{prosody-configuration} parameter} file-name certificates
@ -26952,7 +26952,7 @@ This is a list of accounts that are admins for the server. Note that you
must create the accounts separately. See @url{https://prosody.im/doc/admins} and must create the accounts separately. See @url{https://prosody.im/doc/admins} and
@url{https://prosody.im/doc/creating_accounts}. @url{https://prosody.im/doc/creating_accounts}.
Example: @code{(admins '("user1@@example.com" "user2@@example.net"))} Example: @code{(admins '("user1@@example.com" "user2@@example.net"))}
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{prosody-configuration} parameter} boolean use-libevent? @deftypevr {@code{prosody-configuration} parameter} boolean use-libevent?
@ -26966,13 +26966,13 @@ This is the list of modules Prosody will load on startup. It looks for
@code{mod_modulename.lua} in the plugins folder, so make sure that exists too. @code{mod_modulename.lua} in the plugins folder, so make sure that exists too.
Documentation on modules can be found at: Documentation on modules can be found at:
@url{https://prosody.im/doc/modules}. @url{https://prosody.im/doc/modules}.
Defaults to @samp{("roster" "saslauth" "tls" "dialback" "disco" "carbons" "private" "blocklist" "vcard" "version" "uptime" "time" "ping" "pep" "register" "admin_adhoc")}. Defaults to @samp{'("roster" "saslauth" "tls" "dialback" "disco" "carbons" "private" "blocklist" "vcard" "version" "uptime" "time" "ping" "pep" "register" "admin_adhoc")}.
@end deftypevr @end deftypevr
@deftypevr {@code{prosody-configuration} parameter} string-list modules-disabled @deftypevr {@code{prosody-configuration} parameter} string-list modules-disabled
@samp{"offline"}, @samp{"c2s"} and @samp{"s2s"} are auto-loaded, but @samp{"offline"}, @samp{"c2s"} and @samp{"s2s"} are auto-loaded, but
should you want to disable them then add them to this list. should you want to disable them then add them to this list.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{prosody-configuration} parameter} file-object groups-file @deftypevr {@code{prosody-configuration} parameter} file-object groups-file
@ -27070,7 +27070,7 @@ Defaults to @samp{#f}.
@deftypevr {@code{prosody-configuration} parameter} string-list disable-sasl-mechanisms @deftypevr {@code{prosody-configuration} parameter} string-list disable-sasl-mechanisms
Set of mechanisms that will never be offered. See Set of mechanisms that will never be offered. See
@url{https://prosody.im/doc/modules/mod_saslauth}. @url{https://prosody.im/doc/modules/mod_saslauth}.
Defaults to @samp{("DIGEST-MD5")}. Defaults to @samp{'("DIGEST-MD5")}.
@end deftypevr @end deftypevr
@deftypevr {@code{prosody-configuration} parameter} boolean s2s-require-encryption? @deftypevr {@code{prosody-configuration} parameter} boolean s2s-require-encryption?
@ -27092,14 +27092,14 @@ Many servers don't support encryption or have invalid or self-signed
certificates. You can list domains here that will not be required to certificates. You can list domains here that will not be required to
authenticate using certificates. They will be authenticated using DNS@. See authenticate using certificates. They will be authenticated using DNS@. See
@url{https://prosody.im/doc/s2s#security}. @url{https://prosody.im/doc/s2s#security}.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{prosody-configuration} parameter} string-list s2s-secure-domains @deftypevr {@code{prosody-configuration} parameter} string-list s2s-secure-domains
Even if you leave @code{s2s-secure-auth?} disabled, you can still require Even if you leave @code{s2s-secure-auth?} disabled, you can still require
valid certificates for some domains by specifying a list here. See valid certificates for some domains by specifying a list here. See
@url{https://prosody.im/doc/s2s#security}. @url{https://prosody.im/doc/s2s#security}.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{prosody-configuration} parameter} string authentication @deftypevr {@code{prosody-configuration} parameter} string authentication
@ -27170,7 +27170,7 @@ internal component, you simply fill the hostname field, and the plugin you wish
to use for the component. to use for the component.
See @url{https://prosody.im/doc/components}. See @url{https://prosody.im/doc/components}.
Defaults to @samp{()}. Defaults to @samp{'()}.
Available @code{int-component-configuration} fields are: Available @code{int-component-configuration} fields are:
@ -27223,7 +27223,7 @@ Defaults to @samp{20}.
External components use XEP-0114, which most standalone components External components use XEP-0114, which most standalone components
support. To add an external component, you simply fill the hostname field. See support. To add an external component, you simply fill the hostname field. See
@url{https://prosody.im/doc/components}. @url{https://prosody.im/doc/components}.
Defaults to @samp{()}. Defaults to @samp{'()}.
Available @code{ext-component-configuration} fields are: Available @code{ext-component-configuration} fields are:
@ -27240,7 +27240,7 @@ Hostname of the component.
@deftypevr {@code{prosody-configuration} parameter} non-negative-integer-list component-ports @deftypevr {@code{prosody-configuration} parameter} non-negative-integer-list component-ports
Port(s) Prosody listens on for component connections. Port(s) Prosody listens on for component connections.
Defaults to @samp{(5347)}. Defaults to @samp{'(5347)}.
@end deftypevr @end deftypevr
@deftypevr {@code{prosody-configuration} parameter} string component-interface @deftypevr {@code{prosody-configuration} parameter} string component-interface
@ -28505,7 +28505,7 @@ The list of IP and IPv6 addresses from which @acronym{RPC} requests will
be accepted when @code{rpc-whitelist-enabled?} is @code{#t}. Wildcards be accepted when @code{rpc-whitelist-enabled?} is @code{#t}. Wildcards
may be specified using @samp{*}. may be specified using @samp{*}.
Defaults to @samp{("127.0.0.1" "::1")}. Defaults to @samp{'("127.0.0.1" "::1")}.
@end deftypevr @end deftypevr
@ -28526,7 +28526,7 @@ Defaults to @samp{#t}.
The list of host names recognized by the @acronym{RPC} server when The list of host names recognized by the @acronym{RPC} server when
@code{rpc-host-whitelist-enabled?} is @code{#t}. @code{rpc-host-whitelist-enabled?} is @code{#t}.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -29104,7 +29104,7 @@ Location of SSL client certificates.
@item @code{extra-options} (default: @code{""}) (type: extra-options) @item @code{extra-options} (default: @code{""}) (type: extra-options)
Extra options will be appended to Zabbix server configuration file. Extra options will be appended to Zabbix server configuration file.
@item @code{include-files} (default: @code{()}) (type: include-files) @item @code{include-files} (default: @code{'()}) (type: include-files)
You may include individual files or all files in a directory in the You may include individual files or all files in a directory in the
configuration file. configuration file.
@ -29169,12 +29169,12 @@ Log file name for @code{log-type} @code{file} parameter.
@item @code{pid-file} (default: @code{"/var/run/zabbix/zabbix_agent.pid"}) (type: string) @item @code{pid-file} (default: @code{"/var/run/zabbix/zabbix_agent.pid"}) (type: string)
Name of PID file. Name of PID file.
@item @code{server} (default: @code{("127.0.0.1")}) (type: list) @item @code{server} (default: @code{'("127.0.0.1")}) (type: list)
List of IP addresses, optionally in CIDR notation, or hostnames of List of IP addresses, optionally in CIDR notation, or hostnames of
Zabbix servers and Zabbix proxies. Incoming connections will be Zabbix servers and Zabbix proxies. Incoming connections will be
accepted only from the hosts listed here. accepted only from the hosts listed here.
@item @code{server-active} (default: @code{("127.0.0.1")}) (type: list) @item @code{server-active} (default: @code{'("127.0.0.1")}) (type: list)
List of IP:port (or hostname:port) pairs of Zabbix servers and Zabbix List of IP:port (or hostname:port) pairs of Zabbix servers and Zabbix
proxies for active checks. If port is not specified, default port is proxies for active checks. If port is not specified, default port is
used. If this parameter is not specified, active checks are disabled. used. If this parameter is not specified, active checks are disabled.
@ -29182,7 +29182,7 @@ used. If this parameter is not specified, active checks are disabled.
@item @code{extra-options} (default: @code{""}) (type: extra-options) @item @code{extra-options} (default: @code{""}) (type: extra-options)
Extra options will be appended to Zabbix server configuration file. Extra options will be appended to Zabbix server configuration file.
@item @code{include-files} (default: @code{()}) (type: include-files) @item @code{include-files} (default: @code{'()}) (type: include-files)
You may include individual files or all files in a directory in the You may include individual files or all files in a directory in the
configuration file. configuration file.
@ -29216,7 +29216,7 @@ Available @code{zabbix-front-end-configuration} fields are:
@item @code{zabbix-server} (default: @code{zabbix-server}) (type: file-like) @item @code{zabbix-server} (default: @code{zabbix-server}) (type: file-like)
The Zabbix server package to use. The Zabbix server package to use.
@item @code{nginx} (default: @code{()}) (type: list) @item @code{nginx} (default: @code{'()}) (type: list)
List of @ref{nginx-server-configuration,@code{nginx-server-configuration}} List of @ref{nginx-server-configuration,@code{nginx-server-configuration}}
blocks for the Zabbix front-end. When empty, a default that listens on blocks for the Zabbix front-end. When empty, a default that listens on
port 80 is used. port 80 is used.
@ -29462,7 +29462,7 @@ one of the following symbols: @samp{crit}, @samp{error}, @samp{warning},
@samp{notice}, @samp{info} or @samp{debug}. All messages with the @samp{notice}, @samp{info} or @samp{debug}. All messages with the
specified log level or higher are logged. specified log level or higher are logged.
Defaults to @samp{("/var/log/nslcd" info)}. Defaults to @samp{'("/var/log/nslcd" info)}.
@end deftypevr @end deftypevr
@ -29470,7 +29470,7 @@ Defaults to @samp{("/var/log/nslcd" info)}.
The list of LDAP server URIs. Normally, only the first server will be The list of LDAP server URIs. Normally, only the first server will be
used with the following servers as fall-back. used with the following servers as fall-back.
Defaults to @samp{("ldap://localhost:389/")}. Defaults to @samp{'("ldap://localhost:389/")}.
@end deftypevr @end deftypevr
@ -29575,7 +29575,7 @@ Specifies the search scope (subtree, onelevel, base or children). The
default scope is subtree; base scope is almost never useful for name default scope is subtree; base scope is almost never useful for name
service lookups; children scope is not supported on all servers. service lookups; children scope is not supported on all servers.
Defaults to @samp{(subtree)}. Defaults to @samp{'(subtree)}.
@end deftypevr @end deftypevr
@ -29601,7 +29601,7 @@ default RFC 2307 attributes. It is a list of maps, each consisting of
the name of a map, the RFC 2307 attribute to match and the query the name of a map, the RFC 2307 attribute to match and the query
expression for the attribute as it is available in the directory. expression for the attribute as it is available in the directory.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -29609,7 +29609,7 @@ Defaults to @samp{()}.
A list of filters consisting of the name of a map to which the filter A list of filters consisting of the name of a map to which the filter
applies and an LDAP search filter expression. applies and an LDAP search filter expression.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -29854,7 +29854,7 @@ Defaults to @samp{disabled}.
@deftypevr {@code{nslcd-configuration} parameter} list pam-services @deftypevr {@code{nslcd-configuration} parameter} list pam-services
List of pam service names for which LDAP authentication should suffice. List of pam service names for which LDAP authentication should suffice.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -31350,7 +31350,7 @@ The certbot package to use.
The directory from which to serve the Let's Encrypt challenge/response The directory from which to serve the Let's Encrypt challenge/response
files. files.
@item @code{certificates} (default: @code{()}) @item @code{certificates} (default: @code{'()})
A list of @code{certificates-configuration}s for which to generate A list of @code{certificates-configuration}s for which to generate
certificates and request signatures. Each certificate has a @code{name} certificates and request signatures. Each certificate has a @code{name}
and several @code{domains}. and several @code{domains}.
@ -31401,7 +31401,7 @@ certificate names, run @code{certbot certificates}.
Its default is the first provided domain. Its default is the first provided domain.
@item @code{domains} (default: @code{()}) @item @code{domains} (default: @code{'()})
The first domain provided will be the subject CN of the certificate, and The first domain provided will be the subject CN of the certificate, and
all domains will be Subject Alternative Names on the certificate. all domains will be Subject Alternative Names on the certificate.
@ -32203,7 +32203,7 @@ Defaults to @samp{"/etc/ddclient/secrets.conf"}.
@deftypevr {@code{ddclient-configuration} parameter} list extra-options @deftypevr {@code{ddclient-configuration} parameter} list extra-options
Extra options will be appended to @file{ddclient.conf} file. Extra options will be appended to @file{ddclient.conf} file.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -32339,7 +32339,7 @@ Use an Inetd-style service, which runs the Xvnc server on demand.
@item @code{frame-rate} (default: @code{60}) (type: number) @item @code{frame-rate} (default: @code{60}) (type: number)
The maximum number of updates per second sent to each client. The maximum number of updates per second sent to each client.
@item @code{security-types} (default: @code{("None")}) (type: security-types) @item @code{security-types} (default: @code{'("None")}) (type: security-types)
The allowed security schemes to use for incoming connections. The The allowed security schemes to use for incoming connections. The
default is "None", which is safe given that Xvnc is configured to default is "None", which is safe given that Xvnc is configured to
authenticate the user via the display manager, and only for local authenticate the user via the display manager, and only for local
@ -32355,7 +32355,7 @@ used to expose the remote port.
The log level, a number between 0 and 100, 100 meaning most verbose The log level, a number between 0 and 100, 100 meaning most verbose
output. The log messages are output to syslog. output. The log messages are output to syslog.
@item @code{extra-options} (default: @code{()}) (type: strings) @item @code{extra-options} (default: @code{'()}) (type: strings)
This can be used to provide extra Xvnc options not exposed via this This can be used to provide extra Xvnc options not exposed via this
<xvnc-configuration> record. <xvnc-configuration> record.
@ -32467,7 +32467,7 @@ Bind to a specific local port number.
@item @code{resolv-retry?} (default: @code{#t}) (type: resolv-retry) @item @code{resolv-retry?} (default: @code{#t}) (type: resolv-retry)
Retry resolving server address. Retry resolving server address.
@item @code{remote} (default: @code{()}) (type: openvpn-remote-list) @item @code{remote} (default: @code{'()}) (type: openvpn-remote-list)
A list of remote servers to connect to. A list of remote servers to connect to.
@deftp {Data Type} openvpn-remote-configuration @deftp {Data Type} openvpn-remote-configuration
@ -32576,7 +32576,7 @@ The maximum number of clients.
The status file. This file shows a small report on current connection. The status file. This file shows a small report on current connection.
It is truncated and rewritten every minute. It is truncated and rewritten every minute.
@item @code{client-config-dir} (default: @code{()}) (type: openvpn-ccd-list) @item @code{client-config-dir} (default: @code{'()}) (type: openvpn-ccd-list)
The list of configuration for some clients. The list of configuration for some clients.
@end table @end table
@ -33964,11 +33964,11 @@ who is a part of the group @var{group} (see below).
The group to run mpd as. The group to run mpd as.
The default @code{%mpd-group} is a system group with name ``mpd''. The default @code{%mpd-group} is a system group with name ``mpd''.
@item @code{shepherd-requirement} (default: @code{()}) (type: list-of-symbol) @item @code{shepherd-requirement} (default: @code{'()}) (type: list-of-symbol)
A list of symbols naming Shepherd services that this service A list of symbols naming Shepherd services that this service
will depend on. will depend on.
@item @code{environment-variables} (default: @code{("PULSE_CLIENTCONFIG=/etc/pulse/client.conf" "PULSE_CONFIG=/etc/pulse/daemon.conf")}) (type: list-of-strings) @item @code{environment-variables} (default: @code{'("PULSE_CLIENTCONFIG=/etc/pulse/client.conf" "PULSE_CONFIG=/etc/pulse/daemon.conf")}) (type: list-of-strings)
A list of strings specifying environment variables. A list of strings specifying environment variables.
@item @code{log-file} (default: @code{"/var/log/mpd/log"}) (type: maybe-string) @item @code{log-file} (default: @code{"/var/log/mpd/log"}) (type: maybe-string)
@ -34009,38 +34009,38 @@ can be specified here.
@item @code{database} (type: maybe-mpd-plugin) @item @code{database} (type: maybe-mpd-plugin)
MPD database plugin configuration. MPD database plugin configuration.
@item @code{partitions} (default: @code{()}) (type: list-of-mpd-partition) @item @code{partitions} (default: @code{'()}) (type: list-of-mpd-partition)
List of MPD "partitions". List of MPD "partitions".
@item @code{neighbors} (default: @code{()}) (type: list-of-mpd-plugin) @item @code{neighbors} (default: @code{'()}) (type: list-of-mpd-plugin)
List of MPD neighbor plugin configurations. List of MPD neighbor plugin configurations.
@item @code{inputs} (default: @code{()}) (type: list-of-mpd-plugin) @item @code{inputs} (default: @code{'()}) (type: list-of-mpd-plugin)
List of MPD input plugin configurations. List of MPD input plugin configurations.
@item @code{archive-plugins} (default: @code{()}) (type: list-of-mpd-plugin) @item @code{archive-plugins} (default: @code{'()}) (type: list-of-mpd-plugin)
List of MPD archive plugin configurations. List of MPD archive plugin configurations.
@item @code{input-cache-size} (type: maybe-string) @item @code{input-cache-size} (type: maybe-string)
MPD input cache size. MPD input cache size.
@item @code{decoders} (default: @code{()}) (type: list-of-mpd-plugin) @item @code{decoders} (default: @code{'()}) (type: list-of-mpd-plugin)
List of MPD decoder plugin configurations. List of MPD decoder plugin configurations.
@item @code{resampler} (type: maybe-mpd-plugin) @item @code{resampler} (type: maybe-mpd-plugin)
MPD resampler plugin configuration. MPD resampler plugin configuration.
@item @code{filters} (default: @code{()}) (type: list-of-mpd-plugin) @item @code{filters} (default: @code{'()}) (type: list-of-mpd-plugin)
List of MPD filter plugin configurations. List of MPD filter plugin configurations.
@item @code{outputs} (type: list-of-mpd-plugin-or-output) @item @code{outputs} (type: list-of-mpd-plugin-or-output)
The audio outputs that MPD can use. By default this is a single output The audio outputs that MPD can use. By default this is a single output
using pulseaudio. using pulseaudio.
@item @code{playlist-plugins} (default: @code{()}) (type: list-of-mpd-plugin) @item @code{playlist-plugins} (default: @code{'()}) (type: list-of-mpd-plugin)
List of MPD playlist plugin configurations. List of MPD playlist plugin configurations.
@item @code{extra-options} (default: @code{()}) (type: alist) @item @code{extra-options} (default: @code{'()}) (type: alist)
An association list of option symbols/strings to string values to be An association list of option symbols/strings to string values to be
appended to the configuration. appended to the configuration.
@ -34060,7 +34060,7 @@ Name.
@item @code{enabled?} (type: maybe-boolean) @item @code{enabled?} (type: maybe-boolean)
Whether the plugin is enabled/disabled. Whether the plugin is enabled/disabled.
@item @code{extra-options} (default: @code{()}) (type: alist) @item @code{extra-options} (default: @code{'()}) (type: alist)
An association list of option symbols/strings to string values to be An association list of option symbols/strings to string values to be
appended to the plugin configuration. See appended to the plugin configuration. See
@uref{https://mpd.readthedocs.io/en/latest/plugins.html,MPD plugin @uref{https://mpd.readthedocs.io/en/latest/plugins.html,MPD plugin
@ -34076,7 +34076,7 @@ Data type representing a @command{mpd} partition.
@item @code{name} (type: string) @item @code{name} (type: string)
Partition name. Partition name.
@item @code{extra-options} (default: @code{()}) (type: alist) @item @code{extra-options} (default: @code{'()}) (type: alist)
An association list of option symbols/strings to string values to be An association list of option symbols/strings to string values to be
appended to the partition configuration. See appended to the partition configuration. See
@uref{https://mpd.readthedocs.io/en/latest/user.html#configuring-partitions,Configuring @uref{https://mpd.readthedocs.io/en/latest/user.html#configuring-partitions,Configuring
@ -34130,7 +34130,7 @@ Gain} is to be applied. @code{software} uses an internal software
volume control, @code{mixer} uses the configured (hardware) mixer volume control, @code{mixer} uses the configured (hardware) mixer
control and @code{none} disables replay gain on this audio output. control and @code{none} disables replay gain on this audio output.
@item @code{extra-options} (default: @code{()}) (type: alist) @item @code{extra-options} (default: @code{'()}) (type: alist)
An association list of option symbols/strings to string values to be An association list of option symbols/strings to string values to be
appended to the audio output configuration. appended to the audio output configuration.
@ -34195,7 +34195,7 @@ Available @code{mympd-configuration} fields are:
@item @code{package} (default: @code{mympd}) (type: file-like) @item @code{package} (default: @code{mympd}) (type: file-like)
The package object of the myMPD server. The package object of the myMPD server.
@item @code{shepherd-requirement} (default: @code{()}) (type: list-of-symbol) @item @code{shepherd-requirement} (default: @code{'()}) (type: list-of-symbol)
This is a list of symbols naming Shepherd services that this service This is a list of symbols naming Shepherd services that this service
will depend on. will depend on.
@ -34278,10 +34278,10 @@ Whether to preserve caches between service restarts.
Available @code{mympd-ip-acl} fields are: Available @code{mympd-ip-acl} fields are:
@table @asis @table @asis
@item @code{allow} (default: @code{()}) (type: list-of-strings) @item @code{allow} (default: @code{'()}) (type: list-of-strings)
Allowed IP addresses. Allowed IP addresses.
@item @code{deny} (default: @code{()}) (type: list-of-strings) @item @code{deny} (default: @code{'()}) (type: list-of-strings)
Disallowed IP addresses. Disallowed IP addresses.
@end table @end table
@ -34471,7 +34471,7 @@ API access control scheme.
By default an authenticated user is allowed access to all APIs. Access By default an authenticated user is allowed access to all APIs. Access
drivers can place restrictions on this. drivers can place restrictions on this.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -34531,7 +34531,7 @@ Defaults to @samp{#f}.
@deftypevr {@code{libvirt-configuration} parameter} optional-list tls-allowed-dn-list @deftypevr {@code{libvirt-configuration} parameter} optional-list tls-allowed-dn-list
Whitelist of allowed x509 Distinguished Name. Whitelist of allowed x509 Distinguished Name.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -34539,7 +34539,7 @@ Defaults to @samp{()}.
Whitelist of allowed SASL usernames. The format for username depends on Whitelist of allowed SASL usernames. The format for username depends on
the SASL authentication mechanism. the SASL authentication mechanism.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -36270,14 +36270,14 @@ Defaults to @samp{#t}.
List of common prefixes which, when combined with a repository URL, List of common prefixes which, when combined with a repository URL,
generates valid clone URLs for the repository. generates valid clone URLs for the repository.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@deftypevr {@code{cgit-configuration} parameter} list clone-url @deftypevr {@code{cgit-configuration} parameter} list clone-url
List of @code{clone-url} templates. List of @code{clone-url} templates.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -36570,7 +36570,7 @@ Defaults to @samp{""}.
@deftypevr {@code{cgit-configuration} parameter} mimetype-alist mimetype @deftypevr {@code{cgit-configuration} parameter} mimetype-alist mimetype
Mimetype for the specified filename extension. Mimetype for the specified filename extension.
Defaults to @samp{((gif "image/gif") (html "text/html") (jpg Defaults to @samp{'((gif "image/gif") (html "text/html") (jpg
"image/jpeg") (jpeg "image/jpeg") (pdf "application/pdf") (png "image/jpeg") (jpeg "image/jpeg") (pdf "application/pdf") (png
"image/png") (svg "image/svg+xml"))}. "image/png") (svg "image/svg+xml"))}.
@ -36619,7 +36619,7 @@ A list of subdirectories inside of @code{repository-directory}, relative
to it, that should loaded as Git repositories. An empty list means that to it, that should loaded as Git repositories. An empty list means that
all subdirectories will be loaded. all subdirectories will be loaded.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -36656,7 +36656,7 @@ Defaults to @samp{""}.
@deftypevr {@code{cgit-configuration} parameter} robots-list robots @deftypevr {@code{cgit-configuration} parameter} robots-list robots
Text used as content for the @code{robots} meta-tag. Text used as content for the @code{robots} meta-tag.
Defaults to @samp{("noindex" "nofollow")}. Defaults to @samp{'("noindex" "nofollow")}.
@end deftypevr @end deftypevr
@ -36697,7 +36697,7 @@ Defaults to @samp{#f}.
Text which specifies the default set of snapshot formats that cgit Text which specifies the default set of snapshot formats that cgit
generates links for. generates links for.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -36791,7 +36791,7 @@ Defaults to @samp{"/"}.
@deftypevr {@code{cgit-configuration} parameter} repository-cgit-configuration-list repositories @deftypevr {@code{cgit-configuration} parameter} repository-cgit-configuration-list repositories
A list of @dfn{cgit-repo} records to use with config. A list of @dfn{cgit-repo} records to use with config.
Defaults to @samp{()}. Defaults to @samp{'()}.
Available @code{repository-cgit-configuration} fields are: Available @code{repository-cgit-configuration} fields are:
@ -36799,7 +36799,7 @@ Available @code{repository-cgit-configuration} fields are:
A mask of snapshot formats for this repo that cgit generates links for, A mask of snapshot formats for this repo that cgit generates links for,
restricted by the global @code{snapshots} setting. restricted by the global @code{snapshots} setting.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -36835,7 +36835,7 @@ Defaults to @samp{""}.
@deftypevr {@code{repository-cgit-configuration} parameter} repo-list clone-url @deftypevr {@code{repository-cgit-configuration} parameter} repo-list clone-url
A list of URLs which can be used to clone repo. A list of URLs which can be used to clone repo.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -36985,7 +36985,7 @@ Text which will be used as the formatstring for a hyperlink when a
submodule with the specified subdirectory path is printed in a directory submodule with the specified subdirectory path is printed in a directory
listing. listing.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -37036,7 +37036,7 @@ Defaults to @samp{""}.
@deftypevr {@code{repository-cgit-configuration} parameter} repo-list extra-options @deftypevr {@code{repository-cgit-configuration} parameter} repo-list extra-options
Extra options will be appended to cgitrc file. Extra options will be appended to cgitrc file.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -37045,7 +37045,7 @@ Defaults to @samp{()}.
@deftypevr {@code{cgit-configuration} parameter} list extra-options @deftypevr {@code{cgit-configuration} parameter} list extra-options
Extra options will be appended to cgitrc file. Extra options will be appended to cgitrc file.
Defaults to @samp{()}. Defaults to @samp{'()}.
@end deftypevr @end deftypevr
@ -38006,7 +38006,7 @@ list or a string. For additional information, see @ref{Guile
Syntax,,Job specification,mcron,the mcron manual}. By default this is Syntax,,Job specification,mcron,the mcron manual}. By default this is
set to run weekly on Sunday at 00:00. set to run weekly on Sunday at 00:00.
@item @code{listed-in} (default: @code{("/etc/fstab" "/proc/self/mountinfo")}) (type: maybe-list-of-strings) @item @code{listed-in} (default: @code{'("/etc/fstab" "/proc/self/mountinfo")}) (type: maybe-list-of-strings)
List of files in fstab or kernel mountinfo format. All missing or empty List of files in fstab or kernel mountinfo format. All missing or empty
files are silently ignored. The evaluation of the list @emph{stops} files are silently ignored. The evaluation of the list @emph{stops}
after the first non-empty file. File systems with after the first non-empty file. File systems with
@ -38551,7 +38551,7 @@ Enable or disable debug output.
@item @code{enable-iptables?} (default @code{#t}) @item @code{enable-iptables?} (default @code{#t})
Enable or disable the addition of iptables rules. Enable or disable the addition of iptables rules.
@item @code{environment-variables} (default: @code{()}) @item @code{environment-variables} (default: @code{'()})
List of environment variables to set for @command{dockerd}. List of environment variables to set for @command{dockerd}.
This must be a list of strings where each string has the form This must be a list of strings where each string has the form
@ -38845,14 +38845,14 @@ base default configuration that is to be extended with
@item @code{run-directory} (default: @code{"/var/run/fail2ban"}) (type: string) @item @code{run-directory} (default: @code{"/var/run/fail2ban"}) (type: string)
The state directory for the @code{fail2ban} daemon. The state directory for the @code{fail2ban} daemon.
@item @code{jails} (default: @code{()}) (type: list-of-fail2ban-jail-configurations) @item @code{jails} (default: @code{'()}) (type: list-of-fail2ban-jail-configurations)
Instances of @code{<fail2ban-jail-configuration>} collected from Instances of @code{<fail2ban-jail-configuration>} collected from
extensions. extensions.
@item @code{extra-jails} (default: @code{()}) (type: list-of-fail2ban-jail-configurations) @item @code{extra-jails} (default: @code{'()}) (type: list-of-fail2ban-jail-configurations)
Instances of @code{<fail2ban-jail-configuration>} explicitly provided. Instances of @code{<fail2ban-jail-configuration>} explicitly provided.
@item @code{extra-content} (default: @code{()}) (type: text-config) @item @code{extra-content} (default: @code{'()}) (type: text-config)
Extra raw content to add to the end of the @file{jail.local} file, Extra raw content to add to the end of the @file{jail.local} file,
provided as a list of file-like objects. provided as a list of file-like objects.
@ -38884,7 +38884,7 @@ Available @code{fail2ban-jail-action-configuration} fields are:
@item @code{name} (type: string) @item @code{name} (type: string)
Action name. Action name.
@item @code{arguments} (default: @code{()}) (type: list-of-arguments) @item @code{arguments} (default: @code{'()}) (type: list-of-arguments)
Action arguments. Action arguments.
@end table @end table
@ -38955,7 +38955,7 @@ the ban IP address is considered.
@item @code{ignore-self?} (type: maybe-boolean) @item @code{ignore-self?} (type: maybe-boolean)
Never ban the local machine's own IP address. Never ban the local machine's own IP address.
@item @code{ignore-ip} (default: @code{()}) (type: list-of-strings) @item @code{ignore-ip} (default: @code{'()}) (type: list-of-strings)
A list of IP addresses, CIDR masks or DNS hosts to ignore. A list of IP addresses, CIDR masks or DNS hosts to ignore.
@code{fail2ban} will not ban a host which matches an address in this @code{fail2ban} will not ban a host which matches an address in this
list. list.
@ -38975,13 +38975,13 @@ The default time zone for log lines that do not have one.
The encoding of the log files handled by the jail. Possible values are: The encoding of the log files handled by the jail. Possible values are:
@code{'ascii}, @code{'utf-8} and @code{'auto}. @code{'ascii}, @code{'utf-8} and @code{'auto}.
@item @code{log-path} (default: @code{()}) (type: list-of-strings) @item @code{log-path} (default: @code{'()}) (type: list-of-strings)
The file names of the log files to be monitored. The file names of the log files to be monitored.
@item @code{action} (default: @code{()}) (type: list-of-fail2ban-jail-actions) @item @code{action} (default: @code{'()}) (type: list-of-fail2ban-jail-actions)
A list of @code{<fail2ban-jail-action-configuration>}. A list of @code{<fail2ban-jail-action-configuration>}.
@item @code{extra-content} (default: @code{()}) (type: text-config) @item @code{extra-content} (default: @code{'()}) (type: text-config)
Extra content for the jail configuration, provided as a list of file-like Extra content for the jail configuration, provided as a list of file-like
objects. objects.
@ -39653,7 +39653,7 @@ points of the EFI file system, usually @file{/boot/efi}. For
points corresponding to TFTP root directories served by your TFTP points corresponding to TFTP root directories served by your TFTP
server. server.
@item @code{menu-entries} (default: @code{()}) @item @code{menu-entries} (default: @code{'()})
A possibly empty list of @code{menu-entry} objects (see below), denoting A possibly empty list of @code{menu-entry} objects (see below), denoting
entries to appear in the bootloader menu, in addition to the current entries to appear in the bootloader menu, in addition to the current
system entry and the entry pointing to previous system generations. system entry and the entry pointing to previous system generations.
@ -39767,9 +39767,9 @@ convention,,, grub, GNU GRUB manual}), for example:
If the device is specified explicitly as above, then the @code{device} If the device is specified explicitly as above, then the @code{device}
field is ignored entirely. field is ignored entirely.
@item @code{linux-arguments} (default: @code{()}) @item @code{linux-arguments} (default: @code{'()})
The list of extra Linux kernel command-line arguments---e.g., The list of extra Linux kernel command-line arguments---e.g.,
@code{("console=ttyS0")}. @code{'("console=ttyS0")}.
@item @code{initrd} (default: @code{#f}) @item @code{initrd} (default: @code{#f})
A G-Expression or string denoting the file name of the initial RAM disk A G-Expression or string denoting the file name of the initial RAM disk
@ -39794,10 +39794,10 @@ For example:
(file-append mach "/boot/gnumach") (file-append mach "/boot/gnumach")
@end lisp @end lisp
@item @code{multiboot-arguments} (default: @code{()}) @item @code{multiboot-arguments} (default: @code{'()})
The list of extra command-line arguments for the multiboot-kernel. The list of extra command-line arguments for the multiboot-kernel.
@item @code{multiboot-modules} (default: @code{()}) @item @code{multiboot-modules} (default: @code{'()})
The list of commands for loading Multiboot modules. For example: The list of commands for loading Multiboot modules. For example:
@lisp @lisp
@ -42536,7 +42536,7 @@ that @file{~/.profile} is sourced by @file{~/.bash_profile} and
Available @code{home-shell-profile-configuration} fields are: Available @code{home-shell-profile-configuration} fields are:
@table @asis @table @asis
@item @code{profile} (default: @code{()}) (type: text-config) @item @code{profile} (default: @code{'()}) (type: text-config)
@code{home-shell-profile} is instantiated automatically by @code{home-shell-profile} is instantiated automatically by
@code{home-environment}, DO NOT create this service manually, it can @code{home-environment}, DO NOT create this service manually, it can
only be extended. @code{profile} is a list of file-like objects, which only be extended. @code{profile} is a list of file-like objects, which
@ -42565,13 +42565,13 @@ The Bash package to use.
Add sane defaults like reading @file{/etc/bashrc} and coloring the output of Add sane defaults like reading @file{/etc/bashrc} and coloring the output of
@command{ls} to the top of the @file{.bashrc} file. @command{ls} to the top of the @file{.bashrc} file.
@item @code{environment-variables} (default: @code{()}) (type: alist) @item @code{environment-variables} (default: @code{'()}) (type: alist)
Association list of environment variables to set for the Bash session. The Association list of environment variables to set for the Bash session. The
rules for the @code{home-environment-variables-service-type} apply rules for the @code{home-environment-variables-service-type} apply
here (@pxref{Essential Home Services}). The contents of this field will be here (@pxref{Essential Home Services}). The contents of this field will be
added after the contents of the @code{bash-profile} field. added after the contents of the @code{bash-profile} field.
@item @code{aliases} (default: @code{()}) (type: alist) @item @code{aliases} (default: @code{'()}) (type: alist)
Association list of aliases to set for the Bash session. The aliases Association list of aliases to set for the Bash session. The aliases
will be defined after the contents of the @code{bashrc} field has been will be defined after the contents of the @code{bashrc} field has been
put in the @file{.bashrc} file. The alias will automatically be quoted, put in the @file{.bashrc} file. The alias will automatically be quoted,
@ -42587,19 +42587,19 @@ turns into
alias ls="ls -alF" alias ls="ls -alF"
@end example @end example
@item @code{bash-profile} (default: @code{()}) (type: text-config) @item @code{bash-profile} (default: @code{'()}) (type: text-config)
List of file-like objects, which will be added to @file{.bash_profile}. List of file-like objects, which will be added to @file{.bash_profile}.
Used for executing user's commands at start of login shell (In most Used for executing user's commands at start of login shell (In most
cases the shell started on tty just after login). @file{.bash_login} cases the shell started on tty just after login). @file{.bash_login}
won't be ever read, because @file{.bash_profile} always present. won't be ever read, because @file{.bash_profile} always present.
@item @code{bashrc} (default: @code{()}) (type: text-config) @item @code{bashrc} (default: @code{'()}) (type: text-config)
List of file-like objects, which will be added to @file{.bashrc}. Used List of file-like objects, which will be added to @file{.bashrc}. Used
for executing user's commands at start of interactive shell (The shell for executing user's commands at start of interactive shell (The shell
for interactive usage started by typing @code{bash} or by terminal app for interactive usage started by typing @code{bash} or by terminal app
or any other program). or any other program).
@item @code{bash-logout} (default: @code{()}) (type: text-config) @item @code{bash-logout} (default: @code{'()}) (type: text-config)
List of file-like objects, which will be added to @file{.bash_logout}. List of file-like objects, which will be added to @file{.bash_logout}.
Used for executing user's commands at the exit of login shell. It won't Used for executing user's commands at the exit of login shell. It won't
be read in some cases (if the shell terminates by exec'ing another be read in some cases (if the shell terminates by exec'ing another
@ -42636,24 +42636,24 @@ You would then add @code{bash-fancy-prompt-service} to the list in the
Available @code{home-bash-extension} fields are: Available @code{home-bash-extension} fields are:
@table @asis @table @asis
@item @code{environment-variables} (default: @code{()}) (type: alist) @item @code{environment-variables} (default: @code{'()}) (type: alist)
Additional environment variables to set. These will be combined with the Additional environment variables to set. These will be combined with the
environment variables from other extensions and the base service to form one environment variables from other extensions and the base service to form one
coherent block of environment variables. coherent block of environment variables.
@item @code{aliases} (default: @code{()}) (type: alist) @item @code{aliases} (default: @code{'()}) (type: alist)
Additional aliases to set. These will be combined with the aliases from Additional aliases to set. These will be combined with the aliases from
other extensions and the base service. other extensions and the base service.
@item @code{bash-profile} (default: @code{()}) (type: text-config) @item @code{bash-profile} (default: @code{'()}) (type: text-config)
Additional text blocks to add to @file{.bash_profile}, which will be combined Additional text blocks to add to @file{.bash_profile}, which will be combined
with text blocks from other extensions and the base service. with text blocks from other extensions and the base service.
@item @code{bashrc} (default: @code{()}) (type: text-config) @item @code{bashrc} (default: @code{'()}) (type: text-config)
Additional text blocks to add to @file{.bashrc}, which will be combined Additional text blocks to add to @file{.bashrc}, which will be combined
with text blocks from other extensions and the base service. with text blocks from other extensions and the base service.
@item @code{bash-logout} (default: @code{()}) (type: text-config) @item @code{bash-logout} (default: @code{'()}) (type: text-config)
Additional text blocks to add to @file{.bash_logout}, which will be combined Additional text blocks to add to @file{.bash_logout}, which will be combined
with text blocks from other extensions and the base service. with text blocks from other extensions and the base service.
@ -42675,33 +42675,33 @@ Place all the configs to @file{$XDG_CONFIG_HOME/zsh}. Makes
Shell startup process will continue with Shell startup process will continue with
@file{$XDG_CONFIG_HOME/zsh/.zshenv}. @file{$XDG_CONFIG_HOME/zsh/.zshenv}.
@item @code{environment-variables} (default: @code{()}) (type: alist) @item @code{environment-variables} (default: @code{'()}) (type: alist)
Association list of environment variables to set for the Zsh session. Association list of environment variables to set for the Zsh session.
@item @code{zshenv} (default: @code{()}) (type: text-config) @item @code{zshenv} (default: @code{'()}) (type: text-config)
List of file-like objects, which will be added to @file{.zshenv}. Used List of file-like objects, which will be added to @file{.zshenv}. Used
for setting user's shell environment variables. Must not contain for setting user's shell environment variables. Must not contain
commands assuming the presence of tty or producing output. Will be read commands assuming the presence of tty or producing output. Will be read
always. Will be read before any other file in @env{ZDOTDIR}. always. Will be read before any other file in @env{ZDOTDIR}.
@item @code{zprofile} (default: @code{()}) (type: text-config) @item @code{zprofile} (default: @code{'()}) (type: text-config)
List of file-like objects, which will be added to @file{.zprofile}. Used List of file-like objects, which will be added to @file{.zprofile}. Used
for executing user's commands at start of login shell (In most cases the for executing user's commands at start of login shell (In most cases the
shell started on tty just after login). Will be read before shell started on tty just after login). Will be read before
@file{.zlogin}. @file{.zlogin}.
@item @code{zshrc} (default: @code{()}) (type: text-config) @item @code{zshrc} (default: @code{'()}) (type: text-config)
List of file-like objects, which will be added to @file{.zshrc}. Used List of file-like objects, which will be added to @file{.zshrc}. Used
for executing user's commands at start of interactive shell (The shell for executing user's commands at start of interactive shell (The shell
for interactive usage started by typing @code{zsh} or by terminal app or for interactive usage started by typing @code{zsh} or by terminal app or
any other program). any other program).
@item @code{zlogin} (default: @code{()}) (type: text-config) @item @code{zlogin} (default: @code{'()}) (type: text-config)
List of file-like objects, which will be added to @file{.zlogin}. Used List of file-like objects, which will be added to @file{.zlogin}. Used
for executing user's commands at the end of starting process of login for executing user's commands at the end of starting process of login
shell. shell.
@item @code{zlogout} (default: @code{()}) (type: text-config) @item @code{zlogout} (default: @code{'()}) (type: text-config)
List of file-like objects, which will be added to @file{.zlogout}. Used List of file-like objects, which will be added to @file{.zlogout}. Used
for executing user's commands at the exit of login shell. It won't be for executing user's commands at the exit of login shell. It won't be
read in some cases (if the shell terminates by exec'ing another process read in some cases (if the shell terminates by exec'ing another process
@ -42747,7 +42747,7 @@ Available @code{home-mcron-configuration} fields are:
@item @code{mcron} (default: @code{mcron}) (type: file-like) @item @code{mcron} (default: @code{mcron}) (type: file-like)
The mcron package to use. The mcron package to use.
@item @code{jobs} (default: @code{()}) (type: list-of-gexps) @item @code{jobs} (default: @code{'()}) (type: list-of-gexps)
This is a list of gexps (@pxref{G-Expressions}), where each gexp This is a list of gexps (@pxref{G-Expressions}), where each gexp
corresponds to an mcron job specification (@pxref{Syntax, mcron job corresponds to an mcron job specification (@pxref{Syntax, mcron job
specifications,, mcron,GNU@tie{}mcron}). specifications,, mcron,GNU@tie{}mcron}).
@ -43571,7 +43571,7 @@ Available @code{home-msmtp-configuration} fields are:
@item @code{defaults} (type: msmtp-configuration) @item @code{defaults} (type: msmtp-configuration)
The configuration that will be set as default for all accounts. The configuration that will be set as default for all accounts.
@item @code{accounts} (default: @code{()}) (type: list-of-msmtp-accounts) @item @code{accounts} (default: @code{'()}) (type: list-of-msmtp-accounts)
A list of @code{msmtp-account} records which contain information about A list of @code{msmtp-account} records which contain information about
all your accounts. all your accounts.