slipway 0.1.0

data/man/man1/slipway-delete.1

@@ -0,0 +1,46 @@
+.\" Generated by slipway 0.1.0. Do not edit.
+.TH "SLIPWAY-DELETE" "1" "2026-09-30" "slipway 0.1.0" "Slipway Manual"
+.SH NAME
+slipway\-delete \- Delete resources by type and name
+.SH SYNOPSIS
+.SY "slipway delete"
+.I "(TYPE NAME... | TYPE/NAME...)"\&
+.RI [ flags ]
+.YS
+.SH DESCRIPTION
+Delete resources by type and name.
+.PP
+Every name is resolved before anything is deleted, so a name that does not exist leaves the others untouched unless \-\-ignore\-not\-found is set. Deleting a group also deletes the registrations of its projects; the default group cannot be deleted.
+.PP
+Deleting a project removes its registration only. The repository on disk is not touched.
+.PP
+Resource types: projects (project, proj) and groups (group). Type words are case\-insensitive.
+.SH OPTIONS
+.TP
+\fB\-\-dry\-run\fR
+Print what would change and write nothing.
+.TP
+\fB\-\-ignore\-not\-found\fR
+Treat "resource not found" as a successful delete.
+.SH EXAMPLES
+.EX
+# Delete a project from the current group
+slipway delete project hldr
+.EE
+.PP
+.EX
+# Delete two projects from the work group
+slipway delete projects api web \-n work
+.EE
+.PP
+.EX
+# Delete a group and the registrations of its projects
+slipway delete group work
+.EE
+.PP
+.EX
+# Delete a project if it exists, quietly otherwise
+slipway delete project hldr \-\-ignore\-not\-found
+.EE
+.SH "SEE ALSO"
+.BR slipway (1)

data/man/man1/slipway-describe.1

@@ -0,0 +1,95 @@
+.\" Generated by slipway 0.1.0. Do not edit.
+.TH "SLIPWAY-DESCRIBE" "1" "2026-09-30" "slipway 0.1.0" "Slipway Manual"
+.SH NAME
+slipway\-describe \- Show details of one or many resources
+.SH SYNOPSIS
+.SY "slipway describe"
+.I "(TYPE [NAME...] | TYPE/NAME...)"\&
+.RI [ flags ]
+.YS
+.SH DESCRIPTION
+Show details of one or many resources.
+.PP
+Print a detailed description of the selected resources, including the state of the repository at the registered path and where it differs from the manifest. You may select a single object by name, all objects of that type, or use a label or field selector.
+.PP
+Status is one of the words listed below. Last Fetch reads <never> when git answered and no fetch is on record, and a field with no value reads <none>. When git cannot read the repository, the Repository block holds git's reason instead of the fields.
+.PP
+Resource types: projects (project, proj) and groups (group). Type words are case\-insensitive.
+.SH OPTIONS
+.TP
+\fB\-l\fR, \fB\-\-selector\fR \fIEXPR\fR
+Selector (label query) to filter on, supports '=', '==', '!=', 'in', 'notin' (e.g. \-l key1=value1,key2=value2,key3 in (value3)). Matching objects must satisfy all of the specified label constraints.
+.TP
+\fB\-\-field\-selector\fR \fIEXPR\fR
+Selector (field query) to filter on, supports '=', '==', and '!=' (e.g. \-\-field\-selector key1=value1,key2=value2). Projects support metadata.name, metadata.group, spec.path, status.state, status.branch, status.lastFetch; groups support metadata.name. Values compare exactly, case included, with the object \-o json prints: spec.path as registered, status.lastFetch as an RFC 3339 time. A field the object leaves out compares as the empty value, except status.lastFetch, which compares as never. A backslash escapes a backslash, a comma or an equals sign in a value.
+.TP
+\fB\-A\fR, \fB\-\-all\-groups\fR
+If present, list the requested object(s) across all groups. The group in the current configuration is ignored even if specified with \-\-group.
+.SH "STATUS WORDS"
+STATUS is the first of these words that holds, in this order.
+.TP
+\fBMissing\fR
+The registered path is relative, or is not a directory on this machine.
+.TP
+\fBNotARepo\fR
+The directory exists but no repository contains it.
+.TP
+\fBUnsafe\fR
+git refused the repository because another user owns it (safe.directory); describe, diff and fetch print the git command that trusts it.
+.TP
+\fBConflicted\fR
+The working tree has unmerged paths.
+.TP
+\fBDetached\fR
+HEAD points at a commit rather than a branch.
+.TP
+\fBUnborn\fR
+The branch has no commits yet.
+.TP
+\fBDirty\fR
+Staged, modified or untracked files are present.
+.TP
+\fBGone\fR
+An upstream is configured but its remote\-tracking ref is gone, as of the last fetch \-\-prune (or a fetch with fetch.prune set).
+.TP
+\fBDiverged\fR
+The branch is both ahead of and behind its upstream, as of the last fetch (FETCHED).
+.TP
+\fBAhead\fR
+Commits not yet pushed to the upstream, as of the last fetch (FETCHED).
+.TP
+\fBBehind\fR
+Commits on the upstream not yet pulled, as of the last fetch (FETCHED).
+.TP
+\fBClean\fR
+Nothing to do.
+.TP
+\fBUnknown\fR
+git could not answer: it is not installed, it did not finish within 10 seconds, or it failed for a reason slipway does not classify. Each distinct reason is printed once on stderr per run.
+.SH EXAMPLES
+.EX
+# Describe a project
+slipway describe project hldr
+.EE
+.PP
+.EX
+# Describe every project in the work group
+slipway describe projects \-n work
+.EE
+.PP
+.EX
+# Describe the projects labeled lang=rust
+slipway describe projects \-l lang=rust
+.EE
+.PP
+.EX
+# Describe the projects on the main branch
+slipway describe projects \-\-field\-selector status.branch=main
+.EE
+.PP
+.EX
+# Describe a group
+slipway describe group work
+.EE
+.SH "SEE ALSO"
+.BR slipway (1)

