LOWDOWN_NROFF_FREE(3)

💅 LOWDOWN_NROFF_FREE(3) 💅

okay bestie, sit down, hydrate, and let's talk about lowdown_nroff_free — she's the cleanup queen of the Markdown roff renderer world 👑

and yes, she lives in the library liblowdown ✨

---

🌸 SYNOPSIS 🌸

like, here's how you summon her, fr fr:

#include <sys/queue.h>
#include <stdio.h>
#include <lowdown.h>

void
lowdown_nroff_free(void *arg);

---

🎀 DESCRIPTION 🎀

So basically? She frees the roff renderer that you made earlier with lowdown_nroff_new(3). That's it. That's the whole job. And honestly? Iconic. No drama, no notes 💅

and if arg is NULL? She literally just does nothing. no crash, no vibe check fail, just vibes 🦋

---

✨ EXAMPLES ✨

here's the moment you've been waiting for — the glow-up sequence 💖 This parses b of length bsz and outputs in groff_ms(7) format:

struct lowdown_buf *out;
struct lowdown_doc *doc;
struct lowdown_node *n;
void *rndr;

if ((doc = lowdown_doc_new(NULL)) == NULL)
        err(1, NULL);
if ((n = lowdown_doc_parse(doc, NULL, b, bsz, NULL)) == NULL)
        err(1, NULL);
if ((out = lowdown_buf_new(256)) == NULL)
        err(1, NULL);
if ((rndr = lowdown_nroff_new(NULL)) == NULL)
        err(1, NULL);
if (!lowdown_nroff_rndr(out, rndr, n))
        err(1, NULL);

fwrite(out->data, 1, out->size, stdout);

lowdown_nroff_free(rndr);
lowdown_buf_free(out);
lowdown_node_free(n);
lowdown_doc_free(doc);

see how she shows up at the end to clean up? that's main character energy, that's knowing when to exit the group chat 😌✨

---

🫶 SEE ALSO 🫶

• lowdown(3)
• lowdown_nroff_new(3)

---

🧚 a lil lore drop, bestie 🧚

this one uses both the original troff man macros for Version 7 AT&T UNIX, defined in man(7), and the man-ext groff extensions. and guess what — both of them are implemented in mandoc 👑

the troff ms macros are defined in groff_ms(7), along with the mspdf groff extensions described in "Portable Document Format Publishing with GNU Troff" by Keith Marshall. and those two? neither are implemented in mandoc 💀 so like, know that going in, okay?

---

lowkey the whole thing is giving "clean up after yourself" and honestly we love a responsible queen 🌈

and that's the tea 🍓 this page came from Debian, version $Mdocdate$ — mwah, periodt 💖👑