Updates for v2.4.0

Author: jpgrayson

content/_index.md

@@ -35,6 +35,11 @@ StGit is licensed under the GNU General Public License, version 2.
 
 ## News
 
+### 2023-10-08: [StGit v2.4.0][v2.4.0] has been released.
+
+This release adds some new command line options to `stg branch`, `stg
+sink`, and `stg delete`.
+
 ### 2023-10-04: [StGit v2.3.3][v2.3.3] has been released.
 
 Fixes to zsh completions along with MacOS portability improvements.
@@ -66,6 +71,7 @@ bzip2-rs crate which allows for static linking when not using the
 
 This release also contains a few more bugfixes to `stg import`.
 
+[v2.4.0]: https://github.com/stacked-git/stgit/releases/tag/v2.4.0
 [v2.3.3]: https://github.com/stacked-git/stgit/releases/tag/v2.3.3
 [v2.3.2]: https://github.com/stacked-git/stgit/releases/tag/v2.3.2
 [v2.3.1]: https://github.com/stacked-git/stgit/releases/tag/v2.3.1

content/changelog/_index.md

@@ -4,6 +4,14 @@ title = 'StGit Changelog'
 
 # Changelog
 
+## 2.4.0 2024-10-08
+
+### Added
+- feat(delete): --all -A -U -H options
+- feat(sink): -T/--above option
+- feat(branch): short opts for clone and delete
+
+
 ## 2.3.3 2023-10-04
 
 ### Fixed

content/man/stg-branch.adoc

@@ -16,11 +16,11 @@ SYNOPSIS
 'stg branch' [--merge] <branch>
 'stg branch' {--list,-l}
 'stg branch' {--create,-c} <new-branch> [committish]
-'stg branch' --clone [new-branch]
+'stg branch' {--clone,-C} [new-branch]
 'stg branch' {--rename,-r} [old-name] <new-name>
 'stg branch' {--protect,-p} [branch]
 'stg branch' {--unprotect,-u} [branch]
-'stg branch' --delete [--force] <branch>
+'stg branch' {--delete,-D} [--force] <branch>
 'stg branch' --cleanup [--force] [branch]
 'stg branch' {--describe,-d} <description> [branch]
 

content/man/stg-delete.adoc

@@ -12,7 +12,9 @@ stg-delete - Delete patches
 SYNOPSIS
 --------
 [verse]
-'stg delete' [OPTIONS] <patch>...
+'stg delete' [OPTIONS] [<patch>...]
+'stg delete' [OPTIONS] [-A] [-U] [-H]
+'stg delete' [OPTIONS] --all
 'stg delete' [OPTIONS] --top
 
 DESCRIPTION
@@ -22,17 +24,33 @@ Delete patches
 
 OPTIONS
 -------
+-a::
+--all::
+    Delete all patches
+
+-A::
+--applied::
+    Delete the applied patches
+
+-U::
+--unapplied::
+    Delete the unapplied patches
+
+-H::
+--hidden::
+    Delete the hidden patches
+
+-t::
+--top::
+    Delete topmost patch
+
 --spill::
     Delete the patches, but without modifying the index and worktree. This only
     works when deleting applied patches at the top of the stack. The effect is
     to "spill" the patch contents into the index and worktree.
 +
 This can be useful for splitting a patch into smaller pieces.
 
--t::
---top::
-    Delete topmost patch
-
 -b <branch>::
 --branch=<branch>::
     Use <branch> instead of current branch

content/man/stg-sink.adoc

@@ -20,12 +20,14 @@ DESCRIPTION
 Move the specified patches down the stack.
 
 If no patch is specified on the command line, the current (topmost) patch is
-sunk. By default, patches are sunk to the bottom of the stack, but the '--to'
-option may be used to place them under any applied patch.
+sunk. By default, patches are sunk to the bottom of the stack, but the
+'--above' or '--below' (alias '--to') options may be used to place them above
+or below any applied patch.
 
 Internally, sinking involves popping all patches to the bottom (or to the
-target patch if '--to' is used), then pushing the patches to sink, and then,
-unless '--nopush' is specified, pushing back any other formerly applied patches.
+target patch if '--above' or '--below' is used), then pushing the patches to
+sink, and then, unless '--nopush' is specified, pushing back any other formerly
+applied patches.
 
 Sinking may be useful, for example, to group stable patches at the bottom of
 the stack where they less likely to be impacted by the push of another patch,
@@ -40,11 +42,18 @@ OPTIONS
     sink are pushed.
 
 -t <target>::
+--below=<target>::
 --to=<target>::
     Sink patches below <target> patch.
 +
 Specified patches are placed below <target> instead of at the bottom of the stack.
 
+-T <target>::
+--above=<target>::
+    Sink patches above <target> patch.
++
+Specified patches are placed above <target> instead of at the bottom of the stack.
+
 -k::
 --keep::
     Keep the local changes