PAPERINFO(3)

🌸 NAME 🌸

okay so bestie, welcome to the paperinfo squad 💖 — this whole little crew is here to give you the tea about a paper:

• paperinfo
• paperwithsize
• paperfirst
• paperlast
• papernext
• paperprev

and what do they all do? they return informations about a paper. that's the vibe. periodt. ✨

🎀 SYNOPSYS 🎀

(yes the heading is spelled like that in the original and no i will not be fixing it, it's iconic 💅)

#include <paper.h>

const struct paper* paperinfo(const char* papername)
const struct paper* paperwithsize(double psw, double psh)

char*  papername(const struct paper*)
double paperpswidth(const struct paper*)
double paperpsheigth(const struct paper*)

const struct paper* paperfirst(void)
const struct paper* papernext(const struct paper* pinfo)
const struct paper* paperprev(const struct paper* pinfo)
const struct paper* paperlast(void)

🦋 DESCRIPTION 🦋

so like, let's go one by one, bestie, no gatekeeping 🌈

• paperinfo() — hands you a pointer to a struct paper stuffed with informations about the paper whose name is papername. it's giving "tell me everything about this one specific paper" 👑
• paperwithsize() — this one goes hunting for a paper whose width and height are psw and psh, measured in PostScript points, and then returns a pointer to a struct paper matching the paper it found. lowkey a scavenger hunt 🕵️♀️
• papername() — returns the name of a paper, described by an opaque struct paper object. yes opaque, we don't peek inside, we respect privacy 🫶
• paperpswidth() — returns the width, in PostScript points, of a paper described by an opaque struct paper object.
• paperpsheight() — returns the height, in PostScript points, of a paper described by an opaque struct paper object.
• paperfirst() and paperlast() — they return the first and last entries for papers. first one, last one, bookends fr fr 📚
• and the way you walk through them, entry to entry? that's what papernext() and paperprev() are for, respectively. next and previous, like a little slideshow of papers 🎞️✨

heads up: notice the synopsis says paperpsheigth and the description says paperpsheight. that's just how it is in the original, i'm not touching it, i'm just reporting the facts 💀

👑 SEE ALSO 👑

• paperinit(3)
• paperdone(3)
• defaultpapername(3)
• papersize(5)

and that's the whole page, bestie 💖 this one came from the Library Functions Manual, dated 24 September 1996 — yes she's vintage, she's classic, she's iconic ✨ go forth and look up your papers 🎀🦋💜