From 71337697347847a188f66d6b431e9ea1d838f80d Mon Sep 17 00:00:00 2001
From: Juri Dispan <juri.dispan@posteo.net>
Date: Tue, 6 Feb 2024 16:41:26 +0100
Subject: [PATCH] fstopgm, lispmtopgm, pgmtofs, pgmtolispm, pgmtoppm, pnmalias:
 add pages (#12198)

---
 pages/common/fstopgm.md    |  9 +++++++++
 pages/common/lispmtopgm.md |  9 +++++++++
 pages/common/pgmtofs.md    |  9 +++++++++
 pages/common/pgmtolispm.md |  9 +++++++++
 pages/common/pgmtoppm.md   | 12 ++++++++++++
 pages/common/pnmalias.md   | 20 ++++++++++++++++++++
 6 files changed, 68 insertions(+)
 create mode 100644 pages/common/fstopgm.md
 create mode 100644 pages/common/lispmtopgm.md
 create mode 100644 pages/common/pgmtofs.md
 create mode 100644 pages/common/pgmtolispm.md
 create mode 100644 pages/common/pgmtoppm.md
 create mode 100644 pages/common/pnmalias.md

diff --git a/pages/common/fstopgm.md b/pages/common/fstopgm.md
new file mode 100644
index 0000000000..05e3a8a538
--- /dev/null
+++ b/pages/common/fstopgm.md
@@ -0,0 +1,9 @@
+# fstopgm
+
+> Convert a Usenix FaceSaver file into a PGM image.
+> See also: `pgmtofs`.
+> More information: <https://netpbm.sourceforge.net/doc/fstopgm.html>.
+
+- Convert the specified Usenix FaceSaver file into a PGM image:
+
+`fstopgm {{path/to/input.fs}} > {{path/to/output.pgm}}`
diff --git a/pages/common/lispmtopgm.md b/pages/common/lispmtopgm.md
new file mode 100644
index 0000000000..47c5c2fdf6
--- /dev/null
+++ b/pages/common/lispmtopgm.md
@@ -0,0 +1,9 @@
+# lispmtopgm
+
+> Convert a Lisp Machine bitmap into a PGM image.
+> See also: `pgmtolispm`.
+> More information: <https://netpbm.sourceforge.net/doc/lispmtopgm.html>.
+
+- Convert the specified Lisp Machine bitmap file into a PGM image:
+
+`lispmtopgm {{path/to/input.lispm}} > {{path/to/output.pgm}}`
diff --git a/pages/common/pgmtofs.md b/pages/common/pgmtofs.md
new file mode 100644
index 0000000000..40b08a68fb
--- /dev/null
+++ b/pages/common/pgmtofs.md
@@ -0,0 +1,9 @@
+# pgmtofs
+
+> Convert a PGM image to Usenix FaceSaver format.
+> See also: `fstopgm`.
+> More information: <https://netpbm.sourceforge.net/doc/pgmtofs.html>.
+
+- Convert the specified PGM image to Usenix FaceSave format:
+
+`pgmtofs {{path/to/input.pgm}} > {{path/to/output.fs}}`
diff --git a/pages/common/pgmtolispm.md b/pages/common/pgmtolispm.md
new file mode 100644
index 0000000000..c41ef1288a
--- /dev/null
+++ b/pages/common/pgmtolispm.md
@@ -0,0 +1,9 @@
+# pgmtolispm
+
+> Convert a PGM image to Lisp Machine format.
+> See also: `lispmtopgm`.
+> More information: <https://netpbm.sourceforge.net/doc/pgmtolispm.html>.
+
+- Convert the specified PGM image to Lisp Machine format:
+
+`pgmtolispm {{path/to/input.pgm}} > {{path/to/output.lispm}}`
diff --git a/pages/common/pgmtoppm.md b/pages/common/pgmtoppm.md
new file mode 100644
index 0000000000..b07211eb0a
--- /dev/null
+++ b/pages/common/pgmtoppm.md
@@ -0,0 +1,12 @@
+# pgmtoppm
+
+> Colorize a PGM image.
+> More information: <https://netpbm.sourceforge.net/doc/pgmtoppm.html>.
+
+- Map all greyscale values of the input image to all colors between the two specified colors:
+
+`pgmtoppm -black {{red}} --white {{blue}} {{path/to/input.pgm}} > {{path/to/output.ppm}}`
+
+- Map all greyscale values of the input image to colors according to the specified colormap:
+
+`pgmtoppm -map {{path/to/colormap.ppm}} {{path/to/input.pgm}} > {{path/to/output.ppm}}`
diff --git a/pages/common/pnmalias.md b/pages/common/pnmalias.md
new file mode 100644
index 0000000000..429e89d33c
--- /dev/null
+++ b/pages/common/pnmalias.md
@@ -0,0 +1,20 @@
+# pnmalias
+
+> Apply antialiasing onto a PNM image.
+> More information: <https://netpbm.sourceforge.net/doc/pnmalias.html>.
+
+- Perform antialiasing on a PNM image, taking black pixels as background and white pixels as foreground:
+
+`pnmalias {{path/to/input.pnm}} > {{path/to/output.ppm}}`
+
+- Explicitly specify the background and foreground color:
+
+`pnmalias -bcolor {{background_color}} -fcolor {{foreground_color}} {{path/to/input.pnm}} > {{path/to/output.ppm}}`
+
+- Apply altialiasing to foreground pixels only:
+
+`pnmalias -fonly {{path/to/input.pnm}} > {{path/to/output.ppm}}`
+
+- Apply antialiasing to all surrounding pixels of background pixels:
+
+`pnmalias -balias {{path/to/input.pnm}} > {{path/to/output.ppm}}`