===========================================================
NAME
ftn - compile a fortran program
SYNOPSIS
ftn name [-options]
DESCRIPTION
ftn translates a fortran source file into one or more binary object
modules, which can be executed or used as input to the binder. Source
files may be a maximum of 32767 lines long. For complete information,
see the Domain Fortran Language Reference.
ARGUMENTS
source_file (required)
Specify the source file to be compiled. If you specify the
pathname without an .ftn suffix, the compiler automatically
appends .ftn, and searches for that filename. If not found, it
searches for the pathname that you typed. If not found, the
compiler reports an error.
OPTIONS
-ac (default)
Compile using absolute code.
-pic Compile using Position Independent Code.
-align (default)
Use longword alignment. Obsolete switch.
-nalign
No longword alignment. Obsolete switch.
-b [file] (default)
Generate binary file. If pathname is omitted, use source_file.bin.
-nb Suppress binary file.
-cond
Compile lines with D in column 1.
-ncond(default)
Ignore lines with D in column 1.
-config name1 name2...
Conditional processing: compile statements associated with name1,
name2, etc. via conditional compiler directives.
-cpu id
Generate code for a particular class of processors. Values for id
are
ANY (D)
Generate code which uses only the basic instructions supported by
the M68000.
160,460,660
Generate code which uses the additional instructions supported by
DNx60 (except the DN560) and DSP160 processors.
90, 330, 560, 570, 580, 3000
Generate code which uses the additional instructions supported by
the DSP90, DN330, DN560, DN570, DN580, and DN3000 processors.
PEB Generate code for a Performance Enhancement Board.
fpx Generate code for workstations with a floating-point accelerator
(FPX) -- includes the DN570-T and DN580-T.
-db (default)
Generate runtime debug line number table (for traceback).
-dbs Generate full runtime debug tables with symbol table. NOTE: This
option does not affect the -opt level.
-dba Identical to -dbs except that no optimization is performed, even if
you also specify -opt.
-ndb Suppress runtime debug tables.
-dynm (default)
Allocate local variables on stack if possible.
-save
Allocate all local variables in static space.
-exp Generate expanded code listing (implies -l). NOTE: You can not use
-exp and -xref on the same command line.
-nexp (default)
Suppress expanded code listing.
-ff Activate free format: length of source lines may be upt to 1024
characters; an ampersand (&) in column 1 specifies a continuation
line.
-frnd
Store and round floating point numbers before comparisions.
-nfrnd (default)
Do not round floating point numbers.
-i*2 2-byte integer is default integer type.
-i*4 (default)
4-byte integer is default integer type.
-idir pathname
Add a pathname to the search hierarchy of directories for include
file names. The hierarchy applies only to file name strings which
do NOT begin with '.', '~', or '/'. Up to 63 -idir options may be
given. The compiler first tries to open the include file name as
given. Failing that, it prefixes the given include file name with
the -idir pathnames in the same order as supplied on the command
line.
-indexl
Use 32 bit indexing on all common and dummy argument arrays.
-nindexl (default)
Indexing based on dimension information.
-info [n]
Default is n=2. Display information messages to nth level.
-inlib [pathname
Load pathname (a pic binary file) at runtime and resolve global
references.
-inline char
Select specified character ("char") as in-line comment designator.
-l [file]
Generate compilation listing. If pathname is omitted, use
source_file.lst.
-nl (default)
Suppress compilation listing.
-l*1 1-byte logical is default logical type.
-l*2 (default)
2-byte logical is default logical type.
-l*4 (default)
4-byte logical is default logical type.
-msgs (default)
Generate final error and warning count message.
-nmsgs
Suppress final error and warning count message.
-opt [n] (default)
Perform global optimization. 'n' is a single digit integer in the
range 0 to 4, indicating the level of optimization performed. If 'n'
is omitted, 3 is the default level. -opt 0 is identical to the
obsolete switch -nopt. -opt 3 is identical to the obsolete switch
-optall. Increasing the optimization level results in faster
execution of your program, at the expense of longer compilation
time. Special restrictions apply to the use of -opt 4. See the
Domain fortran Language Reference manual for details.
-optall
Perform global program optimization. Obsolete switch. Use -opt 3.
-nopt
Suppress global optimization. Obsolete switch. Use -opt 0.
-peb Generate inline code for Performance Enhancement Board. Obsolete
switch. Use -cpu peb.
-npeb (default)
No inline code for Performance Enhancement Board. Obsolete switch.
Use -cpu any.
-subchk
Subscript checking.
-nsubchk (default)
Suppress subscript checking.
-type
Flag all variables and functions not explicitly typed.
-ntype (default)
Suppress type checking.
-u Turn on case sensitivity for identifiers.
-uc Turn on UNIX* Compatibility features: appended underscore to
subprogram and common block names; UNIX version of default
filenames.
-version
Display version number of compiler.
-warn (default)
Display warning messages.
-nwarn
Suppress warning messages.
-xref
Generate symbol table map and cross reference (implies -l). NOTE:
You can not use -exp and -xref on the same command line.
-nxref (default)
Suppress symbol table map and cross reference.
-xrs (default)
Save registers across a call to an external procedure or function.
-nxrs
Do not assume that calls to external routines have saved the
registers.
-zero
Initialize static storage to zero.
-nzero (default)
No implicit initialization of static storage to zero.
EXAMPLES
$ ftn graph.line -l Compile source file graph.line.ftn
in the current working directory;
produce binary graph.line.bin and
list file graph.line.lst, also in
current working directory.