View Issue Details
|ID||Project||Category||View Status||Date Submitted||Last Update|
|0006134||Taler||documentation||public||2020-03-23 09:47||2020-03-23 12:56|
|Reporter||Florian Dold||Assigned To||Stefan|
|Priority||normal||Severity||minor||Reproducibility||have not tried|
|Target Version||Fixed in Version|
|Summary||0006134: configuration file format is insufficiently documented in GNUnet and Taler|
|Description||There is no place other than the source code that comprehensively defines the configuration file format.|
The GNUnet man page has some bits, but is very specific to GNUnet. It doesn't mention the include mechanism, and the format is underspecified. For example:
* "Boolean values are given as "YES" and "NO"."
=> the manpage doesn't mention anything about case (in)sensitivity
* "Empty lines and lines beginning with a "#" are treated as comments."
=> What about comment lines that begin with a whitespace? Are they allowed?
=> How is whitespace handled in *front* of option names and section names?
* "A section contains a number of options of the form "OPTION=VALUE""
=> What lexical syntax does "OPTION" have? Does it allow whitespace, like many ini parsers do?
The GNUnet handbook isn't any more helpful. The Taler documentation and man pages also don't contain sufficient information.
The variable substitution syntax isn't explained properly either.
How string quotes work and if there are any escape symbols isn't clear from the docs.
Neither is the include mechanism.
|Tags||No tags attached.|
|2020-03-23 09:47||Florian Dold||New Issue|
|2020-03-23 09:47||Florian Dold||Status||new => assigned|
|2020-03-23 09:47||Florian Dold||Assigned To||=> Christian Grothoff|
|2020-03-23 09:48||Florian Dold||Description Updated||View Revisions|
|2020-03-23 12:56||Christian Grothoff||Assigned To||Christian Grothoff => Stefan|