data/man/man1/slipway-diff.1

@@ -0,0 +1,120 @@
+.\" Generated by slipway 0.1.0. Do not edit.
+.TH "SLIPWAY-DIFF" "1" "2026-09-30" "slipway 0.1.0" "Slipway Manual"
+.SH NAME
+slipway\-diff \- Show where projects differ from their manifests
+.SH SYNOPSIS
+.SY "slipway diff"
+.I "[NAME... | project/NAME...]"\&
+.RI [ flags ]
+.YS
+.SH DESCRIPTION
+Show where each selected project differs from its manifest.
+.PP
+Compares every project of the current group, the projects named, the ones a label selector matches, or with \-\-all\-groups every project, with its manifest. Each project that differs prints its name and one line per difference: Missing, Remote, Branch, Revision or Behind, then the blocker that keeps sync from fast\-forwarding the branch, if any. A line is followed by the git command that shows or resolves it when there is one; slipway never runs it. A project that matches its manifest prints nothing.
+.PP
+The repositories are read as they are on disk: diff contacts no remote and writes nothing, so Behind is as of the last fetch, which slipway fetch refreshes. A project pinned by spec.revision is compared with that commit instead of its upstream, and is blocked when the repository lacks the commit, HEAD is past it or its upstream does not hold it. A paused or FetchOnly project shows a blocker only when git cannot read its repository.
+.SH OPTIONS
+.TP
+\fB\-l\fR, \fB\-\-selector\fR \fIEXPR\fR
+Selector (label query) to filter on, supports '=', '==', '!=', 'in', 'notin' (e.g. \-l key1=value1,key2=value2,key3 in (value3)). Matching objects must satisfy all of the specified label constraints.
+.TP
+\fB\-A\fR, \fB\-\-all\-groups\fR
+If present, compare every project across all groups with its manifest. The group in the current configuration is ignored even if specified with \-\-group.
+.SH DRIFT
+.TP
+\fBMissing\fR
+The registered path is relative or is not a directory. For a path that is not a directory, a project with spec.remote shows the git clone command that recreates it.
+.TP
+\fBRemote\fR
+origin is absent or differs from spec.remote. Sync never changes a remote.
+.TP
+\fBBranch\fR
+HEAD is detached or on another branch than spec.branch. Sync never switches branches.
+.TP
+\fBRevision\fR
+HEAD is not the commit spec.revision pins. The pin replaces the upstream, so a pinned project is never Behind; under FastForward sync will fast\-forward a branch behind the pin to it unless a blocker stops it, and never moves a branch back.
+.TP
+\fBBehind\fR
+The checked\-out branch is behind its upstream. Under FastForward sync will fast\-forward it unless a blocker stops it; under FetchOnly, or while spec.paused is true, it is only reported.
+.SH BLOCKERS
+A blocker says why the checked\-out branch cannot be fast\-forwarded, onto its upstream or, for a project pinned by spec.revision, onto the pin. The first three mean git could not read the repository and apply to every project; the others apply only under FastForward to a project that is not paused, and RevisionNotFound, PastRevision and OffUpstream only to a pinned one.
+.TP
+\fBNotARepo\fR
+The directory exists but holds no repository.
+.TP
+\fBUnsafe\fR
+git refused the repository because another user owns it (safe.directory); the git command that trusts it follows.
+.TP
+\fBUnknown\fR
+git could not answer; the reason is also printed once on stderr.
+.TP
+\fBDetached\fR
+HEAD points at a commit rather than a branch.
+.TP
+\fBUnborn\fR
+The branch has no commits yet.
+.TP
+\fBGone\fR
+The upstream is configured but its ref no longer exists.
+.TP
+\fBNoUpstream\fR
+The branch tracks no upstream.
+.TP
+\fBRevisionNotFound\fR
+The repository has no commit by the name spec.revision pins.
+.TP
+\fBPastRevision\fR
+HEAD is past the pinned commit or on another line of history, so reaching the pin would move the branch back.
+.TP
+\fBOffUpstream\fR
+The upstream does not hold the pinned commit, which may be on another branch or a fork; sync moves a branch only along its upstream.
+.TP
+\fBConflicted\fR
+The branch is behind and the working tree has unmerged paths.
+.TP
+\fBDirty\fR
+The branch is behind and has staged or unstaged changes; untracked files do not block.
+.TP
+\fBDiverged\fR
+The branch is behind and has commits of its own.
+.TP
+\fBInProgress\fR
+The branch would be fast\-forwarded, but a merge, rebase, cherry\-pick, revert, bisect or git am is in progress.
+.SH "EXIT STATUS"
+.TP
+\fB0\fR
+Every selected project matches its manifest.
+.TP
+\fB1\fR
+Runtime error, such as a missing resource or an unreadable manifest, or a project whose state is Unknown because git failed or did not finish.
+.TP
+\fB2\fR
+Usage error: unknown command, unknown flag or invalid argument.
+.TP
+\fB3\fR
+At least one selected project differs from its manifest or is blocked, including a directory that holds no repository (NotARepo) and a repository git refuses (Unsafe).
+.TP
+\fB130\fR
+Interrupted by SIGINT.
+.SH EXAMPLES
+.EX
+# Show where the projects of the current group differ from their manifests
+slipway diff
+.EE
+.PP
+.EX
+# Show every project that differs, in every group
+slipway diff \-A
+.EE
+.PP
+.EX
+# Compare two projects of the work group
+slipway diff api web \-n work
+.EE
+.PP
+.EX
+# Compare the projects labeled lang=rust
+slipway diff \-l lang=rust
+.EE
+.SH "SEE ALSO"
+.BR slipway (1)

