NAME

alliancebanner - display the standardized Alliance banner

See the file man1/alc_origin.1.

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)

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.