NAME

SYNOPSIS

DESCRIPTION

All components of clip use environment variable CLIPROOT. If CLIPROOT is not set, will used default value /usr/local/clip.

clip can create native executables, bytecode objects, and builtined-in-executable bytecodes. Bytecode objects may be maked executable by using standard Unix #!program feature.

clip uses standard GNU gettext package for work with localized messages.

OPTIONS

-h

help page.

-H

help about acceptable environment variables.

-V

print clip version.

-v[level]

set verbose level (default==1)

-a

auto memvar variables. Any variabe, not included in PUBLIC, PRIVATE or PARAMETER operators, automatically declared as MEMVAR.

-w

warning about implicit var declaration.

-e

generate executable file.

-c

stop after generation C code.

-g,-b

generate debug info.

-t

print program syntax tree

-o[name]

set output file name.

-O

make optimisations.

-M

use first [file1] as start program point.

-n

don't declare module procedure.

-p

generate pseudocode module.

-l

compile C-pseudocode module.

-s

compile into shared object.

-I[path]

add include search path.

-L[path]

add library path.

-D[name]

define macro name.

-D[name=value]

define macro name as [value].

-U[filename]

use alternate (or none) standard include file (default==std.ch).

-S[charset]

define source charset of string constants.

-T[charset]

define target charset of string constants.

-P

preprocess only.

-C

print command definitions.

-E[name=value]

exact to set same environ variable(see -H for details).

filename

files to process.

+option

means disable feature (if possible). - for using in .cliprc.

All options may be placed into file $HOME/.cliprc or in ./.cliprc in form "one option - one line".

ENVIRONMENT VARIABLES

CC

name of C compiler (default=='gcc')

CFLAGS

options for C compiler (default=='')

COMPILE_FLAG

'compile-only' flag for C compiler (default=='-c')

COPT

optimisation flag for C compiler (default=='-O2')

CDBG

debug flag for C compiler (default=='-g')

OUT_FLAG

output flag for C compiler (default=='-o')

INCLUDE_FLAG

include flag for C compiler (default=='-I')

OBJSUF

suffix for output object files (default=='.o')

SOBJSUF

suffix for output shared files (default=='.so')

LIBSUF

suffix for library files (default=='.a')

SLIBSUF

suffix for shared library files (default=='.so')

SFLAGS

options for C compiler - shared version (default=='-shared')

CLIPLIB

runtime support library (default=='libclip.a')

CLIPSLIB

runtime support shared library (default=='libclip.so')

CLIPLIBS

additional libs (default=='')

CLIPROOT

root for all clip related files (default=='/usr/local/clip')

CLIP_MODULE

current locale module (default=='doc')

CLIP_CMDSTR

comma-separated list of command-line options

PREDEFINED MACROS

__FILE__

string - name of current compile file

__BASE_FILE__

string - name of root compile file

__LINE__

numeric - number of current line in current file

__VERSION__

string - version of clip

__CLIP__

string - version of clip

__SYSTEM__

string - name of operating system

__DATE__

string - date in format 'MON DD YYYY'

__TIME__

string - current time in format 'HH:MM::SS'

USAGE

FILES

$CLIPROOT/bin/*

clip binaries.

$CLIPROOT/lib/*

clip libraries.

$CLIPROOT/include/*

clip develop include files.

$CLIPROOT/charsets/*

clip charset defitinion files.

$CLIPROOT/keymaps/*

clip scanmode keymap files.

$CLIPROOT/environment

contens of this file automatically appends to program environment.

$CLIPROOT/lang/$LANG

contens of this file automatically appends to program environment for this LANG variable value

$CLIPROOT/lang/$LANG

contens of this file automatically appends to program environment for this LANG variable value

$CLIPROOT/term/$TERM

contens of this file automatically appends to program environment for this TERM variable value

$CLIPROOT/locale.pot/*

localized messages templates. Files in this directory will be created by clip when program text contain localized strings (such as [File] ).

$CLIPROOT/locale.po/$LANG/*

localized messages repository. Files in this directory must be edited by hands for each locale, and merge with current templates by call of clip_msgmerge.

$CLIPROOT/locale.mo/$LANG/*

compiled messages repository. Files in this directory are created by call of clip_msgfmt.

$HOME/.cliprc

recource file.

./.cliprc

recource file.