From d20c06ce0edcc45fa1028b206f2bcb35d0052fc8 Mon Sep 17 00:00:00 2001 From: MickLesk Date: Sat, 15 Aug 2026 23:26:30 +0200 Subject: [PATCH] change comments for new variant Update `_deploy_source_tarball` and related helper comments to note that CLEAN_INSTALL wipes target contents including dotfiles while preserving mount points. This improves guidance around backup/restore of config dotfiles during source deployments. --- misc/tools.func | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/misc/tools.func b/misc/tools.func index 5394a78a0..109e87e5f 100644 --- a/misc/tools.func +++ b/misc/tools.func @@ -2528,9 +2528,9 @@ _download_source_tarball() { # directory). Extracts into , then copies the contents # of that top-level directory into . # -# - Honors CLEAN_INSTALL=1 (wipes first, dotfiles included — back -# up config dotfiles like .env via create_backup and call restore_backup -# BEFORE any build step that sources them). +# - Honors CLEAN_INSTALL=1 (wipes first, dotfiles included, mount +# points preserved — back up config dotfiles like .env via create_backup +# and call restore_backup BEFORE any build step that sources them). # - Does NOT own : the caller creates it and is responsible for its # cleanup (typically via a RETURN trap on its tmpdir). # - cp failures are non-fatal here, matching the previous inline behavior. @@ -2568,9 +2568,9 @@ _deploy_source_tarball() { # a single top-level directory, that directory is stripped (its contents land # directly in ); otherwise the archive contents are copied as-is. # -# - Honors CLEAN_INSTALL=1 (wipes first, dotfiles included — back -# up config dotfiles like .env via create_backup and call restore_backup -# BEFORE any build step that sources them). +# - Honors CLEAN_INSTALL=1 (wipes first, dotfiles included, mount +# points preserved — back up config dotfiles like .env via create_backup +# and call restore_backup BEFORE any build step that sources them). # - Does NOT own : the caller creates it and cleans it up. # # Returns: 0 on success, 65 on unsupported format, 251 on extraction failure,