data/man/man1/slipway-edit.1

@@ -0,0 +1,34 @@
+.\" Generated by slipway 0.1.0. Do not edit.
+.TH "SLIPWAY-EDIT" "1" "2026-09-30" "slipway 0.1.0" "Slipway Manual"
+.SH NAME
+slipway\-edit \- Edit a resource from the default editor
+.SH SYNOPSIS
+.SY "slipway edit"
+.I "(TYPE NAME | TYPE/NAME)"\&
+.RI [ flags ]
+.YS
+.SH DESCRIPTION
+Edit a resource from the default editor.
+.PP
+The edit command allows you to directly edit any resource in the registry. It will open the editor named by the SLIPWAY_EDITOR environment variable, then the editor key of the configuration file, then VISUAL or EDITOR, or fall back to 'vi'.
+.PP
+The kind, name, group and creation timestamp of a resource cannot be changed. If an error occurs while saving, the file is reopened with the relevant failures as comments at the top; saving it again without changes cancels the edit.
+.PP
+Resource types: projects (project, proj) and groups (group). Type words are case\-insensitive.
+.SH EXAMPLES
+.EX
+# Edit the project named 'hldr'
+slipway edit project hldr
+.EE
+.PP
+.EX
+# Edit a project in the work group
+slipway edit project job \-n work
+.EE
+.PP
+.EX
+# Edit the group named 'work'
+slipway edit group work
+.EE
+.SH "SEE ALSO"
+.BR slipway (1)

