Skip to content

Commit

Permalink
Задокументировано использование REF5RSL (#33)
Browse files Browse the repository at this point in the history
  • Loading branch information
Mazdaywik committed Apr 3, 2019
1 parent 3e49890 commit 601780e
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 10 deletions.
10 changes: 5 additions & 5 deletions docs/3-install-and-usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,9 +124,9 @@ Visual C++, GCC, Clang и Watcom — их можно раскомментир
Файлы, которые перечислены в командной строке, должны быть исходными текстами
либо на Рефале (расширение `.ref`), либо на Си (`.c`). Для каждого файла
последовательно проверяется его наличие в текущей папке, затем по каждому
из путей, перечисленных в `R05PATH`. Если расширение не указано, то по каждому
пути поиска (текущая папка и папки из `R05PATH`) проверяется наличие сначала
с расширением `.ref`, потом с расширением `.c`.
из путей, перечисленных в `R05PATH` и `REF5RSL`. Если расширение не указано,
то по каждому пути поиска (текущая папка и папки из `R05PATH` и `REF5RSL`)
проверяется наличие сначала с расширением `.ref`, потом с расширением `.c`.

Каждый файл на Рефале компилируется в одноимённый файл с расширением `.c`,
который находится в той же папке, что и исходный. Отсюда и ограничение, что
Expand All @@ -136,7 +136,7 @@ Visual C++, GCC, Clang и Watcom — их можно раскомментир
всех исходников имена сишных файлов (как заданных пользователем, так
и сгенерированных) передаются компилятору `R05CCOMP`. Для каждого пути
поиска в командную строку запуска компилятора добавляется опция `-I`
(include path) с путём до каждой папки в `R05PATH`.
(include path) с путём до каждой папки в `R05PATH` и `REF5RSL`.

Компилятор также понимает переменную среды `R05CFLAGS`, содержимое которой
(если она установлена) добавляется в командную строку компилятора Си. Эта
Expand Down Expand Up @@ -165,7 +165,7 @@ _библиотеку поддержки времени выполнения_ (r
Файлы `refal05rts.c` и `Library.c`, а также `refal05rts.h`, содержащий
определения внутренних структур данных и прототипы функций, используемых
в сгенерированном коде, располагаются в каталоге `lib`. Поскольку для папок,
перечисленных в `R05PATH`, автоматически формируется опция `-Iпапка`,
перечисленных в `R05PATH` и `REF5RSL`, автоматически формируется опция `-Iпапка`,
файл `refal05rts.h` будет найден компилятором Си без каких-либо дополнительных
действий со стороны пользователя.

Expand Down
12 changes: 7 additions & 5 deletions docs/4-libraryex-components.md
Original file line number Diff line number Diff line change
Expand Up @@ -420,7 +420,8 @@
e.Folders ::= (e.Folder)*
e.Folder ::= s.CHAR+

Функция возвращает пути поиска, заданные в переменной окружения `R05PATH`.
Функция возвращает пути поиска, заданные в переменных окружения `R05PATH`
и `REF5RSL`.

### Функции `R05-FindFiles-Default` и `R05-FindFiles`

Expand All @@ -439,8 +440,8 @@
e.Source, e.Output, e.FileName ::= s.CHAR+

Функции производят поиск указанных файлов в каталогах поиска. Первая функция
`R05-FindFiles-Default` осуществляет поиск в каталогах по умолчанию, заданных
в переменной окружения `R05PATH`. Вторая функция осуществляет поиск в каталогах,
`R05-FindFiles-Default` осуществляет поиск в каталогах по умолчанию, возвращаемых
функцией `R05-LoadPath`. Вторая функция осуществляет поиск в каталогах,
указанных пользователем.

### Функция `R05-CCompile`
Expand All @@ -452,8 +453,9 @@

Выполняет компиляцию исходных текстов на Си компилятором, заданным в переменной
окружения `R05CCOMP`, с флагами, заданными в `R05CFLAGS`. Функция автоматически
добавляет к командной строке компилятора каталоги из `R05PATH` как каталоги
поиска заголовочных файлов (используется опция `-Iкаталог`).
добавляет к командной строке компилятора каталоги, возвращаемые функцией
`R05-LoadPath` как каталоги поиска заголовочных файлов (используется опция
`-Iкаталог`).

Если переменная `R05CCOMP` установлена и непустая, то возвращаемое значение
функции совпадает с возвращаемым значением функции `System`, при помощи которой
Expand Down

0 comments on commit 601780e

Please sign in to comment.