OpenSite/Reference/Commands/Set a quantity - Revision history

BathAfrica: Link adjacent OpenSite reference pages in reading order

2026-10-29T21:14:37Z

Link adjacent OpenSite reference pages in reading order

← Older revision		Revision as of 14:14, 29 October 2026
Line 29:		Line 29:
	[[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/Recompute a document\|OpenSite/Reference/Commands/Document commands\|OpenSite/Guides\|All guides}}</div>

BathAfrica: Reorganize OpenSite help: learning paths, examples and chapter navigation

2026-10-29T20:59:18Z

Reorganize OpenSite help: learning paths, examples and chapter navigation

← 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.document.set		\|id=cli.document.set
	\|summary=Change one quantity through <code>opensite.document.set_quantity</code>, recompute, and save.		\|summary=Change one quantity through <code>opensite.document.set_quantity</code>, recompute, and save.
Line 14:		Line 14:
	}}		}}


			== Try this workflow ==
			[[OpenSite/Guides/Quantities and profiles\|Quantities and profiles]] — a worked lesson with expected results.

	== Documentation basis ==		== Documentation basis ==
Line 25:		Line 28:
	[[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:10:34Z

Use BathAfrica sidebar contents without duplicate inline contents box

← Older revision		Revision as of 13:10, 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:05:54Z

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.document.set
|summary=Change one quantity through <code>opensite.document.set_quantity</code>, recompute, and save.
|milestone=Roadmap phase 1 (historical Phase 1).
|units=The command interprets <code>--value</code> in <code>--unit</code> and stores the canonical SI quantity. The unit id must already be registered.
|example=opensite-cli document set section.osdoc --property width --value 0.25 --unit m
|python=<code>examples/python/document_edit.py</code> calls <code>document.set_quantity</code> with a <code>QuantityArgument</code> built from <code>parse_quantity('250 mm')</code>.
|output=Stdout is the inspected document after the save. Width 0.25 m and height 0.60 m give area 0.15 m².
|errors=A <code>--value</code> or <code>--object</code> that does not consume the whole argument exits 2 and reports that an argument is not a valid number. That includes a trailing suffix, a negative or out-of-range object id, and a non-finite quantity such as <code>inf</code> or <code>nan</code>. Decimal and scientific forms such as <code>4e-1</code> are accepted. The decimal mark is <code>.</code>. The check does not use the machine locale. Exit 2 does not modify the file. A missing required flag exits 2. A rejected edit exits 1 with the status message. An allocation or execution failure exits 1 with its own message.
|limitations=If the file has exactly one object, <code>--object</code> may be omitted. An object id is an integer from 1 through 9007199254740991. Derived properties cannot be edited. This does not switch the unit-preference profile.
|verification=Repository evidence references (not rerun for this publication): CTest <code>cli.document</code>, including <code>--value abc</code>, <code>0.25m</code>, <code>inf</code>, a negative object id, an oversized object id, an unchanged file after those rejections, and <code>--value 4e-1</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]]