data/man/man1/slipway-explain.1

@@ -0,0 +1,36 @@
+.\" Generated by slipway 0.1.0. Do not edit.
+.TH "SLIPWAY-EXPLAIN" "1" "2026-09-30" "slipway 0.1.0" "Slipway Manual"
+.SH NAME
+slipway\-explain \- Get documentation for a resource
+.SH SYNOPSIS
+.SY "slipway explain"
+.I TYPE[.FIELD...]\&
+.RI [ flags ]
+.YS
+.SH DESCRIPTION
+Describe fields and structure of the resource types.
+.PP
+This command describes the fields of each resource type, as a manifest holds them. Fields are identified by a dotted path after the type word, such as project.spec.syncPolicy. Each field shows its type, \-required\- when a manifest must have it, and a description with the rule its value follows and its default; \-\-recursive prints the whole tree of names and types instead.
+.PP
+Resource types: projects (project, proj) and groups (group). Type words are case\-insensitive. Field names are case\-sensitive, as in a manifest.
+.SH OPTIONS
+.TP
+\fB\-\-recursive\fR
+If present, print the name of all the fields recursively. Otherwise, print the available fields with their description.
+.SH EXAMPLES
+.EX
+# Get the documentation of the resource and its fields
+slipway explain projects
+.EE
+.PP
+.EX
+# Get all the fields in the resource
+slipway explain projects \-\-recursive
+.EE
+.PP
+.EX
+# Get the documentation of a specific field of a resource
+slipway explain project.spec.syncPolicy
+.EE
+.SH "SEE ALSO"
+.BR slipway (1)

data/man/man1/slipway-fetch.1

@@ -0,0 +1,77 @@
+.\" Generated by slipway 0.1.0. Do not edit.
+.TH "SLIPWAY-FETCH" "1" "2026-09-30" "slipway 0.1.0" "Slipway Manual"
+.SH NAME
+slipway\-fetch \- Fetch from the remote of each project
+.SH SYNOPSIS
+.SY "slipway fetch"
+.I "[NAME... | project/NAME...]"\&
+.RI [ flags ]
+.YS
+.SH DESCRIPTION
+Fetch from the remote of each selected project.
+.PP
+Runs git fetch in every project of the current group, in the projects named, in the ones a label selector matches, or with \-\-all\-groups in every project. Git fetches from the remote of the checked\-out branch, else from the only remote, else from origin, as a git fetch typed in the repository would, and updates the references that remote's fetch refspecs name (remote\-tracking references by default) and its tags, never the checked\-out branch or the working tree. The parallel setting caps how many projects fetch at once, and the results print in the order the projects are listed.
+.PP
+Each project prints one line, one of the results listed below, with a reason in parentheses and the details under it. A project whose repository cannot be read, or in which git finds no remote to fetch from, is skipped before git fetch runs. A project whose spec.paused is true is paused: no git command runs in it.
+.PP
+Git never prompts: a fetch that needs a password, a passphrase or a host key is denied, one that runs past the networkTimeout setting is killed, and only the transports in the protocols setting are allowed. The exit status is 1 when any project was denied or failed.
+.SH OPTIONS
+.TP
+\fB\-l\fR, \fB\-\-selector\fR \fIEXPR\fR
+Selector (label query) to filter on, supports '=', '==', '!=', 'in', 'notin' (e.g. \-l key1=value1,key2=value2,key3 in (value3)). Matching objects must satisfy all of the specified label constraints.
+.TP
+\fB\-A\fR, \fB\-\-all\-groups\fR
+If present, fetch every project across all groups. The group in the current configuration is ignored even if specified with \-\-group.
+.TP
+\fB\-\-prune\fR
+Before fetching, remove any remote\-tracking references that no longer exist on the remote.
+.TP
+\fB\-\-dry\-run\fR
+Print what would change and write nothing.
+.SH RESULTS
+When more than one project ran, a count of the results closes the run on stderr. With \-\-dry\-run no remote is contacted: a project that would be fetched reads fetched, and every line and the count end in (dry run). Ctrl\-C stops the git processes slipway started and exits with status 130.
+.TP
+\fBfetched\fR
+The remote moved refs, and up to 5 follow: origin/main a1b2c3d..e4f5a6b for a ref that moved, origin/feature d09a085 (new) for a new one and origin/feature deleted (was d09a085) for one \-\-prune removed. A last line, and N more, counts the rest. Tags appear under their bare name. With git before 2.41, every fetch that succeeds reads fetched, without the refs.
+.TP
+\fBunchanged\fR
+The remote answered and had nothing new.
+.TP
+\fBskipped (Reason)\fR
+No fetch ran: git could not read the repository (Missing, NotARepo, Unsafe, Unknown), git has no remote to pick because there is no upstream, no origin and either no remote or more than one (NoRemote), or the branch tracks a local branch (LocalUpstream).
+.TP
+\fBpaused\fR
+spec.paused is true, so no git command ran in the project.
+.TP
+\fBdenied (Reason)\fR
+Git needed a password, a passphrase or a host key (AuthRequired). Run the git \-C PATH fetch printed below it once in a terminal to see what git needs.
+.TP
+\fBfailed (Reason)\fR
+The fetch ran past networkTimeout (Timeout), used a transport protocols leaves out (ProtocolNotAllowed), or git failed for another reason (Unknown).
+.SH EXAMPLES
+.EX
+# Fetch every project in the current group
+slipway fetch
+.EE
+.PP
+.EX
+# Fetch every project in every group
+slipway fetch \-A
+.EE
+.PP
+.EX
+# Fetch two projects of the work group
+slipway fetch api web \-n work
+.EE
+.PP
+.EX
+# Fetch the projects labeled lang=rust and prune deleted branches
+slipway fetch \-l lang=rust \-\-prune
+.EE
+.PP
+.EX
+# List the projects a fetch would reach, without contacting any remote
+slipway fetch \-A \-\-dry\-run
+.EE
+.SH "SEE ALSO"
+.BR slipway (1)

