Skip to content

Commit 8c97c04

Browse files
committed
docs(greeter): adjust version numbers for passwordless sync
1 parent b80f98e commit 8c97c04

3 files changed

Lines changed: 25 additions & 22 deletions

File tree

docs/user/installation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ The Noctalia team maintains the source build, project flake, and AUR packages. D
2525
Every installation needs **greetd** and **D-Bus** on the machine where the greeter runs. The **Polkit daemon and `pkexec`** are optional for login, but required to sync appearance from Noctalia; some distributions package `pkexec` separately.
2626

2727
:::note[Sync compatibility]
28-
Passwordless sync is optional and requires Noctalia Greeter 1.4.0 or newer
28+
Passwordless sync is optional and requires Noctalia Greeter 1.5.0 or newer
2929
together with the next Noctalia release after 5.0.1. Current `-git` packages,
3030
`main` checkouts, or manual builds from current `main` work when both projects
3131
are up to date. Older and mixed-version combinations continue to use the

docs/user/sync.md

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ sidebar:
1010
Noctalia Shell can copy its current appearance and monitor arrangement to the login screen. Install both **Noctalia** and **Noctalia Greeter**, including the packaged apply helper and Polkit action.
1111

1212
:::caution[Passwordless version requirement]
13-
Passwordless sync requires **Noctalia Greeter 1.4.0 or newer** together with
13+
Passwordless sync requires **Noctalia Greeter 1.5.0 or newer** together with
1414
**the next Noctalia release after 5.0.1**. Current `-git` packages or current
1515
manual builds from `main` also work when both components are up to date.
1616

@@ -73,12 +73,12 @@ When the same value exists in both files, `greeter.toml` wins. In particular, a
7373

7474
With a current Shell and greeter:
7575

76-
| On disk / in config | Purpose |
77-
|---------------------|---------|
78-
| `wallpaper` / `wallpaper.<ext>` and `[appearance.wallpaper]` | Default image or fallback |
79-
| `wallpaper-<connector>.*` and `[appearance.wallpapers.<connector>]` | Per-output wallpaper, such as `DP-2` |
80-
| `[appearance.palette]`, `theme_mode`, `corner_radius_scale`, `font_family` | Synced colors and UI styling |
81-
| `[output].layout`, `transforms`, `scales` | Synced monitor arrangement |
76+
| On disk / in config | Purpose |
77+
| -------------------------------------------------------------------------- | ------------------------------------ |
78+
| `wallpaper` / `wallpaper.<ext>` and `[appearance.wallpaper]` | Default image or fallback |
79+
| `wallpaper-<connector>.*` and `[appearance.wallpapers.<connector>]` | Per-output wallpaper, such as `DP-2` |
80+
| `[appearance.palette]`, `theme_mode`, `corner_radius_scale`, `font_family` | Synced colors and UI styling |
81+
| `[output].layout`, `transforms`, `scales` | Synced monitor arrangement |
8282

8383
Each greeter view uses the wallpaper for its connector when one exists, then falls back to `[appearance.wallpaper]`. A connector pinned with `[output].name` uses its matching entry. See [Displays](displays.md) for connector and layout settings.
8484

@@ -163,7 +163,7 @@ managed authorization; prompted sync remains available.
163163
If another administrator-authored Polkit rule also allows that account, remove
164164
or update that separate rule before prompts resume.
165165

166-
Use these commands with a packaged or system-installed Greeter 1.4.0 or newer.
166+
Use these commands with a packaged or system-installed Greeter 1.5.0 or newer.
167167
They intentionally reject an untrusted helper installation rather than writing
168168
a rule for a checkout, build directory, or user-writable prefix. Packages must
169169
also include the dedicated `org.noctalia.greeter.sync-appearance` Polkit action.
@@ -240,14 +240,17 @@ mode `0644`. Replace `alice` and
240240
printed above:
241241

242242
```js
243-
polkit.addRule(function(action, subject) {
243+
polkit.addRule(function (action, subject) {
244244
var allowedUsers = ["alice"];
245245

246-
if (action.id == "org.noctalia.greeter.sync-appearance" &&
247-
action.lookup("program") == "/usr/bin/noctalia-greeter-apply-appearance" &&
248-
action.lookup("user") == "root" &&
249-
subject.local && subject.active &&
250-
allowedUsers.indexOf(subject.user) >= 0) {
246+
if (
247+
action.id == "org.noctalia.greeter.sync-appearance" &&
248+
action.lookup("program") == "/usr/bin/noctalia-greeter-apply-appearance" &&
249+
action.lookup("user") == "root" &&
250+
subject.local &&
251+
subject.active &&
252+
allowedUsers.indexOf(subject.user) >= 0
253+
) {
251254
return polkit.Result.YES;
252255
}
253256
});

docs/user/troubleshooting.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -29,11 +29,11 @@ The service may have a different unit name on a distribution-provided setup. On
2929

3030
`NOCTALIA_GREETER_LOG` changes the destination:
3131

32-
| Value | Effect |
33-
|-------|--------|
34-
| Unset | Log through syslog; keep stdout and stderr parked |
35-
| `stderr` | Send informational and debug messages to stdout, and warnings and errors to stderr |
36-
| An absolute file path | Append to that file and continue logging through syslog |
32+
| Value | Effect |
33+
| --------------------- | ---------------------------------------------------------------------------------- |
34+
| Unset | Log through syslog; keep stdout and stderr parked |
35+
| `stderr` | Send informational and debug messages to stdout, and warnings and errors to stderr |
36+
| An absolute file path | Append to that file and continue logging through syslog |
3737

3838
For temporary console diagnostics, add the variable to the greetd session command:
3939

@@ -121,7 +121,7 @@ GNOME expects a systemd-managed user session and may fail with a `graphical-sess
121121
### Appearance sync
122122

123123
If the synced look is missing, first check the installed versions. The
124-
constrained `--sync` path requires Noctalia Greeter 1.4.0 or newer together
124+
constrained `--sync` path requires Noctalia Greeter 1.5.0 or newer together
125125
with the next Noctalia release after 5.0.1; current `-git` packages, `main`
126126
checkouts, or manual builds from current `main` work when both projects are up
127127
to date. Older and mixed-version combinations use the permanently supported
@@ -159,7 +159,7 @@ rules directory.
159159

160160
If needed, add it with
161161
`sudo noctalia-greeter passwordless-sync enable alice`. The installed Greeter
162-
must be 1.4.0 or newer, the package must include the dedicated
162+
must be 1.5.0 or newer, the package must include the dedicated
163163
`org.noctalia.greeter.sync-appearance` action, and Polkit must see the caller as
164164
an active local session. A seatd-only session without logind or elogind cannot
165165
match this rule.

0 commit comments

Comments
 (0)