aboutsummaryrefslogtreecommitdiffstats
path: root/desktop/modules/user/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'desktop/modules/user/README.md')
-rw-r--r--desktop/modules/user/README.md7
1 files changed, 6 insertions, 1 deletions
diff --git a/desktop/modules/user/README.md b/desktop/modules/user/README.md
index 63670eb..692fb78 100644
--- a/desktop/modules/user/README.md
+++ b/desktop/modules/user/README.md
@@ -1,6 +1,6 @@
# user
-The drawer's greeting row (avatar, `Hello <login>`, real name) and the page
+The drawer's greeting row (avatar, a greeting, real name) and the page
it opens, which edits the user's details where other programs read them.
| Field | Written to |
@@ -17,6 +17,11 @@ 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.
+The greeting is picked at random on each drawer open, never the same one
+twice running, from `~/.config/quickshell/greetings`: one per line, `{user}`
+for the login name, `#` comments and blank lines skipped. Without the file,
+five built-in ones.
+
`userctl` does all reading and writing; the page only calls it. Polkit lets a
user edit their own AccountsService entry without a prompt. A new detail is
one entry in `UserPage.qml`'s `fields` and one `case` in `userctl`.