diff options
| author | Danilo M. <danix@danix.xyz> | 2026-07-30 19:19:38 +0200 |
|---|---|---|
| committer | Danilo M. <danix@danix.xyz> | 2026-07-30 19:19:38 +0200 |
| commit | 8db910ffaf162b1394764b3f523dcdbc37c7e0f4 (patch) | |
| tree | bb6b404bf4069758a0d8059aa502c9420b141685 | |
| parent | efaeeae0b5c06035fce5993ea5d1c6738988b408 (diff) | |
| download | my-slackbuilds-8db910ffaf162b1394764b3f523dcdbc37c7e0f4.tar.gz my-slackbuilds-8db910ffaf162b1394764b3f523dcdbc37c7e0f4.zip | |
CLAUDE.md: document the local SBo template clones
Record that ~/Templates/SlackBuilds/ holds the official SBo templates,
that update-templates.sh refreshes them, and that they are the starting
point for new SlackBuilds and SBo maintenance takeovers.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
| -rw-r--r-- | CLAUDE.md | 30 |
1 files changed, 30 insertions, 0 deletions
@@ -37,6 +37,36 @@ repo as a subtree, and a top-level `docs/` folder leaks into that subtree. ## SlackBuild Scripting Guidelines +### Templates live in `~/Templates/SlackBuilds/` + +The official SBo templates are kept locally as a git clone at +`~/Templates/SlackBuilds/sbo/` (a second clone, `conraid/`, holds Conraid's +scripts for reference). Both are refreshed by +`~/Templates/SlackBuilds/update-templates.sh`, which pulls each clone; run it to +get the latest upstream templates before starting work. + +**Always start from these templates** when authoring a NEW SlackBuild, or when +taking over maintenance of an existing script on SBo. Read the matching template +first, do not copy an existing package from this repo and rename it, an old +package can carry drift the current template has since fixed. + +Pick by build system: + +| Template | Use for | +|----------|---------| +| `sbo/python-template.SlackBuild` | Python packages (setup.py and pyproject-only paths) | +| `sbo/autotools-template.SlackBuild` | `./configure && make` | +| `sbo/cmake-template.SlackBuild` | CMake | +| `sbo/meson-template.SlackBuild` | Meson | +| `sbo/perl-template.SlackBuild` | Perl modules | +| `sbo/rubygem-template.SlackBuild` | Ruby gems | +| `sbo/haskell-template.SlackBuild` | Haskell | +| `sbo/template.info`, `sbo/slack-desc`, `sbo/README`, `sbo/doinst.sh`, `sbo/douninst.sh` | the other package files | + +Strip the template's instructional comment blocks and unused branches (e.g. the +python2/setup.py path, the man-page gzip block when upstream ships no man pages) +before shipping the script. + - Follow the [SBo template](https://slackbuilds.org/templates/) as the base for all scripts - Use `set -e` to abort on errors - Honor `$TMP`, `$BUILD`, `$TAG`, `$OUTPUT` variables; default values must be set if unset |