Repository navigation
ds 0.1.9: every directive on a line is read, a ds:claim about= stays expired until someone renews it, and a workspace index missing on this machine no longer stops every command. Fixes issues 5, 6, 7 and 8. If you use about= claims, read Upgrading in the changelog first.
What changed
- Every directive on a line is read. A second
<!-- ds:block … -->on the same line, beside a sentence, or in the next cell of a table row, was dropped without a word; each comment is now read, one directive per comment, and each table cell keeps its own sentence (bug 144). Two directives inside one comment now say so plainly:a second directive in one comment is not read; put each directive in its own comment(bug 148). - Claims keep their baseline until renewed. A
ds:claim about=is measured against the blocks as they were at its last renewal, as a citation is, sods scanno longer clears an expired claim (bug 145). Claims about another workspace repository's blocks now expire, live and undercheck --frozen, andds syncrecords their ids in.ds/foreign.tsv(bug 146). A claim about a deleted or mistyped id isbroken(bug 149), and a new definition of its id, such as anotherenv=, expires it until renewed (bug 152). A renewal records the blocks one by one, so a body-only edit to astability=apiblock after a renewal is no longer reported. - A missing workspace index warns instead of stopping everything. When the index is not on this machine, every command except
ds syncandds publishwarns and reads other repositories' blocks from the committed.ds/foreign.tsv. Without that file such citations are reportedbroken, never passed, andds check --strictexits 1.ds doctorshowsWARNwithforeign.tsvandFAILwithout (bug 147). - Clearer workspace and file errors.
ds doctorshows git's real reason for an unreachable index (bug 150); aworkspacepath that does not exist, or a symlink to a missing folder, is named as a path, not cloned, and a barehost/pathindex is cloned over https (bug 151); an unreadable index entry orforeign.tsvwarns instead of stopping every command or being ignored (bugs 153, 154);ds syncreplaces a corrupt snapshot (bug 155); and a damaged.ds/*.tsvfile comes with what to do about it (bug 156).
To update: ds update (or wait for the daily automatic update). Full list in the changelog; the decisions and their reasons are in SPEC §36.
Install
macOS (Apple silicon) and Linux (amd64, arm64):
curl -fsSL https://raw.githubusercontent.com/ubgo/docsync/main/install.sh | shWindows (amd64, ARM64), in PowerShell:
irm https://raw.githubusercontent.com/ubgo/docsync/main/install.ps1 | iexWith Go 1.26+ and a C compiler:
go install github.com/ubgo/docsync/cli/cmd/[email protected]Every archive holds ds and the six secret-resolver plugins, with a checksums.txt.