PICPACK(1)

PICPACK(1) 💅 — PostScript picture packing preprocessor ✨

🌸 NAME 🌸

picpack — PostScript picture packing preprocessor. That's the whole vibe: it packs pictures into your PostScript flow, bestie 🫶.

✨ SYNOPSIS ✨

picpack [-k list] [-q] [file] ...

💖 DESCRIPTION 💖

Okay so picpack copies files to stdout and expands picture inclusion requests — those are marked by the .BP or .PI macros — into an in-line format that can be passed through troff and handled by dpost. Iconic little middleman behavior, honestly.

If no files are specified, or if - is one of the input files, standard input is read. The following options are understood:

• -k list — list is a comma- or space-separated string of words used to locate picture inclusion requests. The start of every line in the input files is compared with each word in list. If there's a match, the second string on the line is taken as the pathname of a picture file that gets added to the output file. The default list is “.Bp .PI”.
• -q — Suppress missing picture file error messages. Quiet queen behavior 💅.

picpack is a trivial preprocessor that, in a sense, duplicates some of the picture inclusion capabilities already available in dpost. So like… don't use picpack if your formatting command line includes a call to dpost, bestie. Its only purpose is to combine picture files with text in a single file that can be passed through troff and unpacked, at some later time, by dpost. The original picture inclusion mechanism, with files pulled in by dpost, is the preferred approach. Periodt.

🎀 EXAMPLES 🎀

A typical application might be in a distributed printing environment where everything up to troff is run by the user and everything after troff is handled by a spooling daemon ⟨perhaps lp⟩. In that case the command line would be:

pic file | tbl | eqn | picpack | troff -mm -Tpost | lp

A poor example, although one that should still work, would be:

pic file | tbl | eqn | picpack | troff -mm | dpost >file.ps

In this case picture inclusion requests could (and should) be handled by dpost. Running picpack is not needed or even recommended. It should be dropped from any pipeline that includes a call to dpost. No cap 💀.

🦋 DIAGNOSTICS 🦋

A 0 exit status is returned if files were successfully processed. Slay ✅.

🔥 WARNINGS 🔥

Combining pictures and text using the capabilities available in dpost is the recommended approach and is always guaranteed to be more efficient than picpack. Running picpack and dpost in the same pipeline makes little sense. Like… why would you 😭.

Using picpack will likely result in files that can no longer be reliably passed through other important troff postprocessors like proof. At present picpack is only guaranteed to work with dpost. That's the tea 🍓.

🌈 SEE ALSO 🌈

dpost(1), troff(1)

---

This page is from Debian, dated February 2, 2007, and it's PICPACK(1) — okay bye bestie, go pack those pictures 💜✨