aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2024-11-03 12:23:01 +0100
committerAlejandro Colomar <alx@kernel.org>2024-11-03 13:33:22 +0100
commited9bc1e3277befd6e165270f14e458a5ec4074f1 (patch)
treee3c02475d933b86e8e7c6b7aee0db9247c287904
parent5488af74e12b647523f05beb4cbdacffa4aec563 (diff)
downloadman-pages-ed9bc1e3277befd6e165270f14e458a5ec4074f1.tar.gz
src/bin/pdfman, scripts/bash_aliases, pdfman.1: Make pdfman a standalone program, and add a manual page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
-rw-r--r--man/man1/pdfman.125
-rw-r--r--scripts/bash_aliases11
-rwxr-xr-xsrc/bin/pdfman11
3 files changed, 36 insertions, 11 deletions
diff --git a/man/man1/pdfman.1 b/man/man1/pdfman.1
new file mode 100644
index 0000000000..aef4024575
--- /dev/null
+++ b/man/man1/pdfman.1
@@ -0,0 +1,25 @@
+.\" Copyright 2024, Alejandro Colomar <alx@kernel.org>
+.\"
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
+.\"
+.TH pdfman 1 (date) "Linux man-pages (unreleased)"
+.SH NAME
+pdfman
+\-
+render a manual page in PDF
+.SH SYNOPSIS
+.B pdfman
+.RI [ man-options ]
+.RI [ section ]\~ page
+.SH DESCRIPTION
+The
+.B pdfman
+command renders a manual page in PDF.
+All the arguments are interpreted by
+.BR man (1).
+.EE
+.SH SEE ALSO
+.BR man (1),
+.BR groff (1),
+.BR gropdf (1),
+.BR xdg\-open (1)
diff --git a/scripts/bash_aliases b/scripts/bash_aliases
index bd6829409b..318e66c56c 100644
--- a/scripts/bash_aliases
+++ b/scripts/bash_aliases
@@ -88,17 +88,6 @@ man_lsvar()
|uniq;
}
-# pdfman() renders a manual page in PDF
-# Usage example: .../man-pages$ pdfman man2/membarrier.2;
-
-pdfman()
-{
- local tmp="$(mktemp -t "${!###*/}.XXXXXX")";
-
- man -Tpdf "$@" >"$tmp";
- xdg-open "$tmp";
-}
-
# man_gitstaged prints a list of all files with changes staged for commit
# (basename only if the files are within <man?/>), separated by ", ".
# Usage example: .../man-pages$ git commit -m "$(man_gitstaged): msg";
diff --git a/src/bin/pdfman b/src/bin/pdfman
new file mode 100755
index 0000000000..b23015105f
--- /dev/null
+++ b/src/bin/pdfman
@@ -0,0 +1,11 @@
+#!/bin/bash
+#
+# Copyright 2021-2024, Alejandro Colomar <alx@kernel.org>
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+set -Eeuo pipefail;
+
+tmp="$(mktemp -t "${!###*/}.XXXXXX")";
+
+man -Tpdf "$@" >"$tmp";
+xdg-open "$tmp";