https://gitlab.synchro.net/main/sbbs/-/commit/58dc4d2b39ca0c227d5427aa
Modified Files:
docs/v322_new.md src/sbbs3/js_global.cpp src/xpdev/ini_file.h
Log Message:
Correct the .local rationale: ctrl/ is not overwritten by an upgrade

The commit that added the .local filename variation justified it as protecting a sysop's edits from being overwritten by an upgrade. That is not true of the ctrl directory, which is where most of the configuration files it applies to live: ctrl is populated when the BBS is installed and an upgrade leaves it alone. The Windows upgrade script copies exactly one file into it, text.dat.

What an upgrade does refresh is the distributed program directories -- exec, text and docs unconditionally, and xtrn when the sysop accepts the installer's "Upgrade Externals" option -- so the overwrite argument holds for a file we ship in one of those, and for any installation run from a source checkout, where updating means pulling the whole tree.

The variation is still worth having for a ctrl file; the honest reason is separation rather than rescue. Reworded accordingly on the wiki (config:ini_files, howto:multihost) and in the release notes, where the claim was made. xpdev is a general-purpose library, so its header documents the search order and what .local means and leaves the rationale to those.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
--- SBBSecho 3.37-Linux
* Origin: Vertrauen - [vert/cvs/bbs].synchro.net (1:103/705)