aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md20
1 files changed, 15 insertions, 5 deletions
diff --git a/README.md b/README.md
index 938dbc6..652bcae 100644
--- a/README.md
+++ b/README.md
@@ -67,8 +67,8 @@ Wayland the compositor may still pick the window size).
sb-builder
-The window has five tabs, always open: Dashboard, Packages, Hints, Results,
-Jobs (Ctrl+PgUp/PgDn cycle them). The ribbon at the top holds the current
+The window has six tabs, always open: Dashboard, Packages, Hints, Results,
+Repository, Jobs (Ctrl+PgUp/PgDn cycle them). The ribbon at the top holds the current
tab's actions, in the order a task uses them; the smaller bar under it holds
its view controls (select, clear, refresh). An action that does not apply is
greyed out, its tooltip says why. Actions act on the **ticked** rows: a click
@@ -86,9 +86,13 @@ reopens it.
build results, last overlay pull, SBo orphans, recent jobs. Refreshes while
visible. The tiles open Packages (the orphans tile with only the orphaned
filter on), Results (one result kind) and Jobs.
-- **Packages**: every package of the repository, with built version and
- status (`ok`, `failed`, `never`, `outdated`). Search by name or summary, or
- with `cat:`, `maint:`, `req:`, `status:`; toggle the overlay and status
+- **Packages**: every package of the repository, with built version, hint
+ and status (`ok`, `failed`, `never`, `outdated`, `newer`: built newer than
+ the target, e.g. after a pin left its hint, so Update would downgrade). The
+ hint column says what the hint does: `pin` (sets `VERSION`), `deps` (only
+ `DELREQUIRES`/`ADDREQUIRES`), `skip`, `other`. Search by name or summary,
+ or with `cat:`, `maint:`, `req:`, `status:`, `hint:` (`hint:none` for no
+ hint); toggle the overlay and status
chips, and **orphaned** for the packages SBo lists without a maintainer.
The detail pane shows the package's versions, its dependencies after
hints (dropped ones struck through), what its hint file does, and a link
@@ -120,6 +124,12 @@ reopens it.
the log of the package's last attempt (slackrepo keeps one per command:
`build.log`, `update.log`, `rebuild.log`, `remove.log`), where it reports
the failure, with its `resource.log` (load, memory, tmp over the build).
+- **Repository**: the packages slackrepo built, read from the local mount of
+ its package repository (`[repository] path`, default `/repo`; no VM
+ needed). A stats line (count, size, per overlay, unpublished, last
+ publish), search by name or description, overlay and `unpublished` chips;
+ the detail pane shows the description, sizes and the package's ChangeLog
+ entries, with a link to it in Packages.
- **Jobs**: every job with its live log. **Pull overlay** (`sbpull <overlay>`)
and **Check shadowing** (`sbshadow`) run as previews; when one finds
`shadow:` or `unshadow:` lines, its dialog offers **Apply shadowing**.