dconf*: add/refresh pages (#8031)

* Fix top description:
- simplify description
- change `See also` link to `gsettings`
- fix man page url to manned.org because an old one is inaccessible

* Provide more examples and enhance existing ones:
- in `dconf`

* Add `dconf-read` page

* More `See also` links in `dconf`

* Add `reset` example

* Add `dconf-reset` page

* Refresh `dconf-write`:
- add link to `dconf` in `See also`
- fix man page url
- standardize examples with other `dconf` pages

* Fix man page urls everywhere in `dconf` pages
pull/1/head
Emily Grace Seville 2022-10-04 17:00:34 +10:00 committed by GitHub
parent 2100859d25
commit b9125f067c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 64 additions and 21 deletions

13
pages/linux/dconf-read.md Normal file
View File

@ -0,0 +1,13 @@
# dconf read
> Read key values from dconf databases.
> See also: `dconf`.
> More information: <https://manned.org/dconf>.
- Print a specific key value:
`dconf read {{/path/to/key}}`
- Print a specific key [d]efault value:
`dconf read -d {{/path/to/key}}`

View File

@ -0,0 +1,13 @@
# dconf reset
> Reset key values in dconf databases.
> See also: `dconf`.
> More information: <https://manned.org/dconf>.
- Reset a specific key value:
`dconf read {{/path/to/key}}`
- Reset a specific directory:
`dconf read -d {{/path/to/directory/}}`

View File

@ -1,24 +1,29 @@
# dconf write
> Write a value to a dconf database path.
> More information: <https://developer.gnome.org/dconf>.
> Write key values in dconf databases.
> See also: `dconf`.
> More information: <https://manned.org/dconf>.
- Write a string to a dconf path (note the nested quotes):
- Write a specific key value:
`dconf write {{/example/dconf/path}} "'{{Example Value}}'"`
`dconf write {{/path/to/key}} "{{value}}"`
- Write a boolean to a dconf path:
- Write a specific string key value:
`dconf write {{/example/dconf/path}} {{true|false}}`
`dconf write {{/path/to/key}} "'{{string}}'"`
- Write an integer to a dconf path:
- Write a specific integer key value:
`dconf write {{/example/dconf/path}} {{16}}`
`dconf write {{/path/to/key}} "{{5}}"`
- Write an array to a dconf path:
- Write a specific boolean key value:
`dconf write {{/example/dconf/path}} "[{{'My First Value', 'My Second Value'}}]"`
`dconf write {{/path/to/key}} "{{true|false}}"`
- Write an empty array to a dconf path:
- Write a specific array key value:
`dconf write {{/example/dconf/path}} "@as []"`
`dconf write {{/path/to/key}} "[{{'first', 'second', ...}}]"`
- Write a specific empty array key value:
`dconf write {{/path/to/key}} "@as []"`

View File

@ -1,17 +1,29 @@
# dconf
> Simple tool for manipulating dconf databases.
> See also `dconf write`.
> More information: <https://developer.gnome.org/dconf>.
> Manage dconf databases.
> See also: `dconf-read`, `dconf-reset`, `dconf-write`, `gsettings`.
> More information: <https://manned.org/dconf>.
- Print the value of a dconf path:
- Print a specific key value:
`dconf read {{/example/dconf/path}}`
`dconf read {{/path/to/key}}`
- List contents of a dconf path:
- Print a specific path sub-directories and sub-keys:
`dconf list {{/example/dconf/path}}`
`dconf list {{/path/to/directory/}}`
- Watch for dconf database changes in a path and subpaths:
- Write a specific key value:
`dconf watch {{/example/dconf/path}}`
`dconf write {{/path/to/key}} "{{value}}"`
- Reset a specific key value:
`dconf reset {{/path/to/key}}`
- Watch a specific key/directory for changes:
`dconf watch {{/path/to/key|/path/to/directory/}}`
- Dump a specific directory in INI file format:
`dconf dump {{/path/to/directory/}}`