pass-pdf

pass-pdf
========

A [password-store](https://www.passwordstore.org/) extension to
archive your passwords as a printable PDF.  Main use-cases are to
create fully offline backups and to give your less technical loved
ones access to your online accounts when you die.

Install with `make install` and uninstall with `make uninstall`.  Uses
the GNU groff(7) typesetting system to generate PDFs, if you're on a
GNU Linux distro it's probably already installed.  You'll need to set
several environemnt variables set in order to use this, see pass(1)
for details.

Future Work
---
- PDF generations works with GNU groff, don't hardcode groff and make
  sure it works with BSD and other non-GNU roff/troff implementations.
- **Major Issue** preconv(1) converts non-ascii characters in the
  source into hex codes, however groff is too lazy to go looking for
  the fonts needed to display the overwhelming majority of Earth's
  languages.  There is a
  [groff-install-font](https://gist.github.com/torbiak/3352fe1f559dbfbf99d6f5704adf442e)
  script that converts the usual truetype and opentype font files into
  the weird archaic format groff can use, but this requires an
  obnoxious degree of manual effort.  Not a big deal for most English
  speakers, but for the rest of us this is a real pain in the ass.  If
  you see a warning like `special character 'u041F' not defined`, that
  means groff mangled something in the resulting PDF.
- Long lines result in a warning printed to stderr and a hyphen being
  appended to the line; figure out a way to remove the hyphen and
  suppress the warning.
- Write some zsh, bash, and fish completions