aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/README.md b/README.md
index 43f852b..cc25bb5 100644
--- a/README.md
+++ b/README.md
@@ -172,6 +172,7 @@ gitctl repo create publisher --section SlackBuilds --desc "..."
gitctl repo list
gitctl repo desc publisher "a new description"
gitctl repo add-remote publisher --remote-name origin
+gitctl repo delete publisher
gitctl sync
```
@@ -197,6 +198,12 @@ for the SSH key, so it is not fully unattended.
private repos show too. A `VIS` column marks each `PUB` (present in cgitrc) or
`PRIV`; on a terminal public rows are green and private dim. The description
comes from each repo's `description` file, truncated to 60 chars.
+- `repo delete` removes a repo from all three places it lives: the gitolite
+ stanza (committed and pushed first), the cgit block, and the bare repo, which
+ is MOVED to the server's trash dir (`/var/lib/gitolite3/trash`,
+ timestamped) rather than removed, so it is recoverable. It ALWAYS asks for
+ confirmation; the global `-y` does not bypass it. Idempotent: a piece already
+ gone is skipped. Prune the trash dir by hand (or a later tool) when sure.
- `--desc` never writes cgit `repo.desc=` directly. It writes the bare repo's
`description` file and runs sync, the single writer.
- Every operation is idempotent and safe to re-run.