.rn '' }`
''' $RCSfile$$Revision$$Date$
'''
''' $Log$
'''
.de Sh
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp
.if t .sp .5v
.if n .sp
..
.de Ip
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.de Vb
.ft CW
.nf
.ne \\$1
..
.de Ve
.ft R

.fi
..
'''
'''
'''     Set up \*(-- to give an unbreakable dash;
'''     string Tr holds user defined translation string.
'''     Bell System Logo is used as a dummy character.
'''
.tr \(*W-|\(bv\*(Tr
.ie n \{\
.ds -- \(*W-
.ds PI pi
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
.ds L" ""
.ds R" ""
'''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
'''   \*(L" and \*(R", except that they are used on ".xx" lines,
'''   such as .IP and .SH, which do another additional levels of
'''   double-quote interpretation
.ds M" """
.ds S" """
.ds N" """""
.ds T" """""
.ds L' '
.ds R' '
.ds M' '
.ds S' '
.ds N' '
.ds T' '
'br\}
.el\{\
.ds -- \(em\|
.tr \*(Tr
.ds L" ``
.ds R" ''
.ds M" ``
.ds S" ''
.ds N" ``
.ds T" ''
.ds L' `
.ds R' '
.ds M' `
.ds S' '
.ds N' `
.ds T' '
.ds PI \(*p
'br\}
.\"	If the F register is turned on, we'll generate
.\"	index entries out stderr for the following things:
.\"		TH	Title 
.\"		SH	Header
.\"		Sh	Subsection 
.\"		Ip	Item
.\"		X<>	Xref  (embedded
.\"	Of course, you have to process the output yourself
.\"	in some meaninful fashion.
.if \nF \{
.de IX
.tm Index:\\$1\t\\n%\t"\\$2"
..
.nr % 0
.rr F
.\}
.TH TELA 1 "Tela-1.31" "9/Mar/2001" "Tela Documentation"
.UC
.if n .hy 0
.if n .na
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.de CQ          \" put $1 in typewriter font
.ft CW
'if n "\c
'if t \\&\\$1\c
'if n \\&\\$1\c
'if n \&"
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
'.ft R
..
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
.	\" AM - accent mark definitions
.bd B 3
.	\" fudge factors for nroff and troff
.if n \{\
.	ds #H 0
.	ds #V .8m
.	ds #F .3m
.	ds #[ \f1
.	ds #] \fP
.\}
.if t \{\
.	ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.	ds #V .6m
.	ds #F 0
.	ds #[ \&
.	ds #] \&
.\}
.	\" simple accents for nroff and troff
.if n \{\
.	ds ' \&
.	ds ` \&
.	ds ^ \&
.	ds , \&
.	ds ~ ~
.	ds ? ?
.	ds ! !
.	ds /
.	ds q
.\}
.if t \{\
.	ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.	ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.	ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.	ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.	ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.	ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
.	ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
.	ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.	ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
.\}
.	\" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.ds oe o\h'-(\w'o'u*4/10)'e
.ds Oe O\h'-(\w'O'u*4/10)'E
.	\" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.	\" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.	ds : e
.	ds 8 ss
.	ds v \h'-1'\o'\(aa\(ga'
.	ds _ \h'-1'^
.	ds . \h'-1'.
.	ds 3 3
.	ds o a
.	ds d- d\h'-1'\(ga
.	ds D- D\h'-1'\(hy
.	ds th \o'bp'
.	ds Th \o'LP'
.	ds ae ae
.	ds Ae AE
.	ds oe oe
.	ds Oe OE
.\}
.rm #[ #] #H #V #F C
.SH "NAME"
tela \- TEnsor LAnguage
.SH "SYNOPSIS"
\fBtela\fR	[\ \fB\-v\fR\ |\ \fB--verbose\fR\ ] [\ \fB\-b\fR\ |\ \fB--batch\fR\ ]
	[\ \fB\-f\fR\ |\ \fB--fast\fR\ ] [\ \fB\-s\fR\ |\ \fB--silent\fR\ ]
	[\ \fB\-p\fR\ |\ \fB--profile\fR\ ] [\ \fB\-O\fR[\fIlevel\fR]\ ]
	[\ \fB\-e\fR\ \fItela-code\fR\ |\ \fB--execute\fR\ \fItela-code\fR\ ] [\ \fIfiles\fR\ ]
.PP
\fBtela\fR \fB\-V\fR\ |\ \fB--version\fR
.PP
\fBtela\fR \fB\-?\fR\ |\ \fB\-h\fR\ |\ \fB--help\fR
.SH "DESCRIPTION"
Start \fBtela\fR; first execute \fItela-code\fR, then each of \fIfiles\fR in
turn (if any), finally enter interactive mode.
.PP
Tela is a numerical computing environment mainly targeted for
numerical simulation pre- and post-processing work.  The language
supports arbitrary rank arrays (hence the name, TEnsor LAnguage), and
has powerful programming capabilities including F90 style vector
notation.  Two- and three- dimensional graphics is implemented by
calling PlotMTV.  For 2D graphics, the SPPC interface is also
available.
.PP
The on-line help is intended as the primary source of documentation.
The command \fBhelp\fR\ \fItopic\fR gives help on \fItopic\fR, where \fItopic\fR
can be individual reserved words, function names, etc.
.SH "OPTIONS"
\fBtela\fR accepts the following options:
.Ip "\fB\-b\fR, \fB--batch\fR" 8
Quit after executing \fItela-code\fR, or \fIfiles\fR.
.Ip "\fB\-e\fR, \fB--execute\fR \fItela-code\fR" 8
Execute Tela expressions \fItela-code\fR.
.Ip "\fB\-f\fR, \fB--fast\fR" 8
Do not source any initialization files; see the section on \fI\s-1INITIALIZATION\s0\fR.
.Ip "\fB\-O\fR[\fIlevel\fR]" 8
Select optimization level.  \fB\-O0\fR, the default, means no
optimization.  \fB\-O\fR, and \fB\-O1\fR enable flat-code optimization.
.Ip "\fB\-h\fR, \fB\-?\fR, \fB--help\fR" 8
Print help message and exit.
.Ip "\fB\-s\fR, \fB--silent\fR" 8
Suppress startup message, \s-1MIPS\s0 count, and \s-1FLOPS\s0 count.
.Ip "\fB\-p\fR, \fB--profile\fR" 8
Collect per-function profiling data (total time, time per call,
\s-1MFLOPS\s0) and output it at the end of the run.
.Ip "\fB\-v\fR, \fB--verbose\fR" 8
Set verbose execution mode: list tree-codes and flat-codes.
.Ip "\fB\-V\fR, \fB--version\fR" 8
Print version number and exit.
.SH "INITIALIZATION"
Unless suppressed with the \fB\-f\fR or \fB--fast\fR options \fBtela\fR tries to
source the file \fItelainit.t\fR (or just \fItelainit\fR if that
exists).  The sourced files are searched in a directory path, which is
obtained as follows:
.Ip "1." 4
A compiled-in default, typically
\f(CW"/usr/local/lib/tela/t:/usr/local/lib/tela/ct:/usr/local/lib/tela:."\fR
.Ip "2." 4
If set, the environment variable \fB\s-1TELAPATH_SYSTEM\s0\fR overrides
the compiled-in default, or appends to it if it starts with a colon.
.Ip "3." 4
Similarly, if set, the environment variable \fB\s-1TELAPATH\s0\fR overrides
the previous, or appends to them if it starts with a colon.
.PP
The combined effect of the compiled-in default, \fB\s-1TELAPATH_SYSTEM\s0\fR,
and \fB\s-1TELAPATH\s0\fR can be seen by giving the command \fBtelapath()\fR in
Tela.
.PP
The standard \fItelainit.t\fR tries to source \f(CW$HOME\fR/\fI.telainit.t\fR.
.SH "ENVIRONMENT"
Besides \fBTELAPATH\fR and \fBTELAPATH_SYSTEM\fR, \fBtela\fR recognizes the
following environment variables: \fBTELA_PLOTMTV\fR specifies the PlotMTV
program to use (default: \f(CWplotmtv\fR).  The function \f(CWwhos()\fR displays
variables and uses the \fBPAGER\fR (default: \f(CWmore\fR) and \fBTELA_SORTER\fR
(default: \f(CWsort\fR\ \f(CW-b\fR\ \f(CW-f\fR\ \f(CW-k\fR\ \f(CW1\fR) environment variables.
.SH "SEE ALSO"
.PP
.Vb 5
\&    telakka     Tela extension utility
\&    ctpp        Tela preprocessor
\&    plotmtv     Standard associated graphics package
\&    sppc        Alternative graphics package
\&    m2t         Matlab to Tela translator
.Ve
.SH "HISTORY"
Tela by Pekka\ Janhunen; man page by Ch.\ L.\ Spiel, 2000-3-9.

.rn }` ''
.IX Title "TELA 1"
.IX Name "tela - TEnsor LAnguage"

.IX Header "NAME"

.IX Header "SYNOPSIS"

.IX Header "DESCRIPTION"

.IX Header "OPTIONS"

.IX Item "\fB\-b\fR, \fB--batch\fR"

.IX Item "\fB\-e\fR, \fB--execute\fR \fItela-code\fR"

.IX Item "\fB\-f\fR, \fB--fast\fR"

.IX Item "\fB\-O\fR[\fIlevel\fR]"

.IX Item "\fB\-h\fR, \fB\-?\fR, \fB--help\fR"

.IX Item "\fB\-s\fR, \fB--silent\fR"

.IX Item "\fB\-p\fR, \fB--profile\fR"

.IX Item "\fB\-v\fR, \fB--verbose\fR"

.IX Item "\fB\-V\fR, \fB--version\fR"

.IX Header "INITIALIZATION"

.IX Item "1."

.IX Item "2."

.IX Item "3."

.IX Header "ENVIRONMENT"

.IX Header "SEE ALSO"

.IX Header "HISTORY"