-------------------------------------------------------------------
Компилятор 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