26 | 07 | 2017

-------------------------------------------------------------------
Компилятор CLIPPER.EXE
-------------------------------------------------------------------

Компилирует один или несколько программных файлов (.prg), содержащих
процедуры и определенные пользователем функции для формирования объ-
ектных файлов (.obj)

Клиппер [<исх.файл> | @ <файл описаний> [<опции>]]

Командная строка

Эта комадная строка вызывает компилятор Clipper. Если компилятор
запущен без аргументов, на экране отображается подсказка.

<исх.файл> - это имя программного файла (.prg), который будет
компилироваться в объектный файл (.obj).

<файл описаний> - это имя файла, содержащего список файлов для ком-
пиляции в единый объектный файл.

<опции> - список опций (режимов работы) для управления компиляцией.

Опции компилятора

/A Объявляет любую переменную, включенную в PRIVATE, PUBLIC
или PARAMETERS как MEMVAR.

/B Включает информацию об отладчике в объектный файл.

/CREDIT Отображает кредиты Клиппер 5.0 на консоль.

/D<идентификатор>[<текст>] Определяет идентификатор для препроцессора
с назначением <текст>, если оно определено.

/I<путь> Добавляет специфицированный директорий перед списком
маршрута INCLUDE. Многократные опции /I могут быть
специфицированы в сеансе компиляции для определения файла
заголовка (headar file) искомых директориев.

/L Исключает номера программного кода исходного текста из
объектного файла.

/M Компилирует только текущий программный файл (.prg)
подавляя автоматический поиск для программных файлов,
представленных в командах DO, SET FORMAT и SET PROCEDURE.

/N Подавляет автоматическое определение процедуры с таким же
именем как в программном файле (.prg).

/O<объектный файл> Определяет имя или местоположение выходного
объектного файла.


323


/P Определяет обработку файла препроцессором и копирует
результат в выходной файл с расширением (.ppo).

/Q Подавляет отображение номеров строк при компиляции.

/R<библиотечный файл> Встраивает исходную библиотеку, требуемую для
объектного файла. Если специфицировано без имени
библиотеки <библиотечный файл>, подавляются умалчиваемые
требования для библиотек CLIPPER.LIB, EXTEND.LIB,
DBFNTX.LIB. Многократные опции /R могут быть определены
для подключения нескольких требуемых библиотек.

/S Проверяет правильность синтаксиса программного файла и не
генерирует объектный файл.

/T<путь> Назначает директорий для временных файлов, которые
образуются во время компиляции.

/U [<файл заголовка пользователя>]
Определяет альтернативный стандартный файл заголовка
вместо файла STD.CH, который используется автоматически.

/V Заставляет компилятор принимать все ссылки на
необъявленные или не алаисные имена переменных как public
и private.

/W Генерирует предупредительные сообщения для необъявленных
или не алаисных переменных.


-------------------------------------------------------------------
Компановщик RTLINK.EXE
-------------------------------------------------------------------

RTLINK объединяет объектные файлы (.obj) и библиотечные файлы (.lib)
в форму выполняемого (.exe) файла или библиотеки пре-компановщика
(.pll)

Определение синтаксиса по свободному формату ( FREEFORMAT )для вызо-
ва RTlink следующее :

