x11r4 man page for addlofig

ADDLOFIG(3)						       MBK LOGICAL FUNCTIONS						       ADDLOFIG(3)

NAME
       addlofig - create a new structural cell model

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 "mlo.h"
       lofig_list *addlofig(figname)
       char *figname;

PARAMETER
       figname		   Name of the figure to be created

DESCRIPTION
       addlofig creates a new figure called figname and adds it to the list of figure in memory. The new figure is added in front of the list, and
       becomes	itself the list head. No check is performed to see if a figure with the figname exists on disk. If it is the case, the preexisting
       file will be erased while saving.
       The fields LOCON, LOINS, LOSIG, BKSIG, LOPAR LOTRS and USER are set to NULL.
       The field MODE is set to 'A'.
       The field NEXT points to the previous head of list.

RETURN VALUE
       addlofig returns a pointer to the newly created figure.

ERRORS
       "*** mbk error *** illegal addlofig figure figname already exists"
	      There is already a logical figure called figname in memory, so it's impossible to give this name to a cell to be created.

EXAMPLE
       #include "mlo.h"
       lofig_list *get_the_fig(name)
       char *name;
       {
       lofig_list *pt, *fill_fig(/* lofig_list * */);
	  /* scan figure list */
	  for (pt = HEAD_LOFIG; pt; pt = pt->NEXT)
	     if (!strcmp(pt->NAME, figname))
		break;
	  return pt ? pt : fill_fig(addlofig(figname));
       }

SEE ALSO
       mbk(1), lofig(3), getlofig(3), dellofig(3), loadlofig(3), savelofig(3), flattenlofig(3), rflattenlofig(3).

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						       ADDLOFIG(3)