From 0e9fe32c9e04ac1e1806cf51989911ca8e084b77 Mon Sep 17 00:00:00 2001
From: Matt Bangert <mattbangert@gmail.com>
Date: Tue, 3 Aug 2021 11:43:32 -0700
Subject: [PATCH] choose: add page (#6135)

---
 pages/common/choose.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 pages/common/choose.md

diff --git a/pages/common/choose.md b/pages/common/choose.md
new file mode 100644
index 000000000..67d27e918
--- /dev/null
+++ b/pages/common/choose.md
@@ -0,0 +1,36 @@
+# choose
+
+> A human-friendly and fast alternative to cut and (sometimes) awk.
+> More information: <https://github.com/theryangeary/choose>.
+
+- Print the 5th item from a line (starting from 0):
+
+`choose {{4}}`
+
+- Print the first, 3rd, and 5th item from a line, where items are separated by ':' instead of whitespace:
+
+`choose --field-separator '{{:}}' {{0}} {{2}} {{4}}`
+
+- Print everything from the 2nd to 5th item on the line, including the 5th:
+
+`choose {{1}}:{{4}}`
+
+- Print everything from the 2nd to 5th item on the line, excluding the 5th:
+
+`choose --exclusive {{1}}:{{4}}`
+
+- Print the beginning of the line to the 3rd item:
+
+`choose :{{2}}`
+
+- Print all items from the beginning of the line until the 3rd item (exclusive):
+
+`choose --exclusive :{{2}}`
+
+- Print all items from the 3rd to the end of the line:
+
+`choose {{2}}:`
+
+- Print the last item from a line:
+
+`choose {{-1}}`