From 94f2502991ca288a345cc9354b85a37fe9ae51cb Mon Sep 17 00:00:00 2001
From: Juri Dispan <juri.dispan@posteo.net>
Date: Tue, 7 Nov 2023 20:02:14 +0100
Subject: [PATCH] pamtowinicon, pgmtosbig, pgmtost4, ppmtowinicon, sbigtopgm,
 st4topgm, winicontopam, winicontoppm: add pages (#11404)

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
---
 pages/common/pamtowinicon.md | 16 ++++++++++++++++
 pages/common/pgmtosbig.md    |  8 ++++++++
 pages/common/pgmtost4.md     |  8 ++++++++
 pages/common/ppmtowinicon.md |  8 ++++++++
 pages/common/sbigtopgm.md    |  8 ++++++++
 pages/common/st4topgm.md     |  8 ++++++++
 pages/common/winicontopam.md | 20 ++++++++++++++++++++
 pages/common/winicontoppm.md |  8 ++++++++
 8 files changed, 84 insertions(+)
 create mode 100644 pages/common/pamtowinicon.md
 create mode 100644 pages/common/pgmtosbig.md
 create mode 100644 pages/common/pgmtost4.md
 create mode 100644 pages/common/ppmtowinicon.md
 create mode 100644 pages/common/sbigtopgm.md
 create mode 100644 pages/common/st4topgm.md
 create mode 100644 pages/common/winicontopam.md
 create mode 100644 pages/common/winicontoppm.md

diff --git a/pages/common/pamtowinicon.md b/pages/common/pamtowinicon.md
new file mode 100644
index 000000000..d516f1a62
--- /dev/null
+++ b/pages/common/pamtowinicon.md
@@ -0,0 +1,16 @@
+# pamtowinicon
+
+> Convert a PAM image to a Windows ICO file.
+> More information: <https://netpbm.sourceforge.net/doc/pamtowinicon.html>.
+
+- Convert a PAM image file to an ICO file:
+
+`pamtowinicon {{path/to/input_file.pam}} > {{path/to/output.ico}}`
+
+- Encode images with resolutions smaller than t in the BMP format and all other images in the PNG format:
+
+`pamtowinicon -pngthreshold {{t}} {{path/to/input_file.pam}} > {{path/to/output.ico}}`
+
+- Make all pixels outside the non-opaque area black:
+
+`pamtowinicon -truetransparent {{path/to/input_file.pam}} > {{path/to/output.ico}}`
diff --git a/pages/common/pgmtosbig.md b/pages/common/pgmtosbig.md
new file mode 100644
index 000000000..393a34d8f
--- /dev/null
+++ b/pages/common/pgmtosbig.md
@@ -0,0 +1,8 @@
+# pgmtosbig
+
+> Convert a PGM image to the SBIG CCDOPS format.
+> More information: <https://netpbm.sourceforge.net/doc/pgmtosbig.html>.
+
+- Convert a PGM image file to the SBIG CCDOPS format:
+
+`pgmtosbig {{path/to/input_file.pgm}} > {{path/to/output.sbig}}`
diff --git a/pages/common/pgmtost4.md b/pages/common/pgmtost4.md
new file mode 100644
index 000000000..079ba4898
--- /dev/null
+++ b/pages/common/pgmtost4.md
@@ -0,0 +1,8 @@
+# pgmtost4
+
+> Convert a PGM image to the SBIG ST-4 format.
+> More information: <https://netpbm.sourceforge.net/doc/pgmtost4.html>.
+
+- Convert a PGM image file to the SBIG ST-4 format:
+
+`pgmtost4 {{path/to/input_file.pgm}} > {{path/to/output.st4}}`
diff --git a/pages/common/ppmtowinicon.md b/pages/common/ppmtowinicon.md
new file mode 100644
index 000000000..16559276a
--- /dev/null
+++ b/pages/common/ppmtowinicon.md
@@ -0,0 +1,8 @@
+# ppmtowinicon
+
+> This command is superseded by `pamtowinicon`.
+> More information: <https://netpbm.sourceforge.net/doc/ppmtowinicon.html>.
+
+- View documentation for the current command:
+
+`tldr pamtowinicon`
diff --git a/pages/common/sbigtopgm.md b/pages/common/sbigtopgm.md
new file mode 100644
index 000000000..a996a4616
--- /dev/null
+++ b/pages/common/sbigtopgm.md
@@ -0,0 +1,8 @@
+# sbigtopgm
+
+> Convert an SBIG CCDOPS file to PGM.
+> More information: <https://netpbm.sourceforge.net/doc/sbigtopgm.html>.
+
+- Convert an SBIG CCDOPS image file to PGM:
+
+`sbigtopgm {{path/to/input_file.sbig}} > {{path/to/output.pgm}}`
diff --git a/pages/common/st4topgm.md b/pages/common/st4topgm.md
new file mode 100644
index 000000000..b00289567
--- /dev/null
+++ b/pages/common/st4topgm.md
@@ -0,0 +1,8 @@
+# st4topgm
+
+> Convert an SBIG ST-4 file to PGM.
+> More information: <https://netpbm.sourceforge.net/doc/st4topgm.html>.
+
+- Convert an SBIG ST-4 file to a PGM file:
+
+`st4topgm {{path/to/input_file.st4}} > {{path/to/output.pgm}}`
diff --git a/pages/common/winicontopam.md b/pages/common/winicontopam.md
new file mode 100644
index 000000000..d07f727ed
--- /dev/null
+++ b/pages/common/winicontopam.md
@@ -0,0 +1,20 @@
+# winicontopam
+
+> Convert a Windows ICO file to a PAM file.
+> More information: <https://netpbm.sourceforge.net/doc/winicontopam.html>.
+
+- Read an ICO file and convert the best quality image contained therein to the PAM format:
+
+`winicontopam {{path/to/input_file.ico}} > {{path/to/output.pam}}`
+
+- Convert all images in the input file to PAM:
+
+`winicontopam -allimages {{path/to/input_file.ico}} > {{path/to/output.pam}}`
+
+- Convert the n'th image in the input file to PAM:
+
+`winicontopam -image {{n}} {{path/to/input_file.ico}} > {{path/to/output.pam}}`
+
+- If the image(s) to be extracted contain graded transparency data and an AND mask, write the AND mask into the fifth channel of the output PAM file:
+
+`winicontopam -andmasks {{path/to/input_file.ico}} > {{path/to/output.pam}}`
diff --git a/pages/common/winicontoppm.md b/pages/common/winicontoppm.md
new file mode 100644
index 000000000..d9006108b
--- /dev/null
+++ b/pages/common/winicontoppm.md
@@ -0,0 +1,8 @@
+# winicontoppm
+
+> This command is superseded by `winicontopam`.
+> More information: <https://netpbm.sourceforge.net/doc/winicontoppm.html>.
+
+- View documentation for the current command:
+
+`tldr winicontopam`