INCLUDERES(1)

💅 INCLUDERES(1) — bestie edition ✨

okay so this is a page from the General Commands Manual, and it's about a lil tool called includeres. she's a filter, she's lowkey iconic, and she's here to fix your PostScript files. let's get into it 🫶

---

🌸 NAME 🌸

includeres — a filter that puts resources into a PostScript document. like, actually in. no cap. 💖

---

✨ SYNOPSIS ✨

includeres <document.ps >output.ps

that's it bestie. stdin in, stdout out. pipes only, no drama 🎀

---

🦋 DESCRIPTION 🦋

okay so here's the vibe: includeres includes resources — we're talking fonts, procsets, patterns, files, etc. — and it drops them in in place of the %%IncludeResource comments in a PostScript document. so those lil placeholder comments? gone. replaced with the actual goods. slay 💅

when it's hunting for a resource, it looks it up under the resource name, and it also tries it with an appropriate extension. two bites at the apple, as she should.

now THIS pipeline right here is the main character:

extractres file.ps | includeres >out.ps

the way that this works?? it moves all the resources appearing in a document up into the document prologue, and it removes redundant copies while it's at it. so you get one clean copy of everything, all chillin' at the top. no duplicates, no mess, it's giving organized 🧚

and once your output file is looking like that, you can safely run it through page re-arrangement filters like psnup or pstops. safely!!! that's the key word. do it before this and you're asking for trouble, do it after and you're thriving ✨

---

💜 AUTHOR 💜

written by Angus J. C. Duggan. king behavior honestly 👑

---

🌈 SEE ALSO 🌈

• psutils(1) — the whole fam 💖

---

🎀 TRADEMARKS 🎀

PostScript is a trademark of Adobe Systems Incorporated. gotta respect the trademark bestie, that's just the rules 🙈

---

💀 BUGS 💀

okay so heads up: includeres does not alter the %%DocumentNeededResources comments. like, it just doesn't touch em. they stay exactly how they were. so don't come for her about that, she said what she said 😭

---

tl;dr — pipe your extractres output through includeres, get a tidy prologue with no dupes, then go wild with psnup and pstops. and remember: %%DocumentNeededResources comments are staying right where they are. periodt.

---

PSUtils era, includeres(1) chapter — that's a wrap bestie, go make some beautiful PostScript 💖✨🦋🎀💅