OpenSite/Reference/Commands/Settings commands - Revision history

BathAfrica: Link adjacent OpenSite reference pages in reading order

2026-10-29T21:14:47Z

Link adjacent OpenSite reference pages in reading order

← Older revision		Revision as of 14:14, 29 October 2026
Line 31:		Line 31:
	[[Category:OpenSite documentation]]		[[Category:OpenSite documentation]]

	<div class="os-page-nav">{{Docnav\|OpenSite/~~Getting started~~\|OpenSite/~~Guides~~\|OpenSite/Guides\|All guides}}</div>		<div class="os-page-nav">{{Docnav\|OpenSite/Reference/Commands/Command line\|OpenSite/Reference/Commands/Unit commands\|OpenSite/Guides\|All guides}}</div>

BathAfrica: Reorganize OpenSite reference with shared scope and related workflows

2026-10-29T20:59:37Z

Reorganize OpenSite reference with shared scope and related workflows

← Older revision		Revision as of 13:59, 29 October 2026
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
			{{OpenSite scope}}
	{{BathAfrica Command		{{BathAfrica Command
	\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.
	\|id=cli.settings		\|id=cli.settings
	\|summary=Inspect, change, reset, save, or load a user setting.		\|summary=Inspect, change, reset, save, or load a user setting.
Line 16:		Line 16:
	<code>opensite-cli settings set locale.country FR --file preferences.json</code> writes the user value and prints <code>source=user</code>. <code>settings reset locale.country --file preferences.json</code> prints <code>reset locale.country</code>. The next get on that file prints <code>source=application</code>.		<code>opensite-cli settings set locale.country FR --file preferences.json</code> writes the user value and prints <code>source=user</code>. <code>settings reset locale.country --file preferences.json</code> prints <code>reset locale.country</code>. The next get on that file prints <code>source=application</code>.


			== Try this workflow ==
			[[OpenSite/Guides/Set preferences\|Set preferences]] — a worked lesson with expected results.

	== Documentation basis ==		== Documentation basis ==
Line 27:		Line 30:
	[[OpenSite\|OpenSite overview]] · [[OpenSite/Reference\|Reference]] · [[OpenSite/Guides\|Guides]]		[[OpenSite\|OpenSite overview]] · [[OpenSite/Reference\|Reference]] · [[OpenSite/Guides\|Guides]]
	[[Category:OpenSite documentation]]		[[Category:OpenSite documentation]]

			<div class="os-page-nav">{{Docnav\|OpenSite/Getting started\|OpenSite/Guides\|OpenSite/Guides\|All guides}}</div>

BathAfrica: Use BathAfrica sidebar contents without duplicate inline contents box

2026-10-29T20:11:03Z

Use BathAfrica sidebar contents without duplicate inline contents box

← Older revision		Revision as of 13:11, 29 October 2026
Line 1:		Line 1:
			__NOTOC__
	{{BathAfrica Command		{{BathAfrica Command
	\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.		\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.

BathAfrica: Publish Cursor documentation reconciled with OpenSite source 77c3fee; tests not rerun

2026-10-29T20:06:23Z

Publish Cursor documentation reconciled with OpenSite source 77c3fee; tests not rerun

New page

{{BathAfrica Command
|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.
|id=cli.settings
|summary=Inspect, change, reset, save, or load a user setting.
|milestone=Roadmap phase 3.
|units=The printed value is the setting value. It is not an SI quantity.
|example=opensite-cli settings get locale.country
|python=opensite.execute('settings.get', {'key': 'locale.language'})
|output=Stdout is <code>key=locale.country</code>, <code>value=</code>, and <code>source=application</code> when no file is loaded.
|errors=Exit 0 on success. Exit 1 when the key or file is rejected. Exit 2 when the arguments are not supported.
|limitations=Set and reset write the user scope. Pass <code>--workspace</code> or <code>--document</code> on get to name a context id. The service does not open that workspace or document.
|verification=Repository evidence references (not rerun for this publication): CTest <code>cli.preferences</code>, including a path that contains a space.
}}

<code>opensite-cli settings set locale.country FR --file preferences.json</code> writes the user value and prints <code>source=user</code>. <code>settings reset locale.country --file preferences.json</code> prints <code>reset locale.country</code>. The next get on that file prints <code>source=application</code>.

== Documentation basis ==
Source-reviewed against development commit <code>77c3fee13944bcc4b5d487c77eb1f82fbe4c6ea7</code>, branch <code>feature/phase-13c-properties-python-expressions</code>. This review inspected the implementation and repository evidence; it did not run the Windows application or repeat CTest.

* <code>src/cli/main.cpp</code>
* <code>src/cli/document_commands.cpp</code>
* <code>src/cli/preference_commands.cpp</code>
* <code>src/application/builtins.cpp</code>

[[OpenSite|OpenSite overview]] · [[OpenSite/Reference|Reference]] · [[OpenSite/Guides|Guides]]
[[Category:OpenSite documentation]]