Skip to content

SolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.

Help: check for updates and show results in the selected language (#8896)

SvenCarstensenaff810620547
diff --git a/apps/solidcraft/src/native_menu.rs b/apps/solidcraft/src/native_menu.rs
index 1d75df7a87..0e64b53871 100644
--- a/apps/solidcraft/src/native_menu.rs
+++ b/apps/solidcraft/src/native_menu.rs
@@ -101,6 +101,7 @@ impl NativeMenu {
])?;
for (action, label) in [
("docs", "Documentation"),
+ ("updates", app.tr("update.check_for_updates")),
("shortcuts", "Keyboard Shortcuts"),
("messages", "Messages\u{2026}"),
("report", "Report an Issue\u{2026}"),
diff --git a/assets/locales/pending/help-check-for-updates.json b/assets/locales/pending/help-check-for-updates.json
new file mode 100644
index 0000000000..560ed77b7b
--- /dev/null
+++ b/assets/locales/pending/help-check-for-updates.json
@@ -0,0 +1,122 @@
+{
+ "en": {
+ "update.check_for_updates": "Check for updates",
+ "update.check_unavailable": "Update checks are not available for this installation."
+ },
+ "ar": {
+ "update.check_for_updates": "التحقق من وجود تحديثات",
+ "update.check_unavailable": "التحقق من التحديثات غير متاح لهذا التثبيت."
+ },
+ "bs": {
+ "update.check_for_updates": "Provjeri ažuriranja",
+ "update.check_unavailable": "Provjera ažuriranja nije dostupna za ovu instalaciju."
+ },
+ "cs": {
+ "update.check_for_updates": "Zkontrolovat aktualizace",
+ "update.check_unavailable": "Pro tuto instalaci není kontrola aktualizací dostupná."
+ },
+ "da": {
+ "update.check_for_updates": "Søg efter opdateringer",
+ "update.check_unavailable": "Søgning efter opdateringer er ikke tilgængelig for denne installation."
+ },
+ "de": {
+ "update.check_for_updates": "Nach Updates suchen",
+ "update.check_unavailable": "Für diese Installation ist keine Update-Prüfung verfügbar."
+ },
+ "es": {
+ "update.check_for_updates": "Buscar actualizaciones",
+ "update.check_unavailable": "La búsqueda de actualizaciones no está disponible para esta instalación."
+ },
+ "fr": {
+ "update.check_for_updates": "Rechercher des mises à jour",
+ "update.check_unavailable": "La recherche de mises à jour n’est pas disponible pour cette installation."
+ },
+ "gl": {
+ "update.check_for_updates": "Buscar actualizacións",
+ "update.check_unavailable": "A busca de actualizacións non está dispoñible para esta instalación."
+ },
+ "he": {
+ "update.check_for_updates": "בדיקת עדכונים",
+ "update.check_unavailable": "בדיקת עדכונים אינה זמינה עבור התקנה זו."
+ },
+ "hr": {
+ "update.check_for_updates": "Provjeri ažuriranja",
+ "update.check_unavailable": "Provjera ažuriranja nije dostupna za ovu instalaciju."
+ },
+ "hu": {
+ "update.check_for_updates": "Frissítések keresése",
+ "update.check_unavailable": "Ehhez a telepítéshez nem érhető el a frissítések keresése."
+ },
+ "id": {
+ "update.check_for_updates": "Periksa pembaruan",
+ "update.check_unavailable": "Pemeriksaan pembaruan tidak tersedia untuk instalasi ini."
+ },
+ "it": {
+ "update.check_for_updates": "Verifica aggiornamenti",
+ "update.check_unavailable": "La verifica degli aggiornamenti non è disponibile per questa installazione."
+ },
+ "ja": {
+ "update.check_for_updates": "アップデートを確認",
+ "update.check_unavailable": "このインストールではアップデートを確認できません。"
+ },
+ "ko": {
+ "update.check_for_updates": "업데이트 확인",
+ "update.check_unavailable": "이 설치에서는 업데이트를 확인할 수 없습니다."
+ },
+ "ms": {
+ "update.check_for_updates": "Semak kemas kini",
+ "update.check_unavailable": "Semakan kemas kini tidak tersedia untuk pemasangan ini."
+ },
+ "nb": {
+ "update.check_for_updates": "Se etter oppdateringer",
+ "update.check_unavailable": "Søk etter oppdateringer er ikke tilgjengelig for denne installasjonen."
+ },
+ "nl": {
+ "update.check_for_updates": "Controleren op updates",
+ "update.check_unavailable": "Controleren op updates is niet beschikbaar voor deze installatie."
+ },
+ "pl": {
+ "update.check_for_updates": "Sprawdź aktualizacje",
+ "update.check_unavailable": "Sprawdzanie aktualizacji nie jest dostępne dla tej instalacji."
+ },
+ "pt-BR": {
+ "update.check_for_updates": "Verificar atualizações",
+ "update.check_unavailable": "A verificação de atualizações não está disponível para esta instalação."
+ },
+ "ro": {
+ "update.check_for_updates": "Caută actualizări",
+ "update.check_unavailable": "Căutarea actualizărilor nu este disponibilă pentru această instalare."
+ },
+ "ru": {
+ "update.check_for_updates": "Проверить обновления",
+ "update.check_unavailable": "Проверка обновлений недоступна для этой установки."
+ },
+ "sr": {
+ "update.check_for_updates": "Провери ажурирања",
+ "update.check_unavailable": "Провера ажурирања није доступна за ову инсталацију."
+ },
+ "sv": {
+ "update.check_for_updates": "Sök efter uppdateringar",
+ "update.check_unavailable": "Sökning efter uppdateringar är inte tillgänglig för den här installationen."
+ },
+ "tr": {
+ "update.check_for_updates": "Güncellemeleri denetle",
+ "update.check_unavailable": "Bu kurulum için güncelleme denetimi kullanılamıyor."
+ },
+ "uk": {
+ "update.check_for_updates": "Перевірити оновлення",
+ "update.check_unavailable": "Перевірка оновлень недоступна для цього встановлення."
+ },
+ "vi": {
+ "update.check_for_updates": "Kiểm tra bản cập nhật",
+ "update.check_unavailable": "Không thể kiểm tra bản cập nhật cho bản cài đặt này."
+ },
+ "zh": {
+ "update.check_for_updates": "检查更新",
+ "update.check_unavailable": "此安装版本无法检查更新。"
+ },
+ "zh-TW": {
+ "update.check_for_updates": "檢查更新",
+ "update.check_unavailable": "此安裝版本無法檢查更新。"
+ }
+}
diff --git a/crates/ui-egui/src/control.rs b/crates/ui-egui/src/control.rs
index d4e44acb8d..17c43ccbab 100644
--- a/crates/ui-egui/src/control.rs
+++ b/crates/ui-egui/src/control.rs
@@ -32,7 +32,7 @@
//! - `ui.window {action: minimize|maximize|restore|toggle|close}`: what the title bar's buttons do
//! - `ui.confirm {accept?}`: the Delete confirmation (without `accept`: what it lists)
//! - `ui.shortcut {command, key?, slot?, replace?}`: a command's keys, or bind one ("" clears)
-//! - `ui.help {item?: about|shortcuts|report}`: the Help menu; returns the version and diagnostics
+//! - `ui.help {item?: about|updates|shortcuts|report}`: the Help menu; returns the version and diagnostics
//! - `ui.prefs {...}`: the preferences (default_units, nav, zoom_reverse, orbit_around, msaa,
//! length_decimals, angle_decimals); returns them all
//! - `ui.capture {action?: capture|revert|cancel}`: the Capture Position question
@@ -1131,7 +1131,7 @@ fn dispatch(app: &mut SolveApp, ctx: &egui::Context, method: &str, p: &Value) ->
"ui.prefs" => wrap(crate::prefs::control(app, p)),
"ui.agent_chat" => wrap(crate::agent_chat::control(app, ctx, p)),
"ui.help" => match s("item") {
- Some(i @ ("about" | "shortcuts" | "report" | "crashes")) => {
+ Some(i @ ("about" | "updates" | "shortcuts" | "report" | "crashes")) => {
crate::help::run(app, ctx, i);
ok(
json!({"diagnostics": crate::help::diagnostics(app), "version": crate::help::VERSION, "commit": crate::help::COMMIT, "built": crate::help::BUILD_DATE}),
diff --git a/crates/ui-egui/src/help.rs b/crates/ui-egui/src/help.rs
index ea6f7fec25..fbef19384a 100644
--- a/crates/ui-egui/src/help.rs
+++ b/crates/ui-egui/src/help.rs
@@ -44,10 +44,10 @@ pub fn diagnostics(app: &SolveApp) -> String {
/// Whether a Help menu item can run now: behind an open bug report, the items that open a
/// window would cover it (#7188). Report an Issue… shows the report.
pub fn available(app: &SolveApp, item: &str) -> bool {
- app.issue_report.draft.is_none() || !matches!(item, "about" | "shortcuts" | "messages" | "crashes" | "connect")
+ app.issue_report.draft.is_none() || !matches!(item, "about" | "shortcuts" | "messages" | "crashes" | "connect" | "updates")
}
-/// Run a Help menu item: `docs`, `about`, `shortcuts`, `messages`, `report`, `crashes`, `connect`, `install_cli` (macOS).
+/// Run a Help menu item: `docs`, `about`, `updates`, `shortcuts`, `messages`, `report`, `crashes`, `connect`, `install_cli` (macOS).
pub fn run(app: &mut SolveApp, ctx: &egui::Context, item: &str) {
app.help.menu = false;
if !available(app, item) {
@@ -56,6 +56,7 @@ pub fn run(app: &mut SolveApp, ctx: &egui::Context, item: &str) {
match item {
"docs" => ctx.open_url(egui::OpenUrl::new_tab(DOCS_URL)),
"about" => app.help.about = true,
+ "updates" => crate::update::check_now(app, ctx),
"shortcuts" => {
app.keymap.open = true;
app.keymap.read_only = true;
@@ -131,6 +132,7 @@ pub fn show(app: &mut SolveApp, ctx: &egui::Context, anchor: egui::Pos2) {
for (id, label, icon) in [
("docs", "Documentation", "library"),
("about", "About SolidCraft", "help"),
+ ("updates", crate::i18n::tr("update.check_for_updates"), "update"),
("shortcuts", "Keyboard Shortcuts", "list"),
("messages", "Messages…", "list"),
("report", "Report an Issue…", "bug_report"),
diff --git a/crates/ui-egui/src/toolbar.rs b/crates/ui-egui/src/toolbar.rs
index 61501ef356..2e53fd5d54 100644
--- a/crates/ui-egui/src/toolbar.rs
+++ b/crates/ui-egui/src/toolbar.rs
@@ -3334,11 +3334,12 @@ mod header_report_tests {
FileAction::Quit.run(&mut h.app);
assert!(h.app.docs.quitting.is_none() && h.app.docs.closing.is_none());
// Help's windows wait too; Report an Issue… shows the report.
- for item in ["about", "shortcuts", "messages", "crashes", "connect"] {
+ for item in ["about", "shortcuts", "messages", "crashes", "connect", "updates"] {
assert!(!crate::help::available(&h.app, item), "{item}");
crate::help::run(&mut h.app, &h.ctx, item);
}
assert!(!h.app.help.about && !h.app.keymap.open && !h.app.messages.open && h.app.help.connect.is_none());
+ assert!(!h.app.updater.open);
assert!(crate::help::available(&h.app, "report") && crate::help::available(&h.app, "docs"));
h.app.issue_report.draft = None;
assert!(FileAction::Undo.enabled(&h.app) && FileAction::Settings.enabled(&h.app) && FileAction::Quit.enabled(&h.app));
diff --git a/crates/ui-egui/src/update.rs b/crates/ui-egui/src/update.rs
index 16d249fc06..9f27e25c8b 100644
--- a/crates/ui-egui/src/update.rs
+++ b/crates/ui-egui/src/update.rs
@@ -728,10 +728,21 @@ pub fn tick(app: &mut SolveApp, ctx: &egui::Context) {
}
}
-/// Check now (Preferences): ignores the daily interval, not GitHub's rate limit.
+/// Check now (Help or Preferences): show progress and the result, ignoring the daily interval,
+/// but not GitHub's rate limit. A check already in flight serves the manual request too.
pub fn check_now(app: &mut SolveApp, ctx: &egui::Context) {
+ app.updater.open = true;
+ // Keep a download or a completed installation on screen without starting another check.
+ if app.updater.job.is_some() || app.updater.installed.as_ref().is_some_and(Result::is_ok) || !available(app) {
+ return;
+ }
+ if let Some((_, manual)) = &mut app.updater.rx {
+ *manual = true;
+ app.updater.last_manual = unix_now();
+ return;
+ }
let now = unix_now();
- if app.updater.rx.is_some() || now - app.updater.last_manual < MANUAL_COOLDOWN_S || !available(app) {
+ if now - app.updater.last_manual < MANUAL_COOLDOWN_S {
return;
}
if now < app.preferences.update.rate_limited_until {
@@ -773,9 +784,9 @@ fn start(app: &mut SolveApp, ctx: &egui::Context, manual: bool) {
let _ = tx.send(fetch());
ctx.request_repaint();
});
- if spawned.is_err() {
+ if let Err(error) = spawned {
app.updater.rx = None;
- app.updater.status = Status::Idle;
+ app.updater.status = if manual { Status::Failed(error.to_string()) } else { Status::Idle };
}
}
#[cfg(target_arch = "wasm32")]
@@ -801,10 +812,10 @@ fn poll(app: &mut SolveApp) {
let newer = is_newer(&release.tag, current_version());
app.updater.status = if newer { Status::Idle } else { Status::UpToDate };
if newer && manual {
- // Asked for: show it even if it was skipped or put off.
+ // Asked for: offer it even if it was skipped or put off. check_now already
+ // opened the window; don't reopen it if the user closed it while checking.
app.preferences.update.skipped.clear();
app.preferences.update.remind_after = 0.0;
- app.updater.open = true;
}
if app.updater.job.is_none() && app.updater.release.as_ref().is_none_or(|known| !is_newer(&known.tag, &release.tag)) {
app.updater.release = Some(release);
@@ -954,10 +965,14 @@ pub fn show(app: &mut SolveApp, ctx: &egui::Context) {
if !app.updater.open {
return;
}
- let Some(release) = app.updater.release.clone() else {
- app.updater.open = false;
+ if app.updater.job.is_none()
+ && !app.updater.installed.as_ref().is_some_and(Result::is_ok)
+ && (matches!(app.updater.status, Status::Checking | Status::Failed(_)) || offered_or_newer(app).is_none())
+ {
+ show_check_status(app, ctx);
return;
- };
+ }
+ let Some(release) = app.updater.release.clone() else { return };
let kind = app.updater.kind().clone();
let install = install_method(app);
let managed = app.updater.managed_by().map(str::to_string);
@@ -1102,6 +1117,34 @@ pub fn show(app: &mut SolveApp, ctx: &egui::Context) {
}
}
+/// Manual checks also have a visible result when no update can be offered.
+fn show_check_status(app: &mut SolveApp, ctx: &egui::Context) {
+ let (message, warning) = if !available(app) {
+ (crate::i18n::tr("update.check_unavailable").to_string(), false)
+ } else {
+ match &app.updater.status {
+ Status::Checking => (crate::i18n::tr("update.checking").to_string(), false),
+ Status::UpToDate => (crate::i18n::tr("update.up_to_date").to_string(), false),
+ Status::Failed(error) => (crate::i18n::format("update.failed", &[("error", error)]), true),
+ Status::Idle => (crate::i18n::tr("update.check_unavailable").to_string(), false),
+ }
+ };
+ let id = egui::Id::new("sc_update");
+ let (closed, action) = ui_kit::Window::new(id, "update", crate::i18n::tr("update.check_for_updates"))
+ .cards(1.7)
+ .actions("", crate::i18n::tr("ui.close"), None)
+ .show(ctx, true, |ui| {
+ ui_kit::text(ui, &message, ui_kit::Text::Report("check_status", warning));
+ ui_kit::text(ui, &crate::i18n::format("update.you_have", &[("version", current_version())]), ui_kit::Text::Note("have"));
+ });
+ if let Some(area) = ctx.memory(|m| m.area_rect(id)) {
+ crate::scenario::publish_rect("update:window", area);
+ }
+ if closed || action == ui_kit::Action::Cancel {
+ app.updater.open = false;
+ }
+}
+
/// What the Update card shows below the notes.
#[derive(Clone, Copy, PartialEq, Eq)]
enum State {
diff --git a/crates/ui-egui/src/update/tests.rs b/crates/ui-egui/src/update/tests.rs
index 0301405b22..0f2606a465 100644
--- a/crates/ui-egui/src/update/tests.rs
+++ b/crates/ui-egui/src/update/tests.rs
@@ -358,6 +358,149 @@ fn turning_off_automatic_checks_stops_the_launch_check() {
assert!(h.app.updater.release.is_none());
}
+#[test]
+fn help_menu_checks_with_automatic_checks_off_and_offers_installation() {
+ let dir = scratch();
+ let (feed, version) = next_release_feed(&dir.0);
+ let mut h = crate::scenario::Harness::new();
+ h.app.preferences.check_updates = false;
+ h.app.preferences.update.skipped = format!("v{version}");
+ h.app.preferences.update.remind_after = unix_now() + REMIND_DELAY_S;
+ h.app.updater.feed = Some(feed);
+ h.app.updater.kind = Some(InstallKind::MacApp("/Applications/SolidCraft.app".into()));
+ h.app.updater.managed = Some(None);
+ h.app.services.http_get = Some(Arc::new(|_| panic!("the check must use the test feed")));
+ h.app.services.http_download = Some(Arc::new(|_, _, _| panic!("offering an update must not install it")));
+ h.app.help.menu = true;
+ h.frames(2);
+ let [x, y] = h.widget("Check for updates").expect("the Help menu has an update check");
+ h.call("ui.click", json!({"x": x, "y": y}));
+ wait_for_check(&mut h);
+ h.frames(2);
+ assert!(!h.app.help.menu);
+ assert!(h.app.updater.open);
+ assert!(h.app.preferences.update.skipped.is_empty());
+ assert_eq!(h.app.preferences.update.remind_after, 0.0);
+ assert!(h.widget(&format!("SolidCraft {version} is available")).is_some());
+ assert!(h.widget("Download and open").is_some(), "the macOS installation is offered immediately");
+ assert!(h.app.updater.job.is_none());
+}
+
+/// Hold an automatic check at its result channel so the manual request can join it without
+/// a second HTTP request or a wall-clock race.
+fn pending_check() -> (crate::scenario::Harness, std::sync::mpsc::Sender<Result<Release, FetchError>>) {
+ let mut h = crate::scenario::Harness::new();
+ h.app.preferences.check_updates = false;
+ h.app.updater.kind = Some(InstallKind::WindowsMsi);
+ h.app.services.http_get = Some(Arc::new(|_| panic!("do not start a second check")));
+ let (tx, rx) = std::sync::mpsc::channel();
+ h.app.updater.rx = Some((rx, false));
+ h.app.updater.status = Status::Checking;
+ (h, tx)
+}
+
+#[test]
+fn help_check_shows_progress_and_up_to_date_then_closes() {
+ let (mut h, tx) = pending_check();
+ h.call("ui.help", json!({"item": "updates"}));
+ assert!(h.app.updater.open);
+ assert!(h.app.updater.rx.as_ref().unwrap().1, "the in-flight automatic check becomes manual");
+ assert!(h.widget("Checking…").is_some());
+ let release = Release::parse(
+ json!({"tag_name": format!("v{}", comparable(&parse_version(current_version()).unwrap())), "assets": []}).to_string().as_bytes(),
+ )
+ .unwrap();
+ tx.send(Ok(release)).unwrap();
+ h.frames(2);
+ assert_eq!(h.app.updater.status, Status::UpToDate);
+ assert!(h.widget("SolidCraft is up to date.").is_some());
+ assert!(h.widget("Download").is_none() && h.widget("Update now").is_none());
+ let [x, y] = h.widget("Close").unwrap();
+ h.call("ui.click", json!({"x": x, "y": y}));
+ assert!(!h.app.updater.open);
+ // Reopening during the cooldown still shows the result, without another request.
+ h.app.updater.last_manual = unix_now();
+ h.call("ui.help", json!({"item": "updates"}));
+ assert!(h.widget("SolidCraft is up to date.").is_some());
+ assert!(h.app.updater.rx.is_none());
+}
+
+#[test]
+fn help_check_reports_network_errors_and_rate_limits_in_the_window() {
+ for error in [FetchError::Failed("offline".into()), FetchError::RateLimited { retry_after_s: 3600 }] {
+ let (mut h, tx) = pending_check();
+ h.call("ui.help", json!({"item": "updates"}));
+ tx.send(Err(error.clone())).unwrap();
+ h.frames(2);
+ assert_eq!(h.app.updater.status, Status::Failed(error.to_string()));
+ assert!(h.widget(&format!("Couldn't check: {error}")).is_some());
+ assert!(h.widget("SolidCraft is up to date.").is_none());
+ if matches!(error, FetchError::RateLimited { .. }) {
+ h.call("ui.help", json!({"item": "updates"}));
+ assert!(h.app.updater.rx.is_none(), "the server's rate limit is honoured");
+ assert!(matches!(h.app.updater.status, Status::Failed(_)));
+ }
+ }
+}
+
+#[test]
+fn help_check_result_follows_the_selected_language() {
+ let (mut h, tx) = pending_check();
+ h.call("ui.prefs", json!({"language": "de"}));
+ h.call("ui.help", json!({"item": "updates"}));
+ let release = Release::parse(json!({"tag_name": current_version(), "assets": []}).to_string().as_bytes()).unwrap();
+ tx.send(Ok(release)).unwrap();
+ h.frames(2);
+ assert!(h.widget("SolidCraft ist aktuell.").is_some());
+ for (language, title, message) in [
+ ("fr", "Rechercher des mises à jour", "SolidCraft est à jour."),
+ ("ja", "アップデートを確認", "SolidCraft は最新です。"),
+ ("zh-TW", "檢查更新", "SolidCraft 已是最新版本。"),
+ ] {
+ h.call("ui.prefs", json!({"language": language}));
+ assert!(h.widget(title).is_some(), "the window title follows {language}");
+ assert!(h.widget(message).is_some(), "the result follows {language}");
+ assert!(h.widget("SolidCraft is up to date.").is_none());
+ }
+}
+
+#[test]
+fn help_check_explains_when_checks_are_unavailable() {
+ let mut h = crate::scenario::Harness::new();
+ h.app.updater.off = true;
+ h.call("ui.help", json!({"item": "updates"}));
+ assert!(h.widget("Update checks are not available for this installation.").is_some());
+ assert!(h.widget("SolidCraft is up to date.").is_none());
+ assert!(h.app.updater.rx.is_none());
+}
+
+#[test]
+fn closing_a_manual_check_does_not_reopen_it_when_an_update_arrives() {
+ let (mut h, tx) = pending_check();
+ h.call("ui.help", json!({"item": "updates"}));
+ let [x, y] = h.widget("Close").unwrap();
+ h.call("ui.click", json!({"x": x, "y": y}));
+ assert!(!h.app.updater.open);
+ let release = Release::parse(br#"{"tag_name":"v999.0.0","assets":[]}"#).unwrap();
+ tx.send(Ok(release)).unwrap();
+ h.frames(2);
+ assert!(!h.app.updater.open);
+ assert!(offered(&h.app).is_some(), "the update remains available from the title bar");
+}
+
+#[test]
+fn help_check_keeps_an_active_installation_on_screen() {
+ let (mut h, dir) = open_update_window(None);
+ let (_tx, rx) = std::sync::mpsc::channel();
+ h.app.updater.job = Some((rx, Arc::new(install::Progress::default())));
+ h.app.updater.open = false;
+ h.call("ui.help", json!({"item": "updates"}));
+ assert!(h.app.updater.open && h.app.updater.job.is_some());
+ assert!(h.app.updater.rx.is_none());
+ assert!(h.widget("Cancel").is_some());
+ drop(dir);
+}
+
#[test]
fn the_title_bar_offers_the_new_version_and_opens_the_update_window() {
let dir = scratch();
diff --git a/docs/book/src/guide/updates.md b/docs/book/src/guide/updates.md
index 76df4de2eb..96041e4475 100644
--- a/docs/book/src/guide/updates.md
+++ b/docs/book/src/guide/updates.md
@@ -22,6 +22,11 @@ up straight away, and again once a day while it stays open.
**Preferences ▸ General ▸ Updates** has **Check for updates automatically** (on by default) and
**Check now**, which checks right away and shows the window even for a version you skipped.
+**Help ▸ Check for updates** runs the same check, including from the macOS menu bar. The window
+shows progress, offers the installation or download when a newer version exists, or says
+**SolidCraft is up to date.** If the check fails, it shows the error instead. Manual checks work
+even when automatic checks are turned off; builds that cannot check explain that in the window.
+
## Updating in one click
Where SolidCraft can replace itself safely, the window also has **Update now**:
diff --git a/docs/control-protocol.md b/docs/control-protocol.md
index 530e130adc..0a547730eb 100644
--- a/docs/control-protocol.md
+++ b/docs/control-protocol.md
@@ -376,7 +376,7 @@ labels; `prefs:measure_axis_distances` identifies the checkbox.
| `ui.file` | `path`; `insert?`: bool | starts an interactive background Open or Insert; poll `ui.inspect.file_busy` for completion; the window stays responsive |
| `ui.home` | `open?`: bool; `sample?`: index | the start page: show or hide it, open a built-in sample (once built); returns `open` and the recent designs |
| `ui.shortcut` | `command`, `key?`, `slot?`, `replace?` | a command's keys (`key`: the first, shown in menus; `keys`: all), or rebinds it: `key` becomes its only key, or with `slot` replaces its key there (one past the last adds a key, `""` there removes that key); `""` without `slot` clears them; a key another command uses is refused unless `replace` |
-| `ui.help` | `item?`: `about`, `shortcuts` (read only), `report` (opens a report draft for review), `crashes` (the Crash Reports window) | the version, commit, build date and diagnostic text |
+| `ui.help` | `item?`: `about`, `updates` (checks for updates and shows the result), `shortcuts` (read only), `report` (opens a report draft for review), `crashes` (the Crash Reports window) | the version, commit, build date and diagnostic text |
| `ui.prefs` | any of the [`ui.prefs` settings](#uiprefs-settings) below; also `open`, `button` and `stand_up` (listed there) | sets preferences (kept between runs), returns them all plus `dialog` (the open page or null), `apply_enabled` (whether the dialog's Apply has a change to keep), `dark`, `viewport_dark` (whether the 3D view is dark), `stand_up_offer` (the offered bodies, or null), `stand_up_note` (whether that offer is the note), `theme_followed` and `theme_follow_error` |
| `ui.capture` | `action?`: `capture`, `revert`, `cancel` | answers the Capture Position question (asked when a command starts or the design is saved while components were moved without capturing); without `action`, what waits |
| `ui.window` | `action`: minimize, maximize, restore, toggle, close | what the title bar's caption buttons do (on Windows and Linux the application bar is the title bar); close asks about unsaved designs first |