From d2f18edf190310953357ccbbb5139f81bc57c974 Mon Sep 17 00:00:00 2001
From: Juri Dispan <juri.dispan@posteo.net>
Date: Mon, 4 Mar 2024 04:58:24 +0100
Subject: [PATCH] pgmcrater, pamcrater, pamshadedrelief: add pages (#12401)

---
 pages/common/pamcrater.md       | 13 +++++++++++++
 pages/common/pamshadedrelief.md | 13 +++++++++++++
 pages/common/pgmcrater.md       | 16 ++++++++++++++++
 3 files changed, 42 insertions(+)
 create mode 100644 pages/common/pamcrater.md
 create mode 100644 pages/common/pamshadedrelief.md
 create mode 100644 pages/common/pgmcrater.md

diff --git a/pages/common/pamcrater.md b/pages/common/pamcrater.md
new file mode 100644
index 000000000..cd092ae04
--- /dev/null
+++ b/pages/common/pamcrater.md
@@ -0,0 +1,13 @@
+# pamcrater
+
+> Create a PAM image of cratered terrain.
+> See also: `pamshadedrelief`, `ppmrelief`.
+> More information: <https://netpbm.sourceforge.net/doc/pamcrater.html>.
+
+- Create an image of cratered terrain with the specified dimensions:
+
+`pamcrater -height {{height}} -width {{width}} > {{path/to/output.pam}}`
+
+- Create an image containing the specified number of craters:
+
+`pamcrater -number {{n_craters}} > {{path/to/output.pam}}`
diff --git a/pages/common/pamshadedrelief.md b/pages/common/pamshadedrelief.md
new file mode 100644
index 000000000..13bf84be3
--- /dev/null
+++ b/pages/common/pamshadedrelief.md
@@ -0,0 +1,13 @@
+# pamshadedrelief
+
+> Generate a shaded relief from an elevation map.
+> See also: `pamcrater`, `ppmrelief`.
+> More information: <https://netpbm.sourceforge.net/doc/pamshadedrelief.html>.
+
+- Generate a shaded relief image with the input image interpreted as an elevation map:
+
+`pamshadedrelief < {{path/to/input.pam}} > {{path/to/output.pam}}`
+
+- Gamma adjust the image by the specified factor:
+
+`pamshadedrelief -gamma {{factor}} < {{path/to/input.pam}} > {{path/to/output.pam}}`
diff --git a/pages/common/pgmcrater.md b/pages/common/pgmcrater.md
new file mode 100644
index 000000000..21bd7e6c4
--- /dev/null
+++ b/pages/common/pgmcrater.md
@@ -0,0 +1,16 @@
+# pgmcrater
+
+> This command is superseded by `pamcrater`, `pamshadedrelief`, and `pamtopnm`.
+> More information: <https://netpbm.sourceforge.net/doc/pgmcrater.html>.
+
+- View documentation for `pamcrater`:
+
+`tldr pamcrater`
+
+- View documentation for `pamshadedrelief`:
+
+`tldr pamshadedrelief`
+
+- View documentation for `pamtopnm`:
+
+`tldr pamtopnm`