> For the complete documentation index, see [llms.txt](https://docs.pkgforge.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pkgforge.dev/sbuild/specification/1.shebang.md).

# 1.Shebang

```yaml
#!/SBUILD ver @v1.0.0
_disabled: false
_rolling: false
```

## Fields

### `#!/SBUILD ver @${VERSION}`

Version assertion for the linter/runner. (**TYPE**: <mark style="color:green;">**`RECOMMENDED`**</mark>)

### `_disabled`

Disable the script. (**TYPE**: <mark style="color:red;">**`ENFORCED`**</mark>)

* `false` - Script is enabled (default)
* `true` - Script is disabled

When disabled, specify a reason:

```yaml
_disabled: true
_disabled_reason:
  abandoned:
    - date: "2024-12-31"
      reason: "No longer maintained"
```

Reason types: `abandoned`, `broken`, `deprecated`, `dmca`, `insecure`, `replaced`

### `_rolling`

Mark as rolling release for periodic rebuilds. (**TYPE**: <mark style="color:blue;">**`NON_ENFORCED`**</mark>)

```yaml
_rolling: true
x_exec:
  pkgver: |
    echo "nightly-$(date +%Y%m%d)"
```

Used for packages without versioned releases (nightly builds, git HEAD, etc.).