summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorTomasz Miąsko <tomasz.miasko@gmail.com>2019-02-09 00:00:00 +0000
committerTomasz Miąsko <tomasz.miasko@gmail.com>2019-02-12 18:59:03 +0100
commitc963f9eec8d72d6e17099d456330cd988294c0af (patch)
tree1444a893b63574b768194dce7b5a9b7cc37cc05c /docs
parent108158af9e0db6f05ff10d75e2349b7db91013ae (diff)
downloaddconf-c963f9eec8d72d6e17099d456330cd988294c0af.tar.gz
bin: Add an option to ignore changes to locked keys during load
If load command attempts to change one of non-writable keys, the whole operation fails with an error and no changes are made. Add an `-f` option to the load command that skips non-writable keys and proceeds with remaining changes. Closes issue #1.
Diffstat (limited to 'docs')
-rw-r--r--docs/dconf-tool.xml9
1 files changed, 8 insertions, 1 deletions
diff --git a/docs/dconf-tool.xml b/docs/dconf-tool.xml
index 7093da6..e5f8c24 100644
--- a/docs/dconf-tool.xml
+++ b/docs/dconf-tool.xml
@@ -77,6 +77,7 @@
<cmdsynopsis>
<command>dconf</command>
<arg choice="plain">load</arg>
+ <arg choice="opt">-f</arg>
<arg choice="plain"><replaceable>DIR</replaceable></arg>
</cmdsynopsis>
<cmdsynopsis>
@@ -180,7 +181,13 @@
<varlistentry>
<term><option>load</option></term>
- <listitem><para>Populate a subpath from stdin. The expected format is the same as produced by <option>dump</option>.</para></listitem>
+ <listitem>
+ <para>
+ Populate a subpath from stdin. The expected format is the same as produced by <option>dump</option>.
+ Attempting to change non-writable keys cancels the load command.
+ To ignore changes to non-writable keys instead, use <option>-f</option>.
+ </para>
+ </listitem>
</varlistentry>
<varlistentry>