diff options
author | Alessio Vanni <vannilla@firemail.cc> | 2021-04-24 17:29:42 +0200 |
---|---|---|
committer | Alessio Vanni <vannilla@firemail.cc> | 2021-04-24 17:29:42 +0200 |
commit | 8233e282046e27de57de75f175e131a974087618 (patch) | |
tree | fba261f13d3a6225221a42082f561a3152969f82 /doc | |
parent | 3cd24823660a0447e590ff352e9da7eb076b292b (diff) | |
download | gnunet-8233e282046e27de57de75f175e131a974087618.tar.gz gnunet-8233e282046e27de57de75f175e131a974087618.zip |
Swap gnunet-config's default behaviour for the rewrite flag
With the previous default, a configuration file could keep values different
from the defaults even when the user did not explicitly edit that option,
potentially leading to buggy behaviour.
For example: GNUnet's version X+1 changes the default value for a certain
option A, but anyone who has edited the configuration file with version X or
earlier, would still have got the old default for A even when updating to
version X+1.
It was possible to write only the edited parts, but that required explicitly
passing the `--rewrite' (or `-w') flag.
The default behaviour has now been swapped so that the resulting file contains
only differences, while a "frozen" configuration is generated with the
`--rewrite' flag.
Also, as it's a minor change: a function used internally by the logging
component was using translated strings to check the requested log level. This
behaviour is buggy as passing an untranslated string to
e.g. `GNUNET_log_setup', while the current locale is different and a
translation for that string exists, would generate a different log level than
the one requested.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/man/gnunet-config.1 | 6 |
1 files changed, 3 insertions, 3 deletions
diff --git a/doc/man/gnunet-config.1 b/doc/man/gnunet-config.1 index f6166cbca..89bc3d14b 100644 --- a/doc/man/gnunet-config.1 +++ b/doc/man/gnunet-config.1 | |||
@@ -39,7 +39,7 @@ | |||
39 | .Op Fl s Ar SECTION | Fl -section= Ns Ar SECTION | 39 | .Op Fl s Ar SECTION | Fl -section= Ns Ar SECTION |
40 | .Op Fl V Ar VALUE | Fl -value Ar VALUE | 40 | .Op Fl V Ar VALUE | Fl -value Ar VALUE |
41 | .Op Fl v | -version | 41 | .Op Fl v | -version |
42 | .Op Fl W | -rewrite | 42 | .Op Fl w | -rewrite |
43 | .Sh DESCRIPTION | 43 | .Sh DESCRIPTION |
44 | .Nm | 44 | .Nm |
45 | can be used to read or modify GNUnet configuration files. | 45 | can be used to read or modify GNUnet configuration files. |
@@ -69,8 +69,8 @@ Configuration value to store in the given section under the given option. | |||
69 | Must only be given together with -s and -o options. | 69 | Must only be given together with -s and -o options. |
70 | .It Fl v | -version | 70 | .It Fl v | -version |
71 | Print GNUnet version number. | 71 | Print GNUnet version number. |
72 | .It Fl W | -rewrite | 72 | .It Fl w | -rewrite |
73 | Consider differences to defaults only. | 73 | Write to file the full configuration, including default values, instead of just the differences. |
74 | .El | 74 | .El |
75 | .Sh SEE ALSO | 75 | .Sh SEE ALSO |
76 | The full documentation for gnunet is maintained as a Texinfo manual. | 76 | The full documentation for gnunet is maintained as a Texinfo manual. |