RTLINK [FILE <список объектных файлов>
[OUTPUT <выходной файл> ]
[LIBRARY [<список библиотечных файлов> ]
[<список опций>]] | [@<файл описаний>]

Определение позиционированного формата (POSITIONAL) :

RTLINK [<список объектных файлов>,
[<выходной файл>],
[<файл схемы>],


324

[<список библиотечных файлов>]
[<список опций>]] | [@<файл описаний>][;]


Если используется без аргументов RTlink входит в режим приглашения, в
котором вводятся аргументы.

Коммандная строка аргументов

<список объектных файлов> - список объектных файлов для компановки.

<выходной файл> - имя выходного файла, который должен быть
сгенерирован. Если не определен, используется имя первого
файла, указанного в командной строке RTlink.

<файл схемы> - имя файла схемы.

<список библиотечных файлов> - список библиотек, которые
используются для определения неопределенных символов.

<список опций> - список опций (режимов работы), которые описываются ниже.

<файл описаний> - имя файла, который используется как файл описания
компановщика.

Файл описаний

При использовании свободного формата (FREEFORMAT) опции определяются
в файле описаний без специального порядка. При использовании
позиционированного формата (POSITIONAL), файл описаний должен быть
следующим:

<список объектных файлов>[<список опций>]
[<выходной файл>]
[<файл схемы>]
[<список библиотечных файлов>]

Опции компановщика

Для многих опций дается два синтаксических правила, выбор правил за-
висит от используемого входного режима. Позиционированный формат
(POSITIONAL) требует, чтобы опции начинались со слэша. Если слэш не
указан, опция указана в свободном формате (FREEFORMAT). свободный
формат (FREEFORMAT) предоставляет вам использовать любой синтаксис,
и где существует только одно синтаксическое представление, он
позволяет вам пропустить как слэш, так и двоеточие.

/BATCH | /NOBATCH BATCH запрещает компановщику запросы к
пользователю, если файл не найден. По умолчанию
используется NOBATCH.

BEGIN AREA


325

.
.
. <опции компановщика свободного формата>
.
.
ENDAREA Разрабатывает статическую оверлейную область со всеми
секциями между этими двумя командами, которые
соответствуют статическим оверлейным секциям внутри
оверлейной области. Статические оверлейные области могут
быть вложенными и определяться конструкцией BEGIN AREA ...
ENDAREA внутри другой.

/DEBUG Вызывает оверлейную управляющую программу RTLink для
вывода сообщения, которое идентифицирует каждый оверлей
как загруженный в память во время выполнения программы.

/DEFAULTLIBRARYSEARCH | NODEFAULTLIBRARYSEARCH

NODEFAULTLIBRARYSEARCH вызывает RTLink, чтобы игнорировать
имена библиотек, включенных компилятором.
DEFAULTLIBRARYSEARCH используется по умолчанию.

/DYNAMIC[:<оверлей>]
DYNAMIC [INTO <оверлей>] DYNAMIC заставляет компановщик расположить
последующий компилируемый модуль в динамический оверлей,
вместо того, чтобы расположить его в корневой секции.
Опция DYNAMIC противоположна по действию опции RESIDENT и
установлена по умолчанию.

/EXCLUDE:<символ>
EXCLUDE<symbol list> В режиме прекомпановщика вызывает модульное
определение специфицированных символов, которые должны
быть исключены.

/EXITDICTONARY | /NOEXITDICTONARY NOEXITDICTONARY подавляет
использование компановщиком расширенного словаря.
EXITDICTONARY установлен по умолчанию.

/FREEFORMAT Строит интерфейс для свободного формата (FREEFORMAT)
входного режима, когда RTLink переключается на новый
входной поток. /FREEFORMAT проти- воположен
позиционированному формату (POSITIONAL) и установлен по
умолчанию.

/HELP Выводит список опций на консоль.

/IGNORECASE | NOIGNORECASE NOIGNORECASE вызывает блок, который должен
обозначаться в символе или именах сегмента. По умолчанию
используется IGNORECASE.

/INCREMENTAL | /NOINCREMENTAL INCREMENTAL дает возможность пошагового
компанования скомпилированнных Клиппер модулей. Во время


326

компановки программы используются только те модули,
которые имеют изменения.

/MAP[:<список опций>]
MAP [= <файл схемы>] [<список опций>] Генерирует файл схемы (mapFile),
содержащий один или несколько отчетов о сеансе
компановки. Возможные опции (<список опций>) - S, N, A.

MODULE <список модулей> Пересылает сегменты из специфицированных
модулей (<список модулей>) в текущую оверлейную секцию.

/PLL:<библиотека пре-компановщика> Выходной выполняемый файл зависит
от специфицированного файла библиотеки прекомпановщика
(<библиотека пре-компановщика>), используемого в режиме
компановки.

/POSITIONAL Строит интерфейс компановщика с позиционированным
форматом (POSITIONAL) входного режима, когда RTLlink
переключается на новый входной поток. /POSITIONAL
противоположен по действию /FREEFORMAT, который
используется во входном режиме по умолчанию.

/PRELINK Настраивает RTLink на режим прекомпановки. В этом режиме
выходной файл генерируется не в выполняемый файл (.EXE), а
в файл библиотеки пре-компановщика (PLL).

PRELOAD Вызывает текущую статическую оверлейную секцию, которая
должна быть загружена перед выполнением программы. Обычно
только резидентные секции программы загружены в память
перед началом выполнения программы.

/REFER:<символ>
REFER <список символов> В режиме прекомпановки заставляет RTLink найти
все специфицированные библиотеки, чтобы загрузить
необходимый ассоциативный код с определенными символами.

/RESIDENT Вызывает модули компилятора Клиппер которые должны быть
загружены в корневую секцию текущей программы, отменяя
автоматическое создание динамических оверлеев для всего
компилируемого кода Clipper./RESIDENT противоположен
DYNAMIC.

SECTION [<имя секции>][INTO <оверлей>] Создает статическую оверлейную
секцию и вызывает сегменты внутри объектных модулей ( не
системы Clipper), специфицированные в опциях FILE или
LIBRARY, которые становятся частью этой секции.

/SILENT Подавляет отображение вопросов и ответов когда RTLink
вызывается с файлом описания.

/STACK:<размер в байтах> Специфицирует стэк программы, отменяя
специфицированный размер стэка в объектном модуле. Размер


327

до 65,535 байт.

/VERBOSE Вызывает RTLink для отображения сообщений состояния во
время выполнения компоновки модулей.


-------------------------------------------------------------------
Отладчик CLD.EXE
-------------------------------------------------------------------

CLD - отладчик выполняемых (.EXE) программ. Применяется для
просмотра текста программы при ее выполнении. Особенность отладчика
состоит в наблюдении значений переменных и выражений при выполнении
программы, проверка файла базы данных и проверка выполнения
программы по шагам.

CLD [[/Q] [/S] [/43 : /50] [@<файл описаний>]
<имя файла> [<список аргументов>]

Коммандная строка аргументов

Если входная строка задана без опций, на экран выводится подсказка
запуска отладчика.

/Q определяет скрытый режим.

/S разбивает экран между отладчиком и программой.

/43 | /50 определяет режим в 43 или 50 строк. По умолчанию использу-
ется режим в 24 строчки. Режим в 43 строчки используется
для монитора типа EGA. Режим в 53 строчки используется для
монитора типа VGA.

<файл описаний> - имя текстового файла, содержащего комманды
отладчика. Каждая команда будет применяться в новой строке
файла. Если не специфицирован другим образом,
присваивается расширение(.TXT). Этот файл будет
выполняться как только вы указали комманду INPUT.

<имя файла> - имя выполняемого (.EXE) файла, который вы желаете
отладить. Если файл не был откомпилирован с опцией /B для
включения информации об отладчике, полная отладка не
возможна. Могут быть использованы режимы Watchpoints и
Tracepoints и программа может выполнить одну строчку. Если
использовалась опция /L , программа может быть вы-
полнена, отладка не возможна.

<список аргументов> - список аргументов для файла, который вы
отлаживаете.

Комманды отладчика

328

? <выражение> Просматривает переменную или выражение любого типа и
отображает значение.

ANIMATE Выполняет программу в режиме Continouse Step (пошаговое
выполнение) пока установлены точки прерывания (Breakpoint)
и точки трассировки (Tracepoint).

BP [AT] <строка>
[[IN]] <имяфайла> | <имяфункции>] Устанавливает точки прерывания
(Breakpoint) в вызове функции или специфицирует
программу и номер строки.

CALLSTACK on | OFF Переключает отображение окна стэка (Callstack
Window) в правой части экрана.

DELETE ALL [WP | TP | BP | PP]
DELETE [WP | TP | BP | PP <Nвыраж.>] Удаляет точки прерывания
(Breakpoint), точки трассировки (Tracepoint), точки
просмотра (Watchpoint) все сразу или какие-нибудь из них.

DOS Загружает копию COMMAND.COM, что позволяет выполнять
комманды DOS без не выходя из отладчика.

FIND <Cвыраж.> Просматривает текущий файл, отображаемый в окне для
спецификации символьной строки, подчиняющейся установке
опции Case Sensitive меню Locate.

GO Отображает пользовательский экран и выполняет программу до
тех пор, пока установлены точки прерываний или нажата
ALT-D.

GOTO<Nвыраж.> Передвигает позиционированный индикатор из текущей
позиции в указанную.

HELP Выводит на экран окно помощи.

INPUT <имяфайла> Временно приостанавливает ввод с клавиатуры и
начинает чтение комманд из файла описаний.

INSPECT CALLSTACK Контролирует вызов стэка.

INSPECT WP Контролирует значение переменных или выражений любого
типа и допускает их преобразование.

LIST WP | TP | BP | PP Выводит список всех точек просмотра
(Watchpoints), точек трассировки (Tracepoints), точек
прерывания (Breakpoint), точки прохода (Passpoint).

NEW <имяфайла> Загружает новый выполняемый файл (.EXE) вместо
текущего файла.

NEXT Определяет следующую символьную строку найденную командой


329

FIND.

NUM ON | off Переключает отображение номеров строк программы в окне.

OUTPUT Временно очищает экран отладчика и показывает
пользовательский экран.

PP [AT] | <строка>
[[IN] <имяфайла> | <имяфункции>]

Назначает строку программы как путь прохождения (Passpoint).

PREV Определяет предыдущую символьную строку, найденную
последней коммандой FIND.

QUIT Завершение отладки, закрытие файлов, возврат в DOS.

RESTART Перезагрузка текущей программы.

RESUME Очищает файл, вызванный по команде VIEW и возвращает
начальное изображение.

SPEED <скорость> Устанавливает скорость в режиме пошагового
выполнения (Continuous Step).

STEP<Nвыраж.> Выполняет указанное количество строк в режиме
выполнения программы (RUN).

TP <выраж.> Определяет указанную переменную или выражение как
точку трассировки (Tracepoint).

VIEW <имяфайла> Просматривает указанный файл.

WP <выраж.> Определяет указанную переменную или выражение как точку
просмотра (Watchpoint).


-------------------------------------------------------------------
Программа сопровождения RMAKE.EXE
-------------------------------------------------------------------

RMAKE - Автоматическое сопровождение мультипрограммных систем
путем отслеживания обновления файлов.

RMAKE [<список файлов>] [<список макросов>] [<список опций>]

Коммандная строка аргументов

Если RMAKE запущена без аргументов, на экране отображается справочная
информация.

<список файлов> - список файлов для перекомпиляции.


330


<список макросов> - список макроопределений следующей формы:
<имямакроса> = <значение>.

<список опций> - опции программы RMAKE.

Применение

Обеспечивает обновление файлов, сравнивая дату и время, относящихся
друг к другу файлов и выполняет серию действий, если они отличаются.

Опции:

/B Отображает информацию отладчика.

/D <имя макроса>[:<значение>] Определяет макро и необязательное
значение. Если значение не объявлено, макро определяется
с нулевым значением.

/I Игнорирует ошибки выполнения.

/N Заставляет отображать все команды, которые должны быть,
без их действительного выполнения (посылает их не
нулевое устройство).

/S Поиск поддиректориев.

/U Разрешает исполнение # character как признак комментария и
подавляет его исполнение как признака директивы.

/W Отображает предупредительные сообщения.

/XS <число символов> Устанавливает размер внутренней таблицы для
символов. По умолчанию принимается размер в 500 символов.

/XW <число байт> Устанавливает размер внутреннего рабочего
пространства. Если размер не специфицирован, по умолчанию
устанавливается размер в 2048 байт.

-------------------------------------------------------------------
Утилита базы данных. DBU.EXE
-------------------------------------------------------------------

DBU [/<цвет>] [<имя файла>]

Аргументы

<цвет> - опция цвета. Для цветного дисплея: /C; для монохромного:
/M.

<filename> - имя файла (.vew или .dbf). Указание этого аргумента


331

вызывает DBU для открытия и редактирования файла.

Применение

DBU - прикладная система, написанная на Clipper. Исходный текст
размещается в директории \CLIPPER5\SOURCE\DBU на диске, где
установлен Клиппер 5.0. DBU.EXE и DBU.HLP устанавливаются в
директории \CLIPPER5 \BIN и этот директорий должен быть включен в
выражение PATH в Вашем AUTOEXEC.BAT.

Чтобы сформировать систему DBU необходимы следующие файлы:

Dbu.prg
Dbu.hlp
Dbucopy.prg
Dbuedit.prg
Dbuhelp.prg
Dbuindx.prg
Dbustru.prg
Dbuutil.prg
Dbuview.prg

Для формирования системы используйте файл DBU.RMK. Командная строка
будет следующая:

C>RMAKE DBU

В результате Вы получите новый файл DBU.EXE.

-------------------------------------------------------------------
Утилита отчета и меток. RL.EXE
-------------------------------------------------------------------
Применение

Система RL написана на Clipper. Исходный текст системы находится в
директории \CLIPPER5\SOURCE\RL на диске, где установлен Клиппер 5.0.
RL.EXE устанавливается в директории \CLIPPER5\BIN и этот директорий
должен быть включен в выражение PATH в Вашем AUTOEXEC.BAT.

Для формирования системы RL необходимы следующие файлы:

Rlfront.prg
Rllack.prg
Rldialg.prg
RL.RMK

При формировании системы используйте файл RL.RMK. Командная строка
выглядит следующим образом:

C>RMAKE RL

Результатом будет новый файл RL.EXE.

GOTO