branch='trunk'
if ! command -v git >/dev/null 2>&1; then
echo 'byggsteg: git is not on this deployment PATH, so the clone cannot be updated' >&2
exit 1
fi
if ! cd "$dir"; then
echo "byggsteg: cannot enter the clone $dir" >&2
exit 1
fi
root=$(git rev-parse --show-toplevel 2>/dev/null)
if [ "$root" != "$(pwd -P)" ]; then
echo "byggsteg: $dir is not a git checkout; remove it and the next run clones it again" >&2
exit 1
fi
if ! origin=$(git remote get-url origin 2>/dev/null); then
echo "byggsteg: $dir has no origin remote to fetch $branch from" >&2
exit 1
fi
before=$(git rev-parse --short HEAD 2>/dev/null) || before=none
attempt=1
while :; do
if GIT_TERMINAL_PROMPT=0 git fetch --quiet origin "+refs/heads/$branch:refs/remotes/origin/$branch"; then
break
fi
if [ "$attempt" -ge 3 ]; then
echo "byggsteg: could not fetch $branch from $origin after 3 attempts; is the branch still there, and is the remote reachable?" >&2
exit 1
fi
echo "byggsteg: fetching $branch from $origin failed; retrying in $((attempt * 2))s" >&2
sleep $((attempt * 2))
attempt=$((attempt + 1))
done
if ! git checkout --quiet --force -B "$branch" FETCH_HEAD; then
echo "byggsteg: fetched $branch from $origin but could not check it out" >&2
exit 1
fi
after=$(git rev-parse --short HEAD)
if [ "$before" = "$after" ]; then
echo "byggsteg: $branch was already at $after"
else
echo "byggsteg: $branch moved from $before to $after"
fi
byggsteg: trunk was already at 85ffcd1
setupuname -a✓ succeeded1 lines · 0.0s
Linux wolk-jjba 7.2.11-gnu #1 SMP PREEMPT_DYNAMIC 1 x86_64 GNU/Linux
commit 85ffcd1392a86e2f76d27b147657029177b6b6f3
Author: Josep Bigorra <jjbigorra@gmail.com>
Date: Tue Nov 17 15:46:26 2026 +0100
chore(release): v0.6.2, document every definition
Regenerates the API reference from the new docstrings, taken from the diff
docs-check reported.
M CHANGELOG.org
M README.org
M manual/api/index.texi
M manual/main.texi
M src/dokgen/cli.scm
M website/index.html
deploysudo maak deploy✓ succeeded87 lines · 0.9s
--------------------------------------------------------------
Maak 0.14.0: the infinitely extensible command runner
Loading tasks from Maak file: /etc/byggsteg/job-clone/guile-dokgen/trunk/maak.scm
Executing Maak tasks: deploy
--------------------------------------------------------------
=> Running Maak task: deploy
Build the manual and publish it, with the project page, to the web directory.
Deployment is a copy, the way the rest of jointhefreeworld.org is deployed: the
directory is emptied and the fresh build is put in its place, so a file this
build does not have does not linger beside the one that replaced it. The build
is removed afterwards; what the tree keeps is the source.
channels.scm:17:6: warning: channel 'jointhefreeworld' is not trusted
manual/api/index.texi:85: warning: @end should only appear at the beginning of a line
manual/api/index.texi:399: warning: @end should only appear at the beginning of a line
Execute command:
guix time-machine --channels=channels.scm -- shell -m manifest.scm -- makeinfo --html --css-ref=https://jointhefreeworld.org/static/css/jointhefreeworld.css -c SHOW_TITLE=true -o reports/manual manual/main.texi
Executing: guix time-machine --channels=channels.scm -- shell -m manifest.scm -- makeinfo --html --css-ref=https://jointhefreeworld.org/static/css/jointhefreeworld.css -c SHOW_TITLE=true -o reports/manual manual/main.texi
open file:///etc/byggsteg/job-clone/guile-dokgen/trunk/reports/manual/index.html
publishing the page and the manual to /srv/http/jointhefreeworld.org/dokgenremoved '/srv/http/jointhefreeworld.org/dokgen/img/icon.svg'
removed '/srv/http/jointhefreeworld.org/dokgen/img/logo.svg'
removed directory '/srv/http/jointhefreeworld.org/dokgen/img'
removed '/srv/http/jointhefreeworld.org/dokgen/style.css'
removed '/srv/http/jointhefreeworld.org/dokgen/index.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/index.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/Usage.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/CLI.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/API.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005fcli.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005fcommands.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005fdata.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005fexceptions.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005ftemplates_005fstexi.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005futils.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005fwriter.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/Version-History.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/Copying-Information.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/Concept-Index.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/Data-Type-Index.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/Procedure-Index.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/Variable-Index.html'
removed '/srv/http/jointhefreeworld.org/dokgen/manual/cli_002dapi.html'
removed directory '/srv/http/jointhefreeworld.org/dokgen/manual'
removed directory '/srv/http/jointhefreeworld.org/dokgen'
'website' -> '/srv/http/jointhefreeworld.org/dokgen'
'website/img' -> '/srv/http/jointhefreeworld.org/dokgen/img'
'website/img/icon.svg' -> '/srv/http/jointhefreeworld.org/dokgen/img/icon.svg'
'website/img/logo.svg' -> '/srv/http/jointhefreeworld.org/dokgen/img/logo.svg'
'website/style.css' -> '/srv/http/jointhefreeworld.org/dokgen/style.css'
'website/index.html' -> '/srv/http/jointhefreeworld.org/dokgen/index.html'
'reports/manual' -> '/srv/http/jointhefreeworld.org/dokgen/manual'
'reports/manual/index.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/index.html'
'reports/manual/Usage.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/Usage.html'
'reports/manual/CLI.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/CLI.html'
'reports/manual/API.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/API.html'
'reports/manual/dokgen_005fcli.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005fcli.html'
'reports/manual/dokgen_005fcommands.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005fcommands.html'
'reports/manual/dokgen_005fdata.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005fdata.html'
'reports/manual/dokgen_005fexceptions.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005fexceptions.html'
'reports/manual/dokgen_005ftemplates_005fstexi.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005ftemplates_005fstexi.html'
'reports/manual/dokgen_005futils.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005futils.html'
'reports/manual/dokgen_005fwriter.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/dokgen_005fwriter.html'
'reports/manual/Version-History.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/Version-History.html'
'reports/manual/Copying-Information.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/Copying-Information.html'
'reports/manual/Concept-Index.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/Concept-Index.html'
'reports/manual/Data-Type-Index.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/Data-Type-Index.html'
'reports/manual/Procedure-Index.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/Procedure-Index.html'
'reports/manual/Variable-Index.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/Variable-Index.html'
'reports/manual/cli_002dapi.html' -> '/srv/http/jointhefreeworld.org/dokgen/manual/cli_002dapi.html'
removed 'reports/manual/index.html'
removed 'reports/manual/Usage.html'
removed 'reports/manual/CLI.html'
removed 'reports/manual/API.html'
removed 'reports/manual/dokgen_005fcli.html'
removed 'reports/manual/dokgen_005fcommands.html'
removed 'reports/manual/dokgen_005fdata.html'
removed 'reports/manual/dokgen_005fexceptions.html'
removed 'reports/manual/dokgen_005ftemplates_005fstexi.html'
removed 'reports/manual/dokgen_005futils.html'
removed 'reports/manual/dokgen_005fwriter.html'
removed 'reports/manual/Version-History.html'
removed 'reports/manual/Copying-Information.html'
removed 'reports/manual/Concept-Index.html'
removed 'reports/manual/Data-Type-Index.html'
removed 'reports/manual/Procedure-Index.html'
removed 'reports/manual/Variable-Index.html'
removed 'reports/manual/cli_002dapi.html'
removed directory 'reports/manual'