From 02f7797aaf6ab9e5c4a2a89ab0efb33b43349e90 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Fri, 16 Oct 2026 11:20:03 +0200 Subject: docs(git): the git config page, and replace-all appending on no match Co-Authored-By: Claude Opus 5.5 --- desktop/modules/git/README.md | 22 ++++++++++++++++++++++ desktop/modules/user/README.md | 3 ++- 2 files changed, 24 insertions(+), 1 deletion(-) create mode 100644 desktop/modules/git/README.md (limited to 'desktop/modules') 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}` -- cgit v1.2.3