View Issue Details

IDProjectCategoryView StatusLast Update
0006134Talerdocumentationpublic2020-03-23 12:56
ReporterFlorian DoldAssigned ToStefan 
PrioritynormalSeverityminorReproducibilityhave not tried
Status assignedResolutionopen 
Product Version 
Target VersionFixed in Version 
Summary0006134: configuration file format is insufficiently documented in GNUnet and Taler
DescriptionThere 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.
TagsNo tags attached.

Activities

There are no notes attached to this issue.

Issue History

Date Modified Username Field Change
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