User Reference Manual

There must be a newline after ! in the starting line and ! must be the first character in the last line. A so defined string always contains a linefeed at end. The backslash is no longer used as escape character with one exception: protecting a ! at beginning of line to be interpreted as string termination. This construction of strings may be used anywhere inside an expression.

Comments are skipped and preprocessor directives are interpreted inside this string definitions.

For example: you can write

str s = string !
#include "file"
!;

to get the file file included in the string s.

Note, that in EFEU (and so in esh) null strings (character pointer to NULL) can be used like ordinary strings and there is a difference between null strings and empty strings (strings containing only the terminating 0) are handled . The EFEU libraries contains tools for handling dynamic allocated strings and you can mix them with constant strings. The memory allocation tools in EFEU knows, if the memory of a string could be freed.

Pointer types

Data types, which are implemented by pointers, assign only the pointer address and do not copy the data (strings are an exception). But they use a reference counter for garbage collection. If the pointer is no more used, the whole memory allocated to this pointer is freed. All this types are subclasses of the type _Ref_.

The type _Ref_ and all other types with a pointer representation in C are subclasses of _Ptr_. This is also the type of the constant NULL.

Types which starts and ends with the underline symbol are reserved for internal use. Normally, you don't declare variables of this type. But this types may be used for arguments in virtual functions, e.g. to distinguish between the constant NULL and a string initialized with NULL.

Lists

Lists are a ordered set of any data variables. The have the data type List_t. There are three ways to get lists in the EFEU interpreter language:

