From be742fa374afed8ed18df0debe24d797eb7f17ce Mon Sep 17 00:00:00 2001
From: Cornelius Roemer <cornelius.roemer@gmail.com>
Date: Tue, 30 Aug 2022 21:51:26 +0200
Subject: [PATCH] keep-header: add page (#8401)

---
 pages/common/keep-header.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 pages/common/keep-header.md

diff --git a/pages/common/keep-header.md b/pages/common/keep-header.md
new file mode 100644
index 000000000..4db9e4448
--- /dev/null
+++ b/pages/common/keep-header.md
@@ -0,0 +1,20 @@
+# keep-header
+
+> Keep first line untouched by a command, passing it directly to stdout.
+> More information: <https://github.com/eBay/tsv-utils#keep-header>.
+
+- Sort a file and keep the first line at the top:
+
+`keep-header {{path/to/file}} -- sort`
+
+- Output first line directly to stdout, passing the remainder of the file through the specified command:
+
+`keep-header {{path/to/file}} -- {{command}}`
+
+- Read from stdin, sorting all except the first line:
+
+`cat {{path/to/file}} | keep-header -- {{command}}`
+
+- Grep a file, keeping the first line regardless of the search pattern:
+
+`keep-header {{path/to/file}} -- grep {{pattern}}`