ALLIANCEBANNER(3)

💖 ALLIANCEBANNER(3) 💖

okay so first things first, bestie: this is a page from the MBK UTILITY FUNCTIONS manual, and it's about a little function called alliancebanner. it lives in section 3 (library calls, iykyk). buckle up, this one's short but adorable 🎀

✨ NAME ✨

alliancebanner — displays the standardized Alliance banner. that's it. that's the whole job. and she does it beautifully 💅

🌸 ORIGIN 🌸

so this software belongs to the ALLIANCE CAD SYSTEM, developed by the ASIM team at the LIP6 laboratory of Université Pierre et Marie Curie, in Paris, France 🗼🥐

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

like, actual French academic royalty made this. no cap. 👑

🦋 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 literally what gets displayed as the banner, so make it cute (or at least correct).
• tv — tool version.
• comment — indicates the tool's usefulness. yes, seriously, that's what it's for.
• 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. it's giving "movie title card but for your compiler tool" 🎬✨

this function is to be used by all the Alliance tools (yes, all of them, it's a whole thing), and it expects a display 80 columns wide. so like, don't call it from a tiny terminal and then act surprised, bestie 😭

🍓 EXAMPLE 🍓

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

look at that macro slaying. "not a FloorPlan router" — iconic honesty, fr fr 💀

🔥 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 columns. and since the character set is proportional, this means the longest name to be output is about 8 characters long. yeah. eight. count them. 🙈
• 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, no punctuation, no little symbols, sorry babe 🥲

⚠️ both of these are hard errors, so if you get one, your banner is not happening. no banner for you. fix the string and try again 🫶

🌈 BUG REPORT 🌈

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

we need your feedback to improve documentation and tools. so like, tell them if something's weird!! they literally asked!! 📬💜

and that's the whole page, bestie 🧚 — this one came from ASIM/LIP6, dated October 1, 1997, so she's an elder icon but she still ate 💅✨