debian man page for alliancebanner

ALLIANCEBANNER(3)					       MBK UTILITY FUNCTIONS						 ALLIANCEBANNER(3)

NAME
       alliancebanner - display the standardized Alliance banner

ORIGIN
       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

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

SYNOPSYS
       #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 ouputs on stdout a standardized banner with the name of the tool in large letters, and a cartouche containing some  informa-
       tions 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 propor-
	      tional, 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.

BUG REPORT
       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

ASIM
/LIP6							  October 1, 1997						 ALLIANCEBANNER(3)