1. with the list grouping operator: { 3, 5 }. You can not use it at begin of a statement because { is also used for grouping expressions.
2. with the list operator: 3, 5. Note the low priority of the list operator. You need parentheses to use it in terms. You get only lists of at least two elements.
3. with the range operator: 3 : 5 : 2. All members of the list have the same type.

obj

returns the first entry of the list or NULL for empty lists.

next

returns the sub list starting with the next element or an empty list, if there are no more elements.

Data fields

Data fields may be declared in one of the two possible forms:

type name[dim]

declares name as a field of type type.

type[dim] name

declares name as a scalar of type type[dim].

In the second case 0 or a missing value of dim indicates a variable length array. The data field is implicit enlarged as you use a higher index. Data types of the form type[] are subclasses of EfiVec.

If you have more then one dimension, a declaration of the form

type name[n0][n1]...[nk];

type[nk]...[n1 name[n0];

Data fields are always packed into a object of type EfiVec on use. A data field can always be converted to a list and you can assign values to a data field with a list. If the list has less elements than the data field, only the corresponding elements are changed.

EFEU provides you the following data types for a more powerful handling of data than ordinary data fields:

TimeSeries

are dynamic fields of type double with a time index.

mdmat

holds a data cube of any type with unlimited number of dimensions, only restricted by available memory. EFEU contains a lot of tools for handling such data cubes.

Creating new data types
The simplest way to create a new type is typedef, as in

typedef int myint;

Structures are created with the struct statement. The syntax is

struct type [: base [ name ]] { type declarations }

The following two types

struct T1 {
        int a;
        int b;
}

struct T2 : int a {
        int b;
}

have the same components, but T2 can be used as representation of an integer.

Any previously defined type can be used in this form of type declaration. Any structure type could be converted to a list and any list with corresponding elements could be converted to a structure type.

Example for a more complex structure:

struct MyDataType {
        int i;
        double d;
        str s;
        int v[10];
};

The EFEU interpreter supports enumeration types. The syntax is

enum type [: base [ name ]] { identifier list }

The following statement:

enum Color { Red, Green = 5, Blue };

Color c1 = "Red";
Color c2 = 0;
str s = Color::Red;
int n = Color::Red;

The function enumlist(type) returns a list of all valid identifiers of the enumeration type type or an empty list, if type has no identifiers or is not an enumeration type.

FUNCTION DECLARATION

A function declaration in esh has the general form

type name ( arglist )
        expr

Normally expr is a block structure, but in esh you can also use a single (but not empty) expression. If the function does not return any value, use the special type void.

The following function declarations are equivalent:

int f (int x) x + 1;
int f (int x) return x + 1;
inline int f (int x) { return x + 1; }

In esh, the keyword inline has nothing to do with optimation, but with visibility. A inline function sees all variable tables as in the line where it is called. All functions defined with a single expression are default of type inline.

Here is a example where inline functions are needed:

inline str f (str fmt)
{
        return psub(fmt);
}

{
        str x = "foo";
        f("x = $(x)");
}

The function psub substitutes parameter according to a format string. If f is not inline, psub does not see the variable x and the substitution $(x) would fail.

Functions have the type Func and you can use it like function pointers in C. Typing the function name in outermost level gives you the prototype of the function.

As in C++ function arguments may have default values. The general form of a function argument is:

type [ & ] name [ = value ]

Behind the most operators stands a function with the name of the operator. You can use either operator "name" or operatorname<space> for such function names. For example: operator+ is the name of the addition function. Function names of prefix operators have an additional »()« in the name to distinguish between postfix and binary operators. So operator+() is the name of the unary plus.

Virtual functions

As in C++, you can overload functions with different argument lists. The keyword virtual is used to declare virtual functions. They have the data type VirFunc. Any function can be converted to a virtual function.

You can convert a virtual function to a regular function with a prototype cast:

Func f = operator+ (int a, int b);;

Now you can use f to add two integer values. Note the two semicolons: The first is part of the prototype, the second terminates the expression and may be replaced by a linefeed.

Type bound functions

Functions may be bound to an specific type. They have the general form

type btype::name [ & ] ( arglist )
        expr

The & after the function name indicates that it can only be used for lvalues. A bounded function is called

obj.name(args)

where obj is an object of type btype. Object bound functions have the type ObjFunc and may be virtual or not.

All assignment operators are bounded functions. In bounded functions you can use this to refer to the corresponding object.

Special Functions

Functions which have the same name as a type, defines constructors and converters.

Constructors have the form:

virtual type type ( arglist )

type type ()

The declaration

type type (void)

Converters have the form:

tg_type src_type ()

Because of internal garbage collection, there is normally no need on copy constructor and destructor. You must be very carefully in defining this functions, because you get an infinite recursive call if an object of the type is copied inside the function.

MISSING SOMETHING

If you are missing something in the documentation, you may get it from esh. The option --info provide an interface to builtin information, just enter the command esh --info. If you are running esh in interactive mode, you can get the information with the function call Info().

If you want to know how a function is used, just enter the function name and the prototype is displayed. For a data type type you can call the function type.info() to get additional information's.

global

is the table of global variables

local

is the table of local variables. In outermost level local is identical to global.

give you information about the argument. returns the type of an variable.

show the current stack of the variable tables.

give you a list of all data types.

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

ESHPATH

define extra directories for searching script headers.

COPYRIGHT
Copyright (C) 1994, 2001 Erich Frühstück

findgrep(1)

SYNOPSIS

findgrep [ --help[=type] ] [ --version ] [ grep-options ] [ pat | -e pat | -f file ] dir [ find-options ]

DESCRIPTION

The command findgrep search patterns with grep in a list of files collected by find. To avoid environment space overflow xargs is used to execute grep. The grep options are passed through and not checked.

Find is called with the flags -type f and -print. If supported, -print is replaced by -print0. This allows to handle files with special characters like spaces.

SEE ALSO

grep(1), find(1), xargs(1).

COPYRIGHT

Copyright (C) 2001 Erich Frühstück

htmlindex(1)

SYNOPSIS

htmlindex [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ name ]

DESCRIPTION

The following options and arguments are accepted from command htmlindex:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

name

output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 2001 Erich Frühstück

mdcat(1)

SYNOPSIS

mdcat [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -T title ] [ -n name ] [ -m map ] [ -o out ] [ file(s) ]

DESCRIPTION

The following options and arguments are accepted from command mdcat:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-T title

set title of output file

-n name

name of axis, default X

-m map

create file mapping

-o out

output file

file(s)

input file(s)

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdcmp(1)

SYNOPSIS

mdcmp [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -F file ] [ -E expr ] [ -f func ] [ -e expr ] [ -r ] [ -v var ] [ -T title ] file1 file2 { name=var } [ aus ]

DESCRIPTION

The following options and arguments are accepted from command mdcmp:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-F file

execute command lines in file file

-E expr

evaluate expression expr

-f func

compare function

-e expr

compare expression

-r

remove singular axis

-v var

select type components

-T title

set title of output file

file1

name of first data cube

file2

name of second data cube

name=var

selection parameter

aus

output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdcreate(1)

SYNOPSIS

mdcreate [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -v value ] [ -T title ] [ -m map ] type { name=var } [ aus ]

DESCRIPTION

The following options and arguments are accepted from command mdcreate:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-v value

default value

-T title

set title of output file

type

type of data

-m map

create file mapping

name=var

list of axis

aus

name of output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mddiag(1)

SYNOPSIS

mddiag [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -r ] [ -v var ] [ -T title ] [ -x axis ] [ -m map ] ein { name=var } [ aus ]

DESCRIPTION

The following options and arguments are accepted from command mddiag:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-r

remove singular axis

-v var

select type components

-T title

set title of output file

-x axis

name of axis

-m map

create file mapping

ein

input file

name=var

selection parameter

aus

output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mddiff(1)

SYNOPSIS

mddiff [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -E expr ] [ -F file ] [ -r ] [ -v var ] [ -p prec ] file1 file2 { name=var } [ out ]

DESCRIPTION

The following options and arguments are accepted from command mddiff:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-E expr

evaluate expression expr

-F file

execute command lines in file file

-r

remove singular axis

-v var

select type components

-p prec

precision of floating numbers

file1

name of first data cube

file2

name of second data cube

name=var

selection parameter

out

name of output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1998, 2001 Erich Frühstück

mdfile(1)

SYNOPSIS

mdfile [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -a ] [ -s ] [ -h ] [ -d ] [ -X ] [ -x ] [ -l ] [ file(s) ]

DESCRIPTION

The following options and arguments are accepted from command mdfile:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-a

status of all files

-s

show structure of data cube

-h

show type and header

-d

show description

-X

short axis list

-x

verbose axis list

-l

long listing, equivalent to -hdx

file(s)

files

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdfunc(1)

SYNOPSIS

mdfunc [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -F file ] [ -E expr ] [ -r ] [ -m map ] [ -v var ] [ -T title ] [ --neg ] [ --not ] [ --cpl ] [ --rnd ] [ -f func ] [ -t type ] [ -e expr ] [ -x list ] [ -p prec ] file { name=var } [ out ]

DESCRIPTION

The following options and arguments are accepted from command mdfunc:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-F file

execute command lines in file file

-E expr

evaluate expression expr

-r

remove singular axis

-m map

create file mapping

-v var

select type components

-T title

set title of output file

--neg

negation

--not

Boolean not

--cpl

bitwise complement

--rnd

round to nearest integer

-f func

function/operator

-t type

data type

-e expr

expression

-x list

list of column axis, default "#-1"

-p prec

floating number precision

file

input file

name=var

selection parameter

out

output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdmul(1)

SYNOPSIS

mdmul [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -F file ] [ -E expr ] [ -r ] [ -m map ] [ -v var ] [ -T title ] [ -n dim ] [ -x axis ] [ -a name=var ] [ -b name=var ] file1 file2 { name=var } [ out ]

DESCRIPTION

The following options and arguments are accepted from command mdmul:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-F file

execute command lines in file file

-E expr

evaluate expression expr

-r

remove singular axis

-m map

create file mapping

-v var

select type components

-T title

set title of output file

-n dim

number of common axis

-x axis

name of common axis

-a name=var

selection parameter for first input file

-b name=var

selection parameter for second input file

file1

name of first data cube

file2

name of second data cube

name=var

selection parameter for both data files

out

output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdpaste(1)

SYNOPSIS

mdpaste [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -r ] [ -m map ] [ -v var ] [ -T title ] [ -s ] [ -u ] [ -e expr ] [ -n name ] [ -o aus ] { name=var } file(s) ...

DESCRIPTION

The following options and arguments are accepted from command mdpaste:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-r

remove singular axis

-m map

create file mapping

-v var

select type components

-T title

set title of output file

-s

sort labels of axis

-u

sort labels of axis, use only last of repeated labels

-e expr

expression for comparing, default is "cmp(a,b)".

-n name

name of axis for pasting, default is #1

-o aus

output file

name=var

selection parameter

file(s) ...

list of input files.

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdpermut(1)

SYNOPSIS

mdpermut [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -r ] [ -v var ] [ -T title ] file { name=var } [ out ] [ name(s) ]

DESCRIPTION

The following options and arguments are accepted from command mdpermut:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-r

remove singular axis

-v var

select type components

-T title

set title of output file

file

input file

name=var

selection parameter

out

output file

name(s)

name of axis to order first

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdprint(1)

SYNOPSIS

mdprint [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -F file ] [ -E expr ] [ -M mode ] [ --ascii ] [ --csv ] [ --tex ] [ --tab ] [ --data ] [ --sc ] [ --std ] [ --ps ] [ --psq ] [ --lp ] [ --lpq ] [ --mark ] [ --nomark ] [ -h ] [ -b ] [ -H ] [ -t ] [ -z ] [ -L loc ] [ --locale loc ] [ -f font ] [ -l width ] [ -3 ] [ -w width ] [ -p prec ] [ -d delim ] [ -g ] [ -e ] [ -x list ] [ -s list ] [ -r ] [ -R list ] [ -v var ] [ -T title ] [ -P name=list ] [ --paste name=list ] [ --paste-delim key ] [ -S list ] [ --split list ] file { name=var } [ out ]

DESCRIPTION

The following options and arguments are accepted from command mdprint:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-F file

execute command lines in file file

-E expr

evaluate expression expr

-M mode

set output mode, default is "std"

--ascii

prepare as ascii file

--csv

prepare for excel

--tex

prepare for LaTeX

--tab

prepare for LaTeX tabular environment

--data

print only data values

--sc

output sc spreadsheet

--std

fixed column alignment

--ps

output PostScript file

--psq

output PostScript file in landscape

--lp

print data cube

--lpq

print data cube in landscape

--mark

mark column marker as comment

--nomark

suppress column marker

-h

show header only

-b

show data only

-H

show complete header

-t

show only title in header

-z

suppress 0 values

-L loc, --locale loc

set locale for number format to loc

-f font

font size in point

-l width

width of line label

-3

align exponent to multiples of 3

-w width

field width for values

-p prec

floating number precision

-d delim

delimiter of lists

-g

use universal float format

-e

use exponential float format

-x list

mark axis as column

-s list

accumulate list of axis

-r

remove singular axis

-R list

remove singular axis from List list

-v var

select type components

-T title

set title of output file

-P name=list, --paste name=list

paste list list of axis to new axis name

--paste-delim key

delimiter for pasting axis, default: _

-S list, --split list

split data matrix by axis list.

file

input file

name=var

selection parameter

out

output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdread(1)

SYNOPSIS

mdread [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -x name ] [ -y name ] [ -t type ] [ -M ] [ -L loc ] [ --locale loc ] [ --sc ] [ -r ] [ -m map ] [ -v var ] [ -T title ] file { name=var } [ out ]

DESCRIPTION

The following options and arguments are accepted from command mdread:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-x name

column axis name(s)

-y name

row axis name(s)

-t type

data type

-M

check magic number

-L loc, --locale loc

set locale for number format to loc

--sc

convert sc spreadsheet

-r

remove singular axis

-m map

create file mapping

-v var

select type components

-T title

set title of output file

file

input file

name=var

selection parameter

out

output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdround(1)

SYNOPSIS

mdround [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -r ] [ -m map ] [ -v var ] [ -T title ] [ -s val ] [ -m val ] file { name=var } [ out ]

DESCRIPTION

The following options and arguments are accepted from command mdround:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-r

remove singular axis

-m map

create file mapping

-v var

select type components

-T title

set title of output file

-s val

adjust data sum to value val

-m val

scalar multiplication with value val

file

input file

name=var

selection parameter

out

output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdselect(1)

SYNOPSIS

mdselect [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -F file ] [ -E expr ] [ -r ] [ -m map ] [ -s list ] [ -v var ] [ -T title ] ein { name=var } [ aus ]

DESCRIPTION

The following options and arguments are accepted from command mdselect:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-F file

execute command lines in file file

-E expr

evaluate expression expr

-r

remove singular axis

-m map

create file mapping

-s list

accumulate list of axis

-v var

select type components

-T title

set title of output file

ein

input file

name=var

selection parameter

aus

output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdsum(1)

SYNOPSIS

mdsum [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -r ] [ -v var ] [ -T title ] in out { name=var } [ name(s) ]

DESCRIPTION

The following options and arguments are accepted from command mdsum:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-r

remove singular axis

-v var

select type components

-T title

set title of output file

in

input file name

out

output file name

name=var

selection parameter

name(s)

name of axis to cumulate

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mdterm(1)

SYNOPSIS

mdterm [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -F file ] [ -E expr ] [ --add ] [ --sub ] [ --mul ] [ --div ] [ --min ] [ --max ] [ -f func ] [ -t type ] [ -e expr ] [ -p prec ] [ -r ] [ -m map ] [ -v var ] [ -T title ] file1 file2 { name=var } [ out ]

DESCRIPTION

The following options and arguments are accepted from command mdterm:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-F file

execute command lines in file file

-E expr

evaluate expression expr

--add

cell by cell addition

--sub

cell by cell subtraction

--mul

cell by cell multiplication

--div

cell by cell division

--min

cell minimum

--max

cell maximum

-f func

cell by cell function/operator

-t type

data type

-e expr

expression

-p prec

floating number precision

-r

remove singular axis

-m map

create file mapping

-v var

select type components

-T title

set title of output file

file1

name of first data cube

file2

name of second data cube

name=var

selection parameter

out

output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1997, 2001 Erich Frühstück

mksource(1)

SYNOPSIS

mksource [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -I dir ] [ -s ] [ -V ] [ -v ] [ -l ] [ -L name ] [ -r ] [ -x ] [ --all name ] [ --clean name ] [ --depend name ] [ --lock ] [ --unlock ] [ -d ] [ -D name ] [ -n name ] [ -h ] [ -c ] [ -H hdr ] [ -C src ] [ -t ] [ -T doc ] name

DESCRIPTION

The following options and arguments are accepted from command mksource:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-I dir

appends dir to the search path for scripts.

-s

silent execution

-V

little verbose

-v

verbose

-l

create list of targets

-L name

create list of targets for name

-r

create rule

-x

no pseudo targets for make

--all name

target name

--clean name

clean target name

--depend name

depend target name

--lock

lock file creation

--unlock

unlock file creation

-d

make dependence

-D name

make dependence for target name

-n name

base name for created files

-h

create header

-c

create source

-H hdr

create header with name hdr

-C src

create source with name src

-t

(obsolete) create TeX documentation, lock other outputs

-T doc

(obsolete) create TeX documentation doc, lock other outputs

name

script

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 1994 Erich Frühstück

mksrclist(1)

SYNOPSIS

mksrclist [ --help[=type] ] [ --version ] [ -f ] [ -x ] [ -e pat ] top [ name ]

DESCRIPTION

The command mksrclist creates a list of files unter top.

The following options and arguments are accepted from command mksrclist:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

-f

force creation of output file

-x

consider source generation with mksource.

-e pat

ignore files which maches pattern pat

top

top directory of sources

name

name of output file to update

SEE ALSO
shmkmf(1), d2m.smh(7).

DIAGNOSTICS

The command mksrclist returns 2 on an error in creating the source list. If the source list is new or it hase changed, the return code is 1. Otherwise the return code is 0.

COPYRIGHT

Copyright (C) 2000 Erich Frühstück

pp2dep(1)

SYNOPSIS

pp2dep [ --help[=type] ] [ --version ] [ -l ] [ -x pattern ] [ target(s) ]

DESCRIPTION

The command pp2dep greps the names of included files from the output of the C preprocessor and creates a dependend list for given targets.

The following options and arguments are accepted from command pp2dep:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

-l

list only local files

-x pattern

Exclude files which match pattern.

target(s)

list of targets

file.o: file.c
        $(CC) -c file.c

depend::
        $(CC) -E -c file.c | pp2dep -l file.o >> Makefile

SEE ALSO

cc(1), make(1), shmkmf(1).

shmkmf(1)

SYNOPSIS

shmkmf [ --help[=type] ] [ --version ] [ -v ] [ -i ] [ -p ] [ -c string ] [ -x ] [ -r arg ] [ -t top ] [ -C dir ] [ -I dir ] [ config ] [ makefile ]

DESCRIPTION

The command shmkmf creates a Makefile from the script Config.make. The following options and arguments are accepted from command shmkmf:

The following optionms and arguments are accepted by shmkmf:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

Predefined variables

IncludePath

Search Path for include files.

Name of Configuartion file.

Name of target file.

Name of C-compiler

SEE ALSO

ccmkmf(1).

shmkmf-cflags(1)

SYNOPSIS

shmkmf-cflags [ --help[=type] ] [ --version ] [ -m[name] ] [ -I[path] ] [ -L[path] ] [ -a ] [ -o ] [ -l lib ] [ name ]

DESCRIPTION

The following options and arguments are accepted from command shmkmf-cflags:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

COPYRIGHT
Copyright (C) 2008 Erich Frühstück

shmkmf-config(1)

SYNOPSIS

shmkmf-config [ --help[=type] ] [ --version ] [ -v ] [ -x ] [ -s ] [ -c name ] [ -i hdr ] [ -I hdr ] [ -r hdr ] [ -f flgs ] cmd [ arg(s) ]

DESCRIPTION

The command shmkmf-config is used to determine system specific parameters. The normal use is to to process a C header template with special test instructions. The instructions are isolated by awk and are evaluated by a call to shmkmf-config.

Some tests create c-sources and checks the compilation status. If the -x flag is set, the created program is executed and its output is inserted.

The following options and arguments are accepted from command shmkmf-config:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

-v

display this help and exit

-x

execute compiled command

-s

read function body from standard input

-c name

C-Compiler

-i hdr

header for source

-I hdr

header for source if exists

-r hdr

header for shmkmf

-f flgs

compiler flags

cmd

command to perform

arg(s)

command specific arguments

Every occurance of @SRC@ in the template file would be replaced by the name of the template file and @CMD@ by shmkmf-config. The following keywords at start of a line are accepted:

@set flags

sets options for the following calls to shmkmf-config.

expands the options for the following calls to shmkmf-config.

if header file exists, a include directive is createted and the options for the following calls to shmkmf-config are expanded to include it.

calls shmkmf-config with the given arguments.

calls shmkmf-cflags with the given arguments.

calls shmkmf-config with -s and the the given arguments. All lines between @beg and @end are send to shmkmf-config.

file [name]

inserts system specific parameters in file name

performs shmkmf-config file on src and overwrites tg only if src is newer than tg or tg has changed.

check compilation/execution of expr without any additional message.

reports status of compilation/execution of expr.

create #error directive with message, if compilation/execution fails.

if compilation/execution of expr is successful, define tname with 1, else with 0.

if compilation/execution of expr failed, define tname with 1, else with 0.

includes header name if availabel.

check compatibility of prototype proto.

if type is not defined, declare it with decl.

SEE ALSO

shmkmf(1), shmkmf-cflags(1).

COPYRIGHT

Copyright (C) 2002, 2008 Erich Frühstück

src2doc(1)

SYNOPSIS

src2doc [ --help[=type] ] [ --version ] [ --info[=entry] ] [ --debug[=mode] ] [ --verbose ] [ -t ] [ --ps ] [ -c ] [ -n name ] [ -m mode ] [ -s num ] [ -i fmt ] [ -g ] [ -L lang ] [ -l ] [ -a ] src [ out ]

DESCRIPTION

The following options and arguments are accepted from command src2doc:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

--version

show version information

--info[=entry]

show command information

--debug[=mode]

set debug level for command

--verbose

set debug level to stat.

-t

terminal output

--ps

PostScript output

-c

insert program code

-n name

output name

-m mode

execution mode

-s num

manpage section

-i fmt

format for header file

-g

global header files

-L lang

set language

-l

list execution modes

-a

list alias table

src

input file

out

output file

ENVIRONMENT

APPLPATH

path for configuration files.

LANG

locale information

COPYRIGHT
Copyright (C) 2000 Erich Frühstück

tex2ps(1)

SYNOPSIS

tex2ps [ --help[=type] ] [ --version ] [ -q ] [ -n count ] [ -r res ] src [ ps ]

DESCRIPTION

The following options and arguments are accepted from command tex2ps:

--help[=type]

create command usage. The optional parameter type determines the formatting and output of the description.

term

display on terminal (default)

raw

output raw data for efeudoc

man

output nroff/troff source for man

lp

send postscript data to lpr

COPYRIGHT
Copyright (C) 1993, 2001 Erich Frühstück

go to start of document, contents, index