From c9d78ec0f5c5935616cb12206bd616a0966ab0af Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Mon, 26 Apr 2021 17:07:25 +0200 Subject: update prebuild docs --- man/taler.conf.5 | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) (limited to 'man/taler.conf.5') diff --git a/man/taler.conf.5 b/man/taler.conf.5 index aee0a7c6..48911c7f 100644 --- a/man/taler.conf.5 +++ b/man/taler.conf.5 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "TALER.CONF" "5" "Jan 27, 2021" "0.8pre0" "GNU Taler" +.TH "TALER.CONF" "5" "Apr 26, 2021" "0.8" "GNU Taler" .SH NAME taler.conf \- Taler configuration file . @@ -62,6 +62,7 @@ more \fBNUMBER UNIT\fP pairs, e.g. \fB60 s\fP, \fB4 weeks 1 day\fP, \fB5 years 2 .sp Values that represent an amount are in the usual amount syntax: \fBCURRENCY:VALUE.FRACTION\fP, e.g. \fBEUR:1.50\fP\&. +The \fBFRACTION\fP portion may extend up to 8 places. .sp Files containing default values for many of the options described below are installed under \fB$TALER_PREFIX/share/taler/config.d/\fP\&. @@ -121,7 +122,7 @@ Port on which the HTTP server listens, e.g.\ 8080. .TP .B MASTER_PUBLIC_KEY Crockford Base32\-encoded master public key, public version of the -exchange’s long\-time offline signing key. +exchange\(aqs long\-time offline signing key. .TP .B MASTER_PRIV_FILE Location of the master private key on disk. Only used by tools that @@ -144,12 +145,12 @@ For how long should clients cache \fB/keys\fP responses at most? .B TERMS_DIR Directory where the terms of service of the exchange operator can be fund. The directory must contain sub\-directories for every supported language, -using the two\-character language code in lower case, e.g. “en/” or “fr/”. +using the two\-character language code in lower case, e.g. "en/" or "fr/". Each subdirectory must then contain files with the terms of service in various formats. The basename of the file of the current policy must be specified under \fBTERMS_ETAG\fP\&. The extension defines the mime type. -Supported extensions include “html”, “htm”, “txt”, “pdf”, “jpg”, “jpeg”, -“png” and “gif”. For example, using a \fBTERMS_ETAG\fP of “0”, the structure +Supported extensions include "html", "htm", "txt", "pdf", "jpg", "jpeg", +"png" and "gif". For example, using a \fBTERMS_ETAG\fP of "0", the structure could be the following: .INDENT 7.0 .IP \(bu 2 @@ -168,7 +169,7 @@ $TERMS_DIR/de/0.txt .TP .B TERMS_ETAG Basename of the file(s) in the \fBTERMS_DIR\fP with the current terms of service. -The value is also used for the “Etag” in the HTTP request to control +The value is also used for the "Etag" in the HTTP request to control caching. Whenever the terms of service change, the \fBTERMS_ETAG\fP MUST also change, and old values MUST NOT be repeated. For example, the date or version number of the terms of service SHOULD be used for the Etag. If @@ -184,7 +185,7 @@ Works the same as \fBTERMS_ETAG\fP, just for the privacy policy. .UNINDENT .SS EXCHANGE OFFLINE SIGNING OPTIONS .sp -The following options must be in the section “[exchange\-offline]”. +The following options must be in the section "[exchange\-offline]". .INDENT 0.0 .TP .B MASTER_PRIV_FILE @@ -210,7 +211,7 @@ this option will also be ignored. .UNINDENT .SS EXCHANGE RSA CRYPTO HELPER OPTIONS .sp -The following options must be in the section “[taler\-exchange\-secmod\-rsa]”. +The following options must be in the section "[taler\-exchange\-secmod\-rsa]". .INDENT 0.0 .TP .B LOOKAHEAD_SIGN @@ -237,7 +238,7 @@ Note that the \fBtaler\-exchange\-secmod\-rsa\fP also evaluates the \fB[coin_*]\ configuration sections described below. .SS EXCHANGE EDDSA CRYPTO HELPER OPTIONS .sp -The following options must be in the section “[taler\-exchange\-secmod\-eddsa]”. +The following options must be in the section "[taler\-exchange\-secmod\-eddsa]". .INDENT 0.0 .TP .B LOOKAHEAD_SIGN @@ -264,7 +265,7 @@ On which path should the security module listen for signing requests? .UNINDENT .SS EXCHANGE DATABASE OPTIONS .sp -The following options must be in the section “[exchangedb]”. +The following options must be in the section "[exchangedb]". .INDENT 0.0 .TP .B IDLE_RESERVE_EXPIRATION_TIME @@ -305,7 +306,7 @@ URL of the wire gateway. Typically of the form \fBhttps://$HOSTNAME[:$PORT]/taler\-wire\-gateway/$USERNAME/\fP where $HOSTNAME is the hostname of the system running the bank (such as the Taler Python bank or the Nexus) and \fB$USERNAME\fP is -the username of the exchange’s bank account (usually matching +the username of the exchange\(aqs bank account (usually matching the \fBUSERNAME\fP option used for authentication). Example: \fBhttps://bank.demo.taler.net/taler\-wire\-gateway/Exchange/\fP\&. .TP @@ -416,7 +417,7 @@ Base URL of the exchange, e.g.\ “\fI\%https://exchange.demo.taler.net/\fP” .TP .B MASTER_KEY Crockford Base32 encoded master public key, public version of the -exchange’s long\-time offline signing key. Can be omitted, in that +exchange\(aqs long\-time offline signing key. Can be omitted, in that case the exchange will NOT be trusted unless it is audited by a known auditor. Omitting \fBMASTER_KEY\fP can be useful if we do not trust the exchange @@ -475,8 +476,8 @@ The following options must be in section “[auditordb\-postgres]” if the .INDENT 0.0 .TP .B CONFIG -How to access the database, e.g.\ “postgres:///taler” to use the -“taler” database. Testcases use “talercheck”. +How to access the database, e.g.\ "postgres:///taler" to use the +"taler" database. Testcases use “talercheck”. .UNINDENT .SH SEE ALSO .sp @@ -489,6 +490,6 @@ mail to <\fI\%taler@gnu.org\fP>. .SH AUTHOR GNU Taler contributors .SH COPYRIGHT -2014-2020 Taler Systems SA (GPLv3+ or GFDL 1.3+) +2014-2021 Taler Systems SA (GPLv3+ or GFDL 1.3+) .\" Generated by docutils manpage writer. . -- cgit v1.2.3