data/man/man1/slipway-get.1

@@ -0,0 +1,155 @@
+.\" Generated by slipway 0.1.0. Do not edit.
+.TH "SLIPWAY-GET" "1" "2026-09-30" "slipway 0.1.0" "Slipway Manual"
+.SH NAME
+slipway\-get \- Display one or many resources
+.SH SYNOPSIS
+.SY "slipway get"
+.I "(TYPE [NAME...] | TYPE/NAME...)"\&
+.RI [ flags ]
+.YS
+.SH DESCRIPTION
+Display one or many resources.
+.PP
+Prints a table of the most important information about the specified resources. You can filter the list using a label selector and the \-\-selector flag, or a field selector and the \-\-field\-selector flag. Projects are listed in the current group unless you pass \-\-all\-groups.
+.PP
+Use \-o wide to add the path, the head commit, the age of the last commit and the drift of each project: the ways its repository differs from its manifest and what keeps sync from converging it. Use \-o json or \-o yaml for the full object with its status.
+.PP
+Resource types: projects (project, proj) and groups (group). Type words are case\-insensitive.
+.SH OPTIONS
+.TP
+\fB\-o\fR, \fB\-\-output\fR \fIFORMAT\fR
+Output format. One of: table, wide, json, yaml, name. (default "table")
+.TP
+\fB\-l\fR, \fB\-\-selector\fR \fIEXPR\fR
+Selector (label query) to filter on, supports '=', '==', '!=', 'in', 'notin' (e.g. \-l key1=value1,key2=value2,key3 in (value3)). Matching objects must satisfy all of the specified label constraints.
+.TP
+\fB\-\-field\-selector\fR \fIEXPR\fR
+Selector (field query) to filter on, supports '=', '==', and '!=' (e.g. \-\-field\-selector key1=value1,key2=value2). Projects support metadata.name, metadata.group, spec.path, status.state, status.branch, status.lastFetch; groups support metadata.name. Values compare exactly, case included, with the object \-o json prints: spec.path as registered, status.lastFetch as an RFC 3339 time. A field the object leaves out compares as the empty value, except status.lastFetch, which compares as never. A backslash escapes a backslash, a comma or an equals sign in a value.
+.TP
+\fB\-A\fR, \fB\-\-all\-groups\fR
+If present, list the requested object(s) across all groups. The group in the current configuration is ignored even if specified with \-\-group.
+.TP
+\fB\-\-no\-headers\fR
+When using the default output format, don't print headers.
+.TP
+\fB\-\-show\-labels\fR
+When printing, show all labels as the last column.
+.SH COLUMNS
+Projects show NAME, BRANCH, STATUS, FETCHED and AGE; \-\-all\-groups adds GROUP in front, \-o wide adds PATH, HEAD, LAST\-COMMIT and DRIFT, and \-\-show\-labels adds LABELS. Groups show NAME, PROJECTS and AGE, and \-o wide adds DESCRIPTION. A cell slipway has no value for reads <none>, as every cell from git does when git cannot read the repository.
+.TP
+\fBGROUP\fR
+The group of the project.
+.TP
+\fBNAME\fR
+The name of the resource.
+.TP
+\fBBRANCH\fR
+The checked\-out branch, or (detached) when HEAD points at a commit.
+.TP
+\fBSTATUS\fR
+One word for the state of the repository, from the list below.
+.TP
+\fBFETCHED\fR
+Time since the repository was last fetched, by slipway or by git itself and from any of its worktrees. <never> means git answered and no fetch is on record, which includes a last fetch that failed.
+.TP
+\fBAGE\fR
+Time since the resource was registered, in kubectl's units (3s, 4m12s, 11h, 2y319d).
+.TP
+\fBPATH\fR
+The registered path, as the manifest writes it.
+.TP
+\fBHEAD\fR
+The abbreviated id of the checked\-out commit.
+.TP
+\fBLAST\-COMMIT\fR
+The age of the checked\-out commit.
+.TP
+\fBDRIFT\fR
+The ways the repository differs from its manifest and the blocker that keeps sync from fast\-forwarding it, as slipway diff names them.
+.TP
+\fBPROJECTS\fR
+The number of projects in the group.
+.TP
+\fBDESCRIPTION\fR
+The description of the group.
+.TP
+\fBLABELS\fR
+The labels, as key=value pairs.
+.SH "STATUS WORDS"
+STATUS is the first of these words that holds, in this order.
+.TP
+\fBMissing\fR
+The registered path is relative, or is not a directory on this machine.
+.TP
+\fBNotARepo\fR
+The directory exists but no repository contains it.
+.TP
+\fBUnsafe\fR
+git refused the repository because another user owns it (safe.directory); describe, diff and fetch print the git command that trusts it.
+.TP
+\fBConflicted\fR
+The working tree has unmerged paths.
+.TP
+\fBDetached\fR
+HEAD points at a commit rather than a branch.
+.TP
+\fBUnborn\fR
+The branch has no commits yet.
+.TP
+\fBDirty\fR
+Staged, modified or untracked files are present.
+.TP
+\fBGone\fR
+An upstream is configured but its remote\-tracking ref is gone, as of the last fetch \-\-prune (or a fetch with fetch.prune set).
+.TP
+\fBDiverged\fR
+The branch is both ahead of and behind its upstream, as of the last fetch (FETCHED).
+.TP
+\fBAhead\fR
+Commits not yet pushed to the upstream, as of the last fetch (FETCHED).
+.TP
+\fBBehind\fR
+Commits on the upstream not yet pulled, as of the last fetch (FETCHED).
+.TP
+\fBClean\fR
+Nothing to do.
+.TP
+\fBUnknown\fR
+git could not answer: it is not installed, it did not finish within 10 seconds, or it failed for a reason slipway does not classify. Each distinct reason is printed once on stderr per run.
+.SH EXAMPLES
+.EX
+# List all projects in the current group
+slipway get projects
+.EE
+.PP
+.EX
+# List all projects in every group, with the path and last commit
+slipway get projects \-A \-o wide
+.EE
+.PP
+.EX
+# List a single project in YAML output format
+slipway get project hldr \-o yaml
+.EE
+.PP
+.EX
+# List the projects labeled lang=rust
+slipway get projects \-l lang=rust
+.EE
+.PP
+.EX
+# List the projects in every group that are not clean
+slipway get projects \-A \-\-field\-selector status.state!=Clean
+.EE
+.PP
+.EX
+# List the projects no fetch has reached
+slipway get projects \-\-field\-selector status.lastFetch=never
+.EE
+.PP
+.EX
+# List every group
+slipway get groups
+.EE
+.SH "SEE ALSO"
+.BR slipway (1)

data/man/man1/slipway-help.1

@@ -0,0 +1,19 @@
+.\" Generated by slipway 0.1.0. Do not edit.
+.TH "SLIPWAY-HELP" "1" "2026-09-30" "slipway 0.1.0" "Slipway Manual"
+.SH NAME
+slipway\-help \- Help about any command
+.SH SYNOPSIS
+.SY "slipway help"
+.RI [ COMMAND... ]\&
+.RI [ flags ]
+.YS
+.SH DESCRIPTION
+Help provides help for any command in the application.
+Type slipway help [path to command] for full details.
+.SH EXAMPLES
+.EX
+# Show the help of a nested command
+slipway help config view
+.EE
+.SH "SEE ALSO"
+.BR slipway (1)

data/man/man1/slipway-label.1

@@ -0,0 +1,53 @@
+.\" Generated by slipway 0.1.0. Do not edit.
+.TH "SLIPWAY-LABEL" "1" "2026-09-30" "slipway 0.1.0" "Slipway Manual"
+.SH NAME
+slipway\-label \- Update the labels on a resource
+.SH SYNOPSIS
+.SY "slipway label"
+.I "(TYPE NAME | TYPE/NAME) [KEY=VALUE|KEY\-...]"\&
+.RI [ flags ]
+.YS
+.SH DESCRIPTION
+Update the labels on a resource.
+.IP \(bu 2
+A label key and value must begin with a letter or number, and may contain letters, numbers, hyphens, dots, and underscores, up to 63 characters each.
+.IP \(bu 2
+Optionally, the key can begin with a DNS subdomain prefix and a single '/', like example.com/my\-app.
+.IP \(bu 2
+If \-\-overwrite is true, then existing labels can be overwritten, otherwise attempting to overwrite a label will result in an error.
+.IP \(bu 2
+KEY\- removes the label KEY; removing a label that is not set changes nothing. A change that leaves the labels as they were prints not labeled.
+.PP
+Resource types: projects (project, proj) and groups (group). Type words are case\-insensitive.
+.SH OPTIONS
+.TP
+\fB\-\-overwrite\fR
+If true, allow labels to be overwritten, otherwise reject label updates that overwrite existing labels.
+.TP
+\fB\-\-list\fR
+If true, display the labels for a given resource instead of writing them.
+.TP
+\fB\-\-dry\-run\fR
+Print what would change and write nothing.
+.SH EXAMPLES
+.EX
+# Update project 'hldr' with the label 'lang' and the value 'rust'
+slipway label project hldr lang=rust
+.EE
+.PP
+.EX
+# Update project 'hldr' with the label 'lang' and the value 'go', overwriting any existing value
+slipway label project hldr lang=go \-\-overwrite
+.EE
+.PP
+.EX
+# Remove the label 'tier' from project 'hldr'
+slipway label project hldr tier\-
+.EE
+.PP
+.EX
+# List the labels of group 'work'
+slipway label group work \-\-list
+.EE
+.SH "SEE ALSO"
+.BR slipway (1)

data/man/man1/slipway-man.1

@@ -0,0 +1,36 @@
+.\" Generated by slipway 0.1.0. Do not edit.
+.TH "SLIPWAY-MAN" "1" "2026-09-30" "slipway 0.1.0" "Slipway Manual"
+.SH NAME
+slipway\-man \- Show the manual page of a command
+.SH SYNOPSIS
+.SY "slipway man"
+.RI [ COMMAND... ]\&
+.RI [ flags ]
+.YS
+.SH DESCRIPTION
+Show the manual page of slipway or of one of its commands with man(1).
+The pages ship with the gem; \-\-install copies them into a man1 directory and says how man(1) finds them.
+.SH OPTIONS
+.TP
+\fB\-\-path\fR
+Print the directory of the bundled pages and exit.
+.TP
+\fB\-\-install\fR[=\fIDIR\fR]
+Copy every page into DIR, a man1 directory, or into ${XDG_DATA_HOME:\-~/.local/share}/man/man1.
+.SH EXAMPLES
+.EX
+# Read the page of a command
+slipway man get
+.EE
+.PP
+.EX
+# Install every page for man(1)
+slipway man \-\-install
+.EE
+.PP
+.EX
+# Print the bundled page directory
+slipway man \-\-path
+.EE
+.SH "SEE ALSO"
+.BR slipway (1)