NAME

CLIP - XBASE program language compatible compiler.

SYNOPSIS

clip [options] [file1] [..fileN]

DESCRIPTION

clip is a preprocessor, compiler and linker for XBASE program language dialects, such as Clipper ™.

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.

SEE ALSO

clip_msgfmt, clip_msgmerge, clipar gcc(1), ar(1),

AUTHORS

Uri Hnikyn
Elena Kornilova
Andrew Kulikov
Paul Lasarev
Rushat Nabiullin
Sergey Rosenfeld
Alexey M. Tkachenko
Alex Vorontsov

LICENSE

GPL