From 718eb551048ac0de520963251d5a651682676d8b Mon Sep 17 00:00:00 2001 From: Florian Pelz Date: Tue, 30 May 2023 16:22:27 +0200 Subject: [PATCH] doc: Quote all list values. * doc/guix.texi (System Configuration)[Services]: Replace all () by '(), and similar quotings. (Home Configuration)[Home Services]: Likewise. --- doc/guix.texi | 264 +++++++++++++++++++++++++------------------------- 1 file changed, 132 insertions(+), 132 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 47b2b8ba62..5fd2449ed5 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -19611,7 +19611,7 @@ Available @code{mcron-configuration} fields are: @item @code{mcron} (default: @code{mcron}) (type: file-like) 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 corresponds to an mcron job specification (@pxref{Syntax, mcron job 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 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. If empty, @command{lshd} listens for connections on all the network interfaces. @@ -22328,7 +22328,7 @@ When unspecified, listen for any hosts/IP addresses. @item @code{vnc-server-port} (default: @code{5900}) (type: number) 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. @end table @@ -22377,7 +22377,7 @@ The accessibility features to enable, given as list of symbols. @item @code{reader} (type: maybe-file-like) 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 configuration file. @@ -22415,7 +22415,7 @@ The Xorg server command to run. @item @code{session-wrapper} (type: file-like) 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. @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{'()}) 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 -order---e.g., @code{("modesetting" "vesa")}. +order---e.g., @code{'("modesetting" "vesa")}. @item @code{resolutions} (default: @code{'()}) 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))}. @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 @code{access-controls} of @code{operation-access-control}. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @deftypevr {@code{location-access-controls} parameter} method-access-control-list method-access-controls Access controls for method-specific access to this path. -Defaults to @samp{()}. +Defaults to @samp{'()}. Available @code{method-access-controls} fields are: @@ -22994,14 +22994,14 @@ Defaults to @samp{#f}. @deftypevr {@code{method-access-controls} parameter} method-list methods Methods to which this access control applies. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @deftypevr {@code{method-access-controls} parameter} access-control-list access-controls Access control directives, as a list of strings. Each string should be one directive, such as @samp{"Order allow,deny"}. -Defaults to @samp{()}. +Defaults to @samp{'()}. @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 of strings. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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 Access control by IPP operation. -Defaults to @samp{()}. +Defaults to @samp{'()}. @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 @code{*} to indicate all addresses. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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 protocol version to TLS v1.1. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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) 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 containing additional D-Bus configuration and policy files. 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, report what the Sieve interpreter supports by default. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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, report what the Sieve interpreter supports by default. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -25121,7 +25121,7 @@ The service kind. Valid values include @code{director}, Listeners for the service. A listener is either a @code{unix-listener-configuration}, a @code{fifo-listener-configuration}, or an @code{inet-listener-configuration}. -Defaults to @samp{()}. +Defaults to @samp{'()}. 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 A list of key-value pairs that this dict should hold. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @end deftypevr @@ -25283,7 +25283,7 @@ Defaults to @samp{""}. @deftypevr {@code{userdb-configuration} parameter} free-form-args override-fields Override fields from passwd. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @end deftypevr @@ -25361,7 +25361,7 @@ Defaults to @samp{#t}. @deftypevr {@code{namespace-configuration} parameter} mailbox-configuration-list mailboxes List of predefined mailboxes in this namespace. -Defaults to @samp{()}. +Defaults to @samp{'()}. 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. Valid values are @code{\All}, @code{\Archive}, @code{\Drafts}, @code{\Flagged}, @code{\Junk}, @code{\Sent}, and @code{\Trash}. -Defaults to @samp{()}. +Defaults to @samp{'()}. @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 for these networks. Typically you would specify your IMAP proxy servers here. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @deftypevr {@code{dovecot-configuration} parameter} space-separated-string-list login-access-sockets List of login access check sockets (e.g.@: tcpwrap). -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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. Many clients simply use the first one listed here, so keep the default realm first. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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. Ports can be specified as ip:port. The default port is the same as what director service's @samp{inet-listener} is using. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @deftypevr {@code{dovecot-configuration} parameter} space-separated-string-list director-mail-servers List of IPs or hostnames to all backend mail servers. Ranges are allowed too, like 10.0.0.10-10.0.0.30. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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 this should be done only if you don't allow shell access for users. . -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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 List of plugins to load for all services. Plugins specific to IMAP, LDA, etc.@: are added to this list in their own .conf files. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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 greyed out, instead of only later giving "not selectable" popup error. @end table -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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 Override fields from passwd. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -26598,7 +26598,7 @@ Defaults to @samp{""}. @deftypevr {@code{getmail-retriever-configuration} parameter} parameter-alist extra-parameters Extra retriever parameters. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -26628,7 +26628,7 @@ Defaults to @samp{""}. @deftypevr {@code{getmail-destination-configuration} parameter} parameter-alist extra-parameters Extra destination parameters -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -26743,7 +26743,7 @@ Defaults to @samp{#f}. @deftypevr {@code{getmail-options-configuration} parameter} parameter-alist extra-parameters Extra options to include. -Defaults to @samp{()}. +Defaults to @samp{'()}. @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 extension. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @deftypevr {@code{getmail-configuration} parameter} list environment-variables Environment variables to set for getmail. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -26937,7 +26937,7 @@ Defaults to @samp{"/var/lib/prosody"}. @deftypevr {@code{prosody-configuration} parameter} file-object-list plugin-paths Additional plugin directories. They are searched in all the specified paths in order. See @url{https://prosody.im/doc/plugins_directory}. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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 @url{https://prosody.im/doc/creating_accounts}. Example: @code{(admins '("user1@@example.com" "user2@@example.net"))} -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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. Documentation on modules can be found at: @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 @deftypevr {@code{prosody-configuration} parameter} string-list modules-disabled @samp{"offline"}, @samp{"c2s"} and @samp{"s2s"} are auto-loaded, but should you want to disable them then add them to this list. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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 Set of mechanisms that will never be offered. See @url{https://prosody.im/doc/modules/mod_saslauth}. -Defaults to @samp{("DIGEST-MD5")}. +Defaults to @samp{'("DIGEST-MD5")}. @end deftypevr @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 authenticate using certificates. They will be authenticated using DNS@. See @url{https://prosody.im/doc/s2s#security}. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @deftypevr {@code{prosody-configuration} parameter} string-list s2s-secure-domains Even if you leave @code{s2s-secure-auth?} disabled, you can still require valid certificates for some domains by specifying a list here. See @url{https://prosody.im/doc/s2s#security}. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @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. See @url{https://prosody.im/doc/components}. -Defaults to @samp{()}. +Defaults to @samp{'()}. Available @code{int-component-configuration} fields are: @@ -27223,7 +27223,7 @@ Defaults to @samp{20}. External components use XEP-0114, which most standalone components support. To add an external component, you simply fill the hostname field. See @url{https://prosody.im/doc/components}. -Defaults to @samp{()}. +Defaults to @samp{'()}. 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 Port(s) Prosody listens on for component connections. -Defaults to @samp{(5347)}. +Defaults to @samp{'(5347)}. @end deftypevr @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 may be specified using @samp{*}. -Defaults to @samp{("127.0.0.1" "::1")}. +Defaults to @samp{'("127.0.0.1" "::1")}. @end deftypevr @@ -28526,7 +28526,7 @@ Defaults to @samp{#t}. The list of host names recognized by the @acronym{RPC} server when @code{rpc-host-whitelist-enabled?} is @code{#t}. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -29104,7 +29104,7 @@ Location of SSL client certificates. @item @code{extra-options} (default: @code{""}) (type: extra-options) 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 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) 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 Zabbix servers and Zabbix proxies. Incoming connections will be 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 proxies for active checks. If port is not specified, default port is 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) 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 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) 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}} blocks for the Zabbix front-end. When empty, a default that listens on 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 specified log level or higher are logged. -Defaults to @samp{("/var/log/nslcd" info)}. +Defaults to @samp{'("/var/log/nslcd" info)}. @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 used with the following servers as fall-back. -Defaults to @samp{("ldap://localhost:389/")}. +Defaults to @samp{'("ldap://localhost:389/")}. @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 service lookups; children scope is not supported on all servers. -Defaults to @samp{(subtree)}. +Defaults to @samp{'(subtree)}. @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 expression for the attribute as it is available in the directory. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -29609,7 +29609,7 @@ Defaults to @samp{()}. A list of filters consisting of the name of a map to which the filter applies and an LDAP search filter expression. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -29854,7 +29854,7 @@ Defaults to @samp{disabled}. @deftypevr {@code{nslcd-configuration} parameter} list pam-services List of pam service names for which LDAP authentication should suffice. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -31350,7 +31350,7 @@ The certbot package to use. The directory from which to serve the Let's Encrypt challenge/response files. -@item @code{certificates} (default: @code{()}) +@item @code{certificates} (default: @code{'()}) A list of @code{certificates-configuration}s for which to generate certificates and request signatures. Each certificate has a @code{name} and several @code{domains}. @@ -31401,7 +31401,7 @@ certificate names, run @code{certbot certificates}. 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 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 Extra options will be appended to @file{ddclient.conf} file. -Defaults to @samp{()}. +Defaults to @samp{'()}. @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) 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 default is "None", which is safe given that Xvnc is configured to 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 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 record. @@ -32467,7 +32467,7 @@ Bind to a specific local port number. @item @code{resolv-retry?} (default: @code{#t}) (type: resolv-retry) 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. @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. 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. @end table @@ -33964,11 +33964,11 @@ who is a part of the group @var{group} (see below). The group to run mpd as. 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 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. @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) 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". -@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. -@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. -@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. @item @code{input-cache-size} (type: maybe-string) 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. @item @code{resampler} (type: maybe-mpd-plugin) 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. @item @code{outputs} (type: list-of-mpd-plugin-or-output) The audio outputs that MPD can use. By default this is a single output 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. -@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 appended to the configuration. @@ -34060,7 +34060,7 @@ Name. @item @code{enabled?} (type: maybe-boolean) 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 appended to the plugin configuration. See @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) 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 appended to the partition configuration. See @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 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 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) 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 will depend on. @@ -34278,10 +34278,10 @@ Whether to preserve caches between service restarts. Available @code{mympd-ip-acl} fields are: @table @asis -@item @code{allow} (default: @code{()}) (type: list-of-strings) +@item @code{allow} (default: @code{'()}) (type: list-of-strings) Allowed IP addresses. -@item @code{deny} (default: @code{()}) (type: list-of-strings) +@item @code{deny} (default: @code{'()}) (type: list-of-strings) Disallowed IP addresses. @end table @@ -34471,7 +34471,7 @@ API access control scheme. By default an authenticated user is allowed access to all APIs. Access drivers can place restrictions on this. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -34531,7 +34531,7 @@ Defaults to @samp{#f}. @deftypevr {@code{libvirt-configuration} parameter} optional-list tls-allowed-dn-list Whitelist of allowed x509 Distinguished Name. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -34539,7 +34539,7 @@ Defaults to @samp{()}. Whitelist of allowed SASL usernames. The format for username depends on the SASL authentication mechanism. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -36270,14 +36270,14 @@ Defaults to @samp{#t}. List of common prefixes which, when combined with a repository URL, generates valid clone URLs for the repository. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @deftypevr {@code{cgit-configuration} parameter} list clone-url List of @code{clone-url} templates. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -36570,7 +36570,7 @@ Defaults to @samp{""}. @deftypevr {@code{cgit-configuration} parameter} mimetype-alist mimetype 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/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 all subdirectories will be loaded. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -36656,7 +36656,7 @@ Defaults to @samp{""}. @deftypevr {@code{cgit-configuration} parameter} robots-list robots Text used as content for the @code{robots} meta-tag. -Defaults to @samp{("noindex" "nofollow")}. +Defaults to @samp{'("noindex" "nofollow")}. @end deftypevr @@ -36697,7 +36697,7 @@ Defaults to @samp{#f}. Text which specifies the default set of snapshot formats that cgit generates links for. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -36791,7 +36791,7 @@ Defaults to @samp{"/"}. @deftypevr {@code{cgit-configuration} parameter} repository-cgit-configuration-list repositories A list of @dfn{cgit-repo} records to use with config. -Defaults to @samp{()}. +Defaults to @samp{'()}. 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, restricted by the global @code{snapshots} setting. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -36835,7 +36835,7 @@ Defaults to @samp{""}. @deftypevr {@code{repository-cgit-configuration} parameter} repo-list clone-url A list of URLs which can be used to clone repo. -Defaults to @samp{()}. +Defaults to @samp{'()}. @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 listing. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -37036,7 +37036,7 @@ Defaults to @samp{""}. @deftypevr {@code{repository-cgit-configuration} parameter} repo-list extra-options Extra options will be appended to cgitrc file. -Defaults to @samp{()}. +Defaults to @samp{'()}. @end deftypevr @@ -37045,7 +37045,7 @@ Defaults to @samp{()}. @deftypevr {@code{cgit-configuration} parameter} list extra-options Extra options will be appended to cgitrc file. -Defaults to @samp{()}. +Defaults to @samp{'()}. @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 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 files are silently ignored. The evaluation of the list @emph{stops} 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}) 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}. 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) 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{} collected from 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{} 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, 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) Action name. -@item @code{arguments} (default: @code{()}) (type: list-of-arguments) +@item @code{arguments} (default: @code{'()}) (type: list-of-arguments) Action arguments. @end table @@ -38955,7 +38955,7 @@ the ban IP address is considered. @item @code{ignore-self?} (type: maybe-boolean) 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. @code{fail2ban} will not ban a host which matches an address in this 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: @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. -@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{}. -@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 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 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 entries to appear in the bootloader menu, in addition to the current 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} 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., -@code{("console=ttyS0")}. +@code{'("console=ttyS0")}. @item @code{initrd} (default: @code{#f}) 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") @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. -@item @code{multiboot-modules} (default: @code{()}) +@item @code{multiboot-modules} (default: @code{'()}) The list of commands for loading Multiboot modules. For example: @lisp @@ -42536,7 +42536,7 @@ that @file{~/.profile} is sourced by @file{~/.bash_profile} and Available @code{home-shell-profile-configuration} fields are: @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-environment}, DO NOT create this service manually, it can 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 @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 rules for the @code{home-environment-variables-service-type} apply here (@pxref{Essential Home Services}). The contents of this field will be 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 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, @@ -42587,19 +42587,19 @@ turns into alias ls="ls -alF" @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}. 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} 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 for executing user's commands at start of interactive shell (The shell for interactive usage started by typing @code{bash} or by terminal app 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}. 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 @@ -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: @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 environment variables from other extensions and the base service to form one 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 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 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 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 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 @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. -@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 for setting user's shell environment variables. Must not contain commands assuming the presence of tty or producing output. Will be read 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 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 @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 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 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 for executing user's commands at the end of starting process of login 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 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 @@ -42747,7 +42747,7 @@ Available @code{home-mcron-configuration} fields are: @item @code{mcron} (default: @code{mcron}) (type: file-like) 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 corresponds to an mcron job specification (@pxref{Syntax, mcron job specifications,, mcron,GNU@tie{}mcron}). @@ -43571,7 +43571,7 @@ Available @code{home-msmtp-configuration} fields are: @item @code{defaults} (type: msmtp-configuration) 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 all your accounts.