README.md

   1 # pdfman: View Manual Pages as Portable Document Format (PDF) files
   2
   3 `pdfman` converts UNIX manual pages to PDF using the `pstopdf(1)` command and
   4 displays them by calling `open(1)` on the resulting PDF file. This works very
   5 good on macOS and enhances the useability of the manual pages quite a bit
   6 because you can use your preferred PDF reader.
   7
   8 The conversion is only done once and a cached PDF file gets used for subsequent
   9 invocations for the same topic.
  10
  11 ## Usage
  12
  13 ```bash
  14 pdfman [-v] [-T] [<section>] <topic> ...
  15 pdfman <man(1) options> <arguments> ...
  16 pdfman {--help|--version>}
  17 ```