From 17d76276d9765cacf08da4e8d5ad511d8dea45e6 Mon Sep 17 00:00:00 2001
From: pixel <pixel+github@chrissx.de>
Date: Tue, 29 Aug 2023 12:09:28 +0200
Subject: [PATCH] shar: add page (#10643)

* shar: add page

---------

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>
---
 pages/common/shar.md |  8 ++++++++
 pages/linux/shar.md  | 24 ++++++++++++++++++++++++
 2 files changed, 32 insertions(+)
 create mode 100644 pages/common/shar.md
 create mode 100644 pages/linux/shar.md

diff --git a/pages/common/shar.md b/pages/common/shar.md
new file mode 100644
index 000000000..c9278a69f
--- /dev/null
+++ b/pages/common/shar.md
@@ -0,0 +1,8 @@
+# shar
+
+> Create a shell archive.
+> More information: <https://manned.org/man/freebsd/shar>.
+
+- Create a shell script that when executed extracts the given files from itself:
+
+`shar {{path/to/file1 path/to/file2 ...}} > {{path/to/archive.sh}}`
diff --git a/pages/linux/shar.md b/pages/linux/shar.md
new file mode 100644
index 000000000..f2c444351
--- /dev/null
+++ b/pages/linux/shar.md
@@ -0,0 +1,24 @@
+# shar
+
+> Create a shell archive.
+> More information: <https://www.gnu.org/software/sharutils/manual/sharutils.html>.
+
+- Create a shell script that when executed extracts the given files from itself:
+
+`shar --vanilla-operation {{path/to/file1 path/to/file2 ...}} > {{path/to/archive.sh}}`
+
+- Compress the files in the archive:
+
+`shar --compactor {{xz}} {{path/to/file1 path/to/file2 ...}} > {{path/to/archive.sh}}`
+
+- Treat all files as binary (i.e. `uuencode` everything):
+
+`shar --uuencode {{path/to/file1 path/to/file2 ...}} > {{path/to/archive.sh}}`
+
+- Treat all files as text (i.e. `uuencode` nothing):
+
+`shar --text-files {{path/to/file1 path/to/file2 ...}} > {{path/to/archive.sh}}`
+
+- Include a name and cut mark in the header comment of the archive:
+
+`shar --archive-name "{{My files}}" --cut-mark {{path/to/file1 path/to/file2 ...}} > {{path/to/archive.sh}}`