alliancebanner.3alc - Man Page
display the standardized Alliance banner
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.
- tv
Tool version.
- comment
Indicates the tool's usefulness.
- date
Copyright dates.
- av
Alliance version.
Description
alliancebanner outputs on stdout a standardized banner with the name of the tool in large letters, and a cartouche containing some information about the Alliance CAD system. This function is to be used by all the Alliance tools, and expect a display 80 columns wide.
Example
#include "ba315n.h"
#define nfloptitle(name) \
alliancebanner("nFloP", VERSION,\
"not a FloorPlan router", "92, 93",\
ALLIANCE_VERSION)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 that 80 culumns. This means, since the character set is proportional, that the longest name to be output is about 8 characters long.
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.