ALLIANCEBANNER(3)

💖 ALLIANCEBANNER — MBK UTILITY FUNCTIONS 💖

okay bestie, gather round, because this one is literally the little function that makes every Alliance tool say its own name in BIG letters. it's alliancebanner, it lives in the MBK utility functions (that's the 3 on the end, section three, library calls, iykyk), and it is serving main character energy for your terminal. 🎀

---

✨ NAME ✨

alliancebanner — display the standardized Alliance banner. yes that's the whole job and she does it flawlessly. 💅

---

🌸 ORIGIN 🌸

This software belongs to the ALLIANCE CAD SYSTEM, developed by the ASIM team at the LIP6 laboratory of Université Pierre and Marie CURIE, in Paris, France. 🇫🇷✨

• Web: http://asim.lip6.fr/recherche/alliance/
• E-mail: alliance-users@asim.lip6.fr

like, actual legends, at an actual lab, in actual Paris. obsessed. 🫶

---

🦋 SYNOPSIS 🦋

#include "mut.h"
void alliancebanner(tool, tv, comment, date, av)
char ∗tool, ∗tv, ∗comment, ∗date, ∗av;

---

💜 PARAMETERS 💜

• tool — Name of the tool. This is what will be displayed as banner. it's the moment, the whole point, the star of the show. 👑
• tv — Tool version.
• comment — Indicates the tool's usefulness. yes, you literally write your own hype description. iconic.
• date — Copyright dates.
• av — Alliance version.

---

🌈 DESCRIPTION 🌈

alliancebanner outputs on stdout a standardized banner with the name of the tool in large letters, plus a cartouche containing some information about the Alliance CAD system. 🎀

This function is to be used by all the Alliance tools — no exceptions bestie, everybody gets a banner — and it expects a display 80 columns wide. plan accordingly. 📐

---

⭐ EXAMPLE ⭐

#include "ba315n.h"
#define nfloptitle(name) \
        alliancebanner("nFloP", VERSION,\
                       "not a FloorPlan router", "92, 93",\
                       ALLIANCE_VERSION)

look at that macro. look at it. "not a FloorPlan router" as the usefulness comment?? the self-awareness?? ate. 🔥

---

👀 SEE ALSO 👀

• alliance(1).

---

💀 DIAGNOSTICS 💀

• alliancebanner: Error: Resulting size bigger than 80 columns not allowed The tool argument must be such that its resulting size isn't wider than 80 culumns. This means, since the character set is proportional, that the longest name to be output is about 8 characters long. so like, keep it cute and keep it short. 🙈
• alliancebanner: Error: Character out of [0-9A-Za-z] range The tool parameter has a non allowed character in it. For simplicity purposes, only numbers and letters are accepted. no emoji in your tool name bestie, I know, devastating, but rules are rules. 😭

---

🐛 BUG REPORT 🐛

This tool is under development at the ASIM department of the LIP6 laboratory.

We need your feedback to improve documentation and tools. fr fr, they're asking, so tell them. 🫶

---

heads up: those two diagnostics are the only ways this thing yells at you — either your name is too wide for 80 columns (proportional font, ~8 chars max) or you snuck in a character that isn't a number or a letter. that's it, that's the whole vibe check. ✨

---

mwah 💋 this page came to you courtesy of ASIM/LIP6, dated October 1, 1997 — yeah, 1997, she's vintage and she's still slaying — and that's the tea, periodt. 🎀💖