1ALLIANCEBANNER(3)            MBK UTILITY FUNCTIONS           ALLIANCEBANNER(3)
2
3
4

NAME

6       alliancebanner - display the standardized Alliance banner
7

SYNOPSIS

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

PARAMETERS

14       tool                Name  of  the tool.  This is what will be displayed
15                           as banner.
16
17       tv                  Tool version.
18
19       comment             Indicates the tool's usefulness.
20
21       date                Copyright dates.
22
23       av                  Alliance version.
24

DESCRIPTION

26       alliancebanner outputs on stdout a standardized banner with the name of
27       the  tool in large letters, and a cartouche containing some information
28       about the Alliance CAD system.  This function is to be used by all  the
29       Alliance tools, and expect a display 80 columns wide.
30

EXAMPLE

32       #include "ba315n.h"
33       #define nfloptitle(name) \
34               alliancebanner("nFloP", VERSION,\
35                              "not a FloorPlan router", "92, 93",\
36                              ALLIANCE_VERSION)
37

SEE ALSO

39       alliance(1).
40
41
42

DIAGNOSTICS

44       alliancebanner:  Error:  Resulting  size  bigger  than  80  columns not
45       allowed
46              The tool argument must be such that  its  resulting  size  isn't
47              wider  that  80 culumns.  This means, since the character set is
48              proportional, that the longest name to  be  output  is  about  8
49              characters long.
50       alliancebanner: Error: Character out of [0-9A-Za-z] range
51              The  tool parameter has a non allowed character in it.  For sim‐
52              plicity purposes, only numbers and letters are accepted.
53
54
55
56
57
58ASIM/LIP6                       October 1, 1997              ALLIANCEBANNER(3)