README.md

   1 # pdfman: View UNIX manual pages as Portable Document Format (PDF) files
   2
   3 `pdfman` converts UNIX manual pages to PDF documents using Ghostscript's
   4 `ps2pdf`(1) or Apple's `pstopdf`(1) command (included in macOS up to version 13
   5 "Ventura") and displays them by calling `open`(1) on the resulting PDF file.
   6 This enhances the useability of the manual pages quite a bit, because you now
   7 can make use of your preferred PDF file viewer and all of its functionality.
   8
   9 The conversion is only done once and a cached PDF file gets used for subsequent
  10 invocations for the same topic.
  11
  12 ## Usage
  13
  14 ```bash
  15 pdfman [-v] [-T] [<section>] <topic> ...
  16 pdfman <man(1) options> <arguments> ...
  17 pdfman {--help|--version>}
  18 ```