From 6d791ee143c86ba1a3dca870089732f47a793740 Mon Sep 17 00:00:00 2001
From: cloudhead <cloudhead@radicle.xyz>
Date: Wed, 22 Nov 2023 14:44:48 +0100
Subject: [PATCH] docs: Add section about `patch checkout` to manual

---
 rad-patch.1.adoc | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/rad-patch.1.adoc b/rad-patch.1.adoc
index e2f450a1..cbcc5199 100644
--- a/rad-patch.1.adoc
+++ b/rad-patch.1.adoc
@@ -96,6 +96,16 @@ that should only be used when using *git push rad* is not possible.
 *--message*, *-m [<string>]*::   Provide a comment message to the revision
 *--no-message*::                 Leave the revision comment message blank
 
+=== checkout
+
+Switch to a given patch, by creating a branch that points to the patch head.
+This is essentially equivalent to *git checkout -b <name>* followed by
+*rad patch set <patch-id>*. By default, the branch name includes the Patch ID.
+
+*--revision <id>*::        Checkout the given revision of the patch
+*--name <string>*::        Provide a name for the new branch
+*--force*, *-f*::          If the checkout already exists, update its head
+
 === comment
 
 Comment on a patch revision, optionally replying to an existing comment.