Google

NAME

C L I P - clipper (tm) совместимый компилятор.

SYNOPSIS

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

DESCRIPTION

clip является препроцессором, компилятором и сборщиком программ, написанных на xBase диалектах, в частности clipper (tm). Для нормальной работы компилятора необходимо в переменной окружения CLIPROOT указать путь до каталога, где лежат необходимые для компиляции и сборки каталоги: charsets, include, lib, bin, keymaps, locale.po, locale.mo. clip в соотвествии с [options] зачитывает файлы с исходными текстами, объектными модулями, библиотеками и создает объектные модули или исполняемые файлы.

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. Любая переменная, включенная в в операторы PUBLIC, PRIVATE или PARAMETERS автоматически объявляется как MEMVAR.
<-w>
warning about implicit var declaration. Генерировать предупреждающие сообщения о некорректных объявлениях и использовании необъявленных переменных.
<-e>
generate executable file. Из всех перечисленных [fileN] собрать исполняемый файл.
<-c>
stop after generation C code. Результатом работы будет C- программа.
<-g,-b>
generate debug info. Включить в результат работы компилятора информацию для отладчика.
<-t>
print program syntax tree
<-o[name]>
set output file name. Результат работы вывести в файл [name]
<-O>
make optimisations. Использовать при компиляции оптимизирующие алгоритмы.
<-M>
use first [file1] as start program point. Сгенерировать процедуру MAIN из первого указанного PRG-файла. Использовать эту опцию следует только в случае если процедура MAIN явно не указана ни в одном из перечисленных fileN.
<-n>
don't declare module procedure. Не будет создавать процедуру с тем же именем что и имя модуля .prg.
<-p>
generate pseudocode module. Результатом работы компилятора будет файл с байт-кодом.
<-l>
compile C-pseudocode module. Результатом работы компилятора будет файл с программой на языке С.
<-s>
compile into shared object. Собрать программу с динамически подключенной библиотекой CLIPROOT/lib/libclip.so
<-I[path]>
add include search path. При компиляции использовать заголовочные файлы из указанного каталога.
<-L[path]>
add library path. При сборке программ использовать библиотеки из указанного каталога.
<-D[name]>
define macro name. Назначить препроцессору идентификатор, аналогично описанному в тексте программы через команду #define.
<-D[name=value]>
define macro name as [value]. назначить идентификатор со значением.
<-U[filename]>
use alternate (or none) standard include file (default==std.ch). При компиляции использовать вместо std.ch указанный файл.
<-S[charset]>
define source charset of string constants. При компиляции считать что все строковые константы имеют charset кодировку.
<-T[charset]>
define target charset of string constants. Все строковые константы вложить в объектный файл в charset кодировке.
<-P>
preprocess only. Результатом работы компилятора бедут текст программы после препроцессора.
<-C>
print command definitions. Вывести все описанные команды, в соответсвии с текущим состоянием и опциями.
<-E[name=value]>
exact to set same environ variable(see -H for details). Установить переменную окружения [name] в значение [value] на время работы компилятора.
<filename>
files to process. Список файлов для обработки компилятором.

Все перечисленные опции можно прописать в файле .cliprc для использования этих значений по-умолчанию.
< +option >
means disable feature (if possible). Отменить ранее указанную опцию - применяется для отмены опций указанных в .cliprc.

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

clip можно использовать как препроцессор, компилятор, сборщик программ, написанных на диалектах xBase при наличии соответсвующих этим диалектам описания std.ch и библиотек.
При помощи clip можно создавать программы не только для терминального пользовательского интерфейса, но и скрипты для обработки текстовых и т.п. данных, в том числе для cgi, sql и т.п. скрипты.

SEE ALSO

gcc(1), ar(1)

AUTHOR

Paul Lasarev <paul@itk.ru>, 2000

LICENSE