From 425cadc57ade92bb736bc284c624cfd2c7dd4e4b Mon Sep 17 00:00:00 2001
From: Juri Dispan <juri.dispan@posteo.net>
Date: Tue, 7 Nov 2023 14:15:14 +0100
Subject: [PATCH] gemtopbm, gemtopnm, pamtotga, ppmtotga, tgatoppm: add pages
 (#11402)

* gemtopbm, gemtopnm, pamtotga, ppmtotga, tgatoppm: add pages

---------

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
---
 pages/common/gemtopbm.md |  8 ++++++++
 pages/common/gemtopnm.md | 16 ++++++++++++++++
 pages/common/pamtotga.md | 16 ++++++++++++++++
 pages/common/ppmtotga.md |  8 ++++++++
 pages/common/tgatoppm.md | 20 ++++++++++++++++++++
 5 files changed, 68 insertions(+)
 create mode 100644 pages/common/gemtopbm.md
 create mode 100644 pages/common/gemtopnm.md
 create mode 100644 pages/common/pamtotga.md
 create mode 100644 pages/common/ppmtotga.md
 create mode 100644 pages/common/tgatoppm.md

diff --git a/pages/common/gemtopbm.md b/pages/common/gemtopbm.md
new file mode 100644
index 0000000000..4be4af1856
--- /dev/null
+++ b/pages/common/gemtopbm.md
@@ -0,0 +1,8 @@
+# gemtopbm
+
+> This command is superseded by `gemtopnm`.
+> More information: <https://netpbm.sourceforge.net/doc/gemtopbm.html>.
+
+- View documentation for the current command:
+
+`tldr gemtopnm`
diff --git a/pages/common/gemtopnm.md b/pages/common/gemtopnm.md
new file mode 100644
index 0000000000..daddecc9f3
--- /dev/null
+++ b/pages/common/gemtopnm.md
@@ -0,0 +1,16 @@
+# gemtopbm
+
+> Convert a GEM image file into a PNM image.
+> More information: <https://netpbm.sourceforge.net/doc/gemtopnm.html>.
+
+- Convert a GEM image file to a PNM image:
+
+`gemtopbm {{path/to/file.img}} > {{path/to/output.pbm}}`
+
+- Describe the contents of the specified GEM image:
+
+`gemtopbm -d {{path/to/file.img}}`
+
+- Display version:
+
+`gemtopbm -version`
diff --git a/pages/common/pamtotga.md b/pages/common/pamtotga.md
new file mode 100644
index 0000000000..06eac1405f
--- /dev/null
+++ b/pages/common/pamtotga.md
@@ -0,0 +1,16 @@
+# pamtotga
+
+> Convert a Netpbm image to a TrueVision Targa file.
+> More information: <https://netpbm.sourceforge.net/doc/pamtotga.html>.
+
+- Convert a Netpbm image to a TrueVision Targa file:
+
+`pamtotga {{path/to/file.pam}} > {{path/to/output.tga}}`
+
+- Specify the color map of the output image:
+
+`pamtotga -{{cmap|cmap16|mono|rgb}} {{path/to/file.pam}} > {{path/to/output.tga}}`
+
+- Display version:
+
+`pamtotga -version`
diff --git a/pages/common/ppmtotga.md b/pages/common/ppmtotga.md
new file mode 100644
index 0000000000..69facae296
--- /dev/null
+++ b/pages/common/ppmtotga.md
@@ -0,0 +1,8 @@
+# ppmtotga
+
+> This command is superseded by `pamtotga`.
+> More information: <https://netpbm.sourceforge.net/doc/ppmtotga.html>.
+
+- View documentation for the current command:
+
+`tldr pamtotga`
diff --git a/pages/common/tgatoppm.md b/pages/common/tgatoppm.md
new file mode 100644
index 0000000000..63e0a529c1
--- /dev/null
+++ b/pages/common/tgatoppm.md
@@ -0,0 +1,20 @@
+# tgatoppm
+
+> Convert a TrueVision Targa file to a Netpbm image.
+> More information: <https://netpbm.sourceforge.net/doc/tgatoppm.html>.
+
+- Convert a TrueVision Targa file to a PPM image:
+
+`tgatoppm {{path/to/file.tga}} > {{path/to/output.ppm}}`
+
+- Dump information from the TGA header to `stdout`:
+
+`tgatoppm --headerdump {{path/to/file.tga}} > {{path/to/output.ppm}}`
+
+- Write the transparency channel values of the input image to the specified file:
+
+`tgatoppm --alphaout {{path/to/transparency_file.pgm}} {{path/to/file.tga}} > {{path/to/output.ppm}}`
+
+- Display version:
+
+`tgatoppm -version`