diff options
| author | Danilo M. <danix@danix.xyz> | 2026-10-16 11:20:03 +0200 |
|---|---|---|
| committer | Danilo M. <danix@danix.xyz> | 2026-10-16 11:20:03 +0200 |
| commit | 02f7797aaf6ab9e5c4a2a89ab0efb33b43349e90 (patch) | |
| tree | 5a841156d6556fa53ea2f9f6c28934bcc288d550 /desktop/modules | |
| parent | 2bde0952fd03d09d5ef8b1c2dcf39aa77e8762b8 (diff) | |
| download | quickshell-02f7797aaf6ab9e5c4a2a89ab0efb33b43349e90.tar.gz quickshell-02f7797aaf6ab9e5c4a2a89ab0efb33b43349e90.zip | |
docs(git): the git config page, and replace-all appending on no match
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'desktop/modules')
| -rw-r--r-- | desktop/modules/git/README.md | 22 | ||||
| -rw-r--r-- | desktop/modules/user/README.md | 3 |
2 files changed, 24 insertions, 1 deletions
diff --git a/desktop/modules/git/README.md b/desktop/modules/git/README.md new file mode 100644 index 0000000..57c8965 --- /dev/null +++ b/desktop/modules/git/README.md @@ -0,0 +1,22 @@ +# git + +The global git config (`~/.gitconfig`), every key, reached from the user +page's "More git settings" button. Back returns to the user page. + +One row per value, grouped by section in file order, so a key set several +times shows several rows. Enter saves a row, Escape undoes an edit, Remove +drops that one value, and the Add row takes `section.key` and a value. +"Edit in editor" opens the file in Sublime Text. + +`gitcfg` does every read and write, through `git config`, so the file keeps +its comments and layout. `--fixed-value` makes a write touch one value of a +multi-valued key. `set` and `unset` first check the old value is still +there, because `--replace-all` with no match appends instead of failing, and +the file may have changed in the editor. After every write the page reads +the list again; a failure shows git's reason under its row. + +Checks: `./test-gitcfg.sh` (a throwaway `GIT_CONFIG_GLOBAL`) and +`node desktop/modules/git/test_git.js`. + +Not here: per-repository, system and `[include]`d configs. A value holding a +newline edits on one line; use the editor for those. diff --git a/desktop/modules/user/README.md b/desktop/modules/user/README.md index 692fb78..7178838 100644 --- a/desktop/modules/user/README.md +++ b/desktop/modules/user/README.md @@ -15,7 +15,8 @@ Location suggests places from OpenStreetMap's Nominatim as you type: what is typed is sent to `nominatim.openstreetmap.org`, 1s after typing stops and from three characters, per its usage policy. Up/Down, Enter and Escape work the list. Offline, the field is plain text. The Git section -shows the name and email git will get, read-only, and the signing key. +shows the name and email git will get, read-only, and the signing key; +"More git settings" opens the full global git config (`../git/`). The greeting is picked at random on each drawer open, never the same one twice running, from `~/.config/quickshell/greetings`: one per line, `{user}` |
