next up previous
Next: simmake Up: simula Previous: simula

SIMCOMP


     NAME
	  simcomp - compile a Simula main program or separate
	  class/procedure

     SYNOPSIS
	  simcomp filename [-L=path] [-I=path] [-l] [-f] [-r] [-h]
		  [-list] [-e] [-w] [-x] [-z]

     DESCRIPTION
	  The normal action of the Simula  compiler  is	 to  read  the
	  input	 file and translate it into an object code file	and an
	  attribute  information  file.	 This  normal  action  can  be
	  changed by the use of	options.

	  All produced files have the same name	as the input file, but
	  with different extensions. The object	code file is given the
	  extension '.o'.  The attribute  information  file  is	 given
	  extension '.atr'. This file contains information used	by the
	  debugger and for separate compilation.

	  If errors are	detected, they are listed at the  end  of  the
	  compilation. Errors are by default listed on standard	error.

	  The filename can be givien with  or  without	the  extension
	  '.sim'. It must be present.

     OPTIONS
	  Options may appear in	any order.


	  -L=<dir1:dir2:...>
	       Colon separated list of directories of where to	search
	       for  libraries,	specified  by  the  -I=	option.	Search
	       order is:  this environment variable is concatenated to
	       the  content  of	 the  -L= option. Useful for a default
	       path to be used in a series of compilations.


	  -I=<lib1:lib2:...>
	       Colon separated list of libraries of  where  to	search
	       for  Simula attribute files and include files. The full
	       pathname	of the libraries are identified	 by  searching
	       the  directory searchlist defined by the	-L= option and
	       the SIM_LIBRARY_PATH environment	variable.  The	result
	       is  the	library	 searchpath  with one element for each
	       item  in	 the  -I=   parameter:	 '.',	<dirn>/<lib1>,
	       <dirn>/<lib2>, ...


	  -l   Include a search	of the libraries  installed  with  the
	       Lund	  Simula       system.	    Shorthand	   for
	       -L=/usr/local/simulabin -I=simlib:libsim:...

	  -f   Report all files	read  during  compilation.  Useful  to
	       sort out	binding	of dependencies	on external files.


	  -r   Specifies recompilation,	the compilation	is aborted  if
	       the  interface part of the attribute file would need to
	       be changed.


	  -h   Line numbers inhibited. Do not  produce	code  to  take
	       care  of	 line  numbers	during	run  time. This	option
	       should be used only in fully tested programs, since  it
	       makes   use   of	  several  of  the  debugger  commands
	       impossible. The benefits	resulting from use  of	the  h
	       option are savings in object code size and in execution
	       time.


	  -l   ist Listing. Produce a list file	with the same name  as
	       the  input  file, but with extension '.lis' It contains
	       the  source  program  text,  line  numbers  and	 error
	       messages.  file.lis  will  be  produced,	 even  if  the
	       compiler	was stopped by a fatal error.


	  -e   Error listing. Produce  an  error  list	on  file  with
	       extension   '.err'.    This   is	 really	 the  same  as
	       redirecting standard error.  The	 error	list  normally
	       appearing  on  the terminal is written to the file with
	       extension '.err'	instead.


	  -w   Warning	messages  inhibited.  Normally	at   most   64
	       warnings	  and	errors	will  be  produced,  then  the
	       compilation is aborted. With the	w option all  warnings
	       will  be	inhibited and not counted in the sum of	errors
	       and warnings. Even when warning messages	are  inhibited
	       the  number  of	warnings will be printed at the	end of
	       the compilation.


	  -x   Direct error messages. Error messages will  be  written
	       on  the console as soon as the errors are detected. The
	       message will give less information than that at the end
	       of  pass	 five.	This  option  is  mainly  intended for
	       implementor use,	but can	be useful if the compiler  for
	       some  reason  can  not  complete.  See  Appendix	 D for
	       matching	error numbers with error messages.


	  -z   Symbolic	  intermediate	  code.	   Produce    symbolic
	       intermediate  code  on  the  file with extension	'.zr'.
	       This option is mainly intended for implementor use.

     SEE ALSO
	  simman simmake - to compile several dependent	Simula modules

	  simman simld - to  link  compiled  Simula  modules  into  an
	  executable program

	  simman simula	- to  get  overview  and  pointers  to	Simula
	  libraries