!Сценарий создания документации к программам на языке Си

 

!Запись в первую ячейку общего архива  {{1}} тега  <pre>

#[ЗАМЕНА КОНТЕКСТОВ] {1}

/1/входной текст (индекс): 1

/2/выходной текст (индекс): 0

/3/входной каталог: d:\docci\tagpre.txt

/4/шаблоны входных файлов: *

/5/искать в подкаталогах (признак): 0

/6/без учета регистра (признак): 1

/7/режим замены (индекс): 1

/8/входная кодировка (индекс): 3

/9/выходной каталог: d:\docci\rabfiles\

/10/рабочий каталог:

/11/сводный файл строк редакции (признак): 0

/12/только протокол (признак): 0

/13/вид протокола (индекс): 0

/14/статистика для протокола (признак): 0

/15/файл запроса: d:\docci\doccont4.txt

[ПАРАМЕТРЫ ВЫХОДНОГО КАТАЛОГА]

/1/запись измененных файлов (индекс): 0

/2/выходной каталог: d:\docci\rabfiles\

/3/сохранять копии (признак): 0

/4/рабочий каталог: d:\docci\rabfiles\

/5/копировать дерево файлов исходного каталога (признак): 0

/6/копировать в рабочий каталог (индекс): 0

>НАЧАТЬ: 12

 

!Запись во вторую ячейку общего архива  {{2}} тега  </pre>

#[ЗАМЕНА КОНТЕКСТОВ] {2}

/1/входной текст (индекс): 1

/2/выходной текст (индекс): 0

/3/входной каталог: d:\docci\tagpre.txt

/4/шаблоны входных файлов: *

/5/искать в подкаталогах (признак): 0

/6/без учета регистра (признак): 1

/7/режим замены (индекс): 1

/8/входная кодировка (индекс): 3

/9/выходной каталог: d:\docci\rabfiles\

/10/рабочий каталог:

/11/сводный файл строк редакции (признак): 0

/12/только протокол (признак): 0

/13/вид протокола (индекс): 0

/14/статистика для протокола (признак): 0

/15/файл запроса: d:\docci\doccont5.txt

[ПАРАМЕТРЫ ВЫХОДНОГО КАТАЛОГА]

/1/запись измененных файлов (индекс): 0

/2/выходной каталог: d:\docci\rabfiles\

/3/сохранять копии (признак): 0

/4/рабочий каталог: d:\docci\rabfiles\

/5/копировать дерево файлов исходного каталога (признак): 0

/6/копировать в рабочий каталог (индекс): 0

>НАЧАТЬ: 11

 

 

!Цикл по основным каталогам поиска (am, de, pa и др.)

!(цикл охватывает пункты 3 – 22)

#ЦИКЛ:1?d:\docci\listcat.txt

 

!Создание левого списка по файлам каталога цикла

!(например, из подкаталога am) c расширением .htm

#[СОЗДАНИЕ СПИСКОВ] {3}

/1/источник списка (индекс): 0

/2/входной (базовый) каталог: d:\num_anal\lib_na\cat\&1 \

/3/шаблоны входных файлов: *

/4/искать в подкаталогах (признак): 1

/5/неполный путь к файлу (признак): 0

/6/левый список (признак): 1

/7/правый список (признак): 0

/8/новый список (признак): 1

/9/добавить в список (признак): 0

/10/содержимое списка (индекс): 0

/11/уровень от базы (режим):   >=

/12/уровень от базы (значение): 0

>ПО ВХОДНОМУ КАТАЛОГУ

 

!Добавление в левый список zip-файлов из подкаталога Библиотеки

! d:\num_anal\lib_na\cat\&1 _c\ (например, из подкаталога am_c)

#[СОЗДАНИЕ СПИСКОВ] {4}

/1/источник списка (индекс): 0

/2/входной (базовый) каталог: d:\num_anal\lib_na\cat\&1 _C\

/3/шаблоны входных файлов: *

/4/искать в подкаталогах (признак): 1

/5/неполный путь к файлу (признак): 0

/6/левый список (признак): 1

/7/правый список (признак): 0

/8/новый список (признак): 0

/9/добавить в список (признак): 1

/10/содержимое списка (индекс): 0

/11/уровень от базы (режим):   >=

/12/уровень от базы (значение): 0

>ПО ВХОДНОМУ КАТАЛОГУ

 

!Добавление в левый список файлов из подкаталога Библиотеки

! d:\num_anal\lib_na\cat\t&1 _c\ ( например, из подкаталога tam_c )

#[СОЗДАНИЕ СПИСКОВ] {5}

/1/источник списка (индекс): 0

/2/входной (базовый) каталог: d:\num_anal\lib_na\cat\t&1 _C\

/3/шаблоны входных файлов: *

/4/искать в подкаталогах (признак): 1

/5/неполный путь к файлу (признак): 0

/6/левый список (признак): 1

/7/правый список (признак): 0

/8/новый список (признак): 0

/9/добавить в список (признак): 1

/10/содержимое списка (индекс): 0

/11/уровень от базы (режим):   >=

/12/уровень от базы (значение): 0

>ПО ВХОДНОМУ КАТАЛОГУ

 

!Создание рабочего каталога files_&1

#[ФАЙЛОВЫЕ ОПЕРАЦИИ] {6}

/1/тип операции (индекс): 2

/2/входной (базовый) каталог: Для работы с каталогами не задается

/3/шаблоны входных файлов: *.*

/4/базировать путь к файлу (признак): 0

/5/выходной каталог: d:\docci\

/6/шаблоны файлов очистки: *

/7/режим очистки подкаталогов (индекс): 0

/8/создать структуру базы (признак): 0

/9/левый список (признак): 1

/10/правый список (признак): 0

/11/содержимое списка (индекс): 0

/12/использовать корзину (признак): 0

>СОЗДАТЬ КАТАЛОГ: files_&1

 

!Перепись файлов левого списка в каталог files_&1 

#[ФАЙЛОВЫЕ ОПЕРАЦИИ] {7}

/1/тип операции (индекс): 0

/2/входной (базовый) каталог:

/3/шаблоны входных файлов: *.*

/4/базировать путь к файлу (признак): 0

/5/выходной каталог: d:\docci\files_&1 \

/6/шаблоны файлов очистки: *

/7/режим очистки подкаталогов (индекс): 0

/8/создать структуру базы (признак): 0

/9/левый список (признак): 1

/10/правый список (признак): 0

/11/содержимое списка (индекс): 0

>ПЕРЕПИСАТЬ

 

!Создание правого списка zip-файлов из каталога files_&1

!( например, files_am ) и запись этого списка в файл d:\docci\tmp\listzip.txt

#[СОЗДАНИЕ СПИСКОВ] {8}

/1/источник списка (индекс): 0

/2/входной (базовый) каталог: d:\docci\files_&1 \

/3/шаблоны входных файлов: *.zip

/4/искать в подкаталогах (признак): 1

/5/неполный путь к файлу (признак): 0

/6/левый список (признак): 0

/7/правый список (признак): 1

/8/новый список (признак): 1

/9/добавить в список (признак): 0

/10/содержимое списка (индекс): 0

/11/уровень от базы (режим):   >=

/12/уровень от базы (значение): 0

>ПО ВХОДНОМУ КАТАЛОГУ

>ЗАПИСАТЬ СПИСОК: D:\DOCCI\TMP\listzip.txt,fNew,fRight,rAll

 

!Цикл распаковки zip-файлов через запуск внешнего процесса

#ЦИКЛ:2?d:\docci\tmp\listzip.txt

#[ФАЙЛОВЫЕ ОПЕРАЦИИ] {9}

/1/тип операции (индекс): 4

/2/входной (базовый) каталог:

/3/шаблоны входных файлов: *.*

/4/базировать путь к файлу (признак): 0

/5/выходной каталог: d:\docci\files_&1|1 \

!/5/выходной каталог: d:\docci\tmpfiles\

/6/шаблоны файлов очистки: *

/7/режим очистки подкаталогов (индекс): 0

/8/создать структуру базы (признак): 0

/9/левый список (признак): 1

/10/правый список (признак): 0

/11/содержимое списка (индекс): 0

[ЗАПУСК ВНЕШНЕГО ПРОЦЕССА]

/1/имя внешнего процесса: c:\exe\pkunzip.exe

/2/источник выбора процесса (индекс): -1

/3/параметры командной строки: -o &1

/4/путь доступа: d:\docci\files_&1|1 \

!/4/путь доступа: d:\docci\tmpfiles\

/5/добавить параметр (признак): 0

/6/режим открытия внешнего процесса (индекс): 0

/7/время внешнего процесса: 2500

>ВНЕШНИЙ ПРОЦЕСС

#КОНЕЦ:2

 

!Удаление zip-файлов правого списка из каталога files_&1

!после распаковки

#[ФАЙЛОВЫЕ ОПЕРАЦИИ] {10}

/1/тип операции (индекс): 0

/2/входной (базовый) каталог:

/3/шаблоны входных файлов: *.*

/4/базировать путь к файлу (признак): 0

/5/выходной каталог:

/6/шаблоны файлов очистки: *.*

/7/режим очистки подкаталогов (индекс): -1

/8/создать структуру базы (признак): 0

/9/левый список (признак): 0

/10/правый список (признак): 1

/11/содержимое списка (индекс): 0

/12/использовать корзину (признак): 0

>УДАЛИТЬ

 

!Создание правого списка htm-файлов из каталога files_&1

!и запись списка в файл d:\docci\tmp\listhtm_&1 .txt !(например,

!создали файл listhtm_am.txt, содержащий файлы Am00r.htm, Am01r.htm и др.)

#[СОЗДАНИЕ СПИСКОВ] {11}

/1/источник списка (индекс): 0

!/2/входной (базовый) каталог: d:\docci\tmpfiles_&1|1 \

/2/входной (базовый) каталог: d:\docci\files_&1|1 \

/3/шаблоны входных файлов: *.htm

/4/искать в подкаталогах (признак): 1

/5/неполный путь к файлу (признак): 1

/6/левый список (признак): 0

/7/правый список (признак): 1

/8/новый список (признак): 1

/9/добавить в список (признак): 0

/10/содержимое списка (индекс): 0

/11/уровень от базы (режим):   >=

/12/уровень от базы (значение): 0

>ПО ВХОДНОМУ КАТАЛОГУ

>ЗАПИСАТЬ СПИСОК: D:\DOCCI\TMP\listhtm_&1|1 .txt,fNew,fRight,rAll

 

!Редактирование файла listhtm_&1|1 .txt

!(добавление лексем с именами программы и теста)

#[ЗАМЕНА КОНТЕКСТОВ] {12}

/1/входной текст (индекс): 1

/2/выходной текст (индекс): 0

/3/входной каталог: d:\docci\tmp\listhtm_&1|1 .txt

/4/шаблоны входных файлов: *

/5/искать в подкаталогах (признак): 0

/6/без учета регистра (признак): 1

/7/режим замены (индекс): 1

/8/входная кодировка (индекс): 3

/9/выходной каталог: d:\docci\tmp\

/10/рабочий каталог:

/11/сводный файл строк редакции (признак): 0

/12/только протокол (признак): 0

/13/вид протокола (индекс): 0

/14/статистика для протокола (признак): 0

/15/файл запроса: d:\docci\doccont2.txt

[ПАРАМЕТРЫ ВЫХОДНОГО КАТАЛОГА]

/1/запись измененных файлов (индекс): 1

/2/выходной каталог: d:\docci\tmp\

/3/сохранять копии (признак): 0

/4/рабочий каталог:

/5/копировать дерево файлов исходного каталога (признак): 0

/6/копировать в рабочий каталог (индекс): 0

>НАЧАТЬ: 12

 

!Цикл по файлу, созданному на предыдущем этапе

!(цикл охватывает пункты 13 – 18)

#ЦИКЛ:3?d:\docci\tmp\listhtm_&1|1 .txt

!Запись в третью ячейку общего архива {{3}} обращения к п/п

!с параметрами на Си из файла d:\docci\files_&1|1 \&2

#[ЗАМЕНА КОНТЕКСТОВ] {13}

/1/входной текст (индекс): 1

/2/выходной текст (индекс): 0

!/3/входной каталог: d:\docci\tmpfiles_&1|1 \&2

/3/входной каталог: d:\docci\files_&1|1 \&2

/4/шаблоны входных файлов: *

/5/искать в подкаталогах (признак): 0

/6/без учета регистра (признак): 1

/7/режим замены (индекс): 1

/8/входная кодировка (индекс): 3

/9/выходной каталог: d:\docci\rabfiles\

/10/рабочий каталог:

/11/сводный файл строк редакции (признак): 0

/12/только протокол (признак): 0

/13/вид протокола (индекс): 0

/14/статистика для протокола (признак): 0

/15/файл запроса: d:\docci\doccont3.txt

[ПАРАМЕТРЫ ВЫХОДНОГО КАТАЛОГА]

/1/запись измененных файлов (индекс): 0

/2/выходной каталог: d:\docci\rabfiles\

/3/сохранять копии (признак): 0

/4/рабочий каталог: d:\docci\rabfiles\

/5/копировать дерево файлов исходного каталога (признак): 0

/6/копировать в рабочий каталог (индекс): 0

>НАЧАТЬ: 12

 

!Запись в четвертую ячейку архива {{4}} теста на языке Си из файла

! d:\docci\files_&1|1 \&3

#[ЗАМЕНА КОНТЕКСТОВ] {14}

/1/входной текст (индекс): 1

/2/выходной текст (индекс): 0

!/3/входной каталог: d:\docci\tmpfiles_&1|1 \&3

/3/входной каталог: d:\docci\files_&1|1 \&3

/4/шаблоны входных файлов: *

/5/искать в подкаталогах (признак): 0

/6/без учета регистра (признак): 1

/7/режим замены (индекс): 1

/8/входная кодировка (индекс): 3

/9/выходной каталог: d:\docci\rabfiles\

/10/рабочий каталог:

/11/сводный файл строк редакции (признак): 0

/12/только протокол (признак): 0

/13/вид протокола (индекс): 0

/14/статистика для протокола (признак): 0

/15/файл запроса: d:\docci\doccont7.txt

[ПАРАМЕТРЫ ВЫХОДНОГО КАТАЛОГА]

/1/запись измененных файлов (индекс): 0

/2/выходной каталог: d:\docci\rabfiles\

/3/сохранять копии (признак): 0

/4/рабочий каталог: d:\docci\rabfiles\

/5/копировать дерево файлов исходного каталога (признак): 0

/6/копировать в рабочий каталог (индекс): 0

>НАЧАТЬ: 12

 

!Изменение прописных букв на строчные в именах п/п и идентификаторах,

!включая замену русских букв, одинакового написания, на латинские

#[ЗАМЕНА КОНТЕКСТОВ] {15}

/1/входной текст (индекс): 1

/2/выходной текст (индекс): 0

!/3/входной каталог: d:\docci\tmpfiles_&1|1 \&1

/3/входной каталог: d:\docci\files_&1|1 \&1

/4/шаблоны входных файлов: *

/5/искать в подкаталогах (признак): 0

/6/без учета регистра (признак): 0

/7/режим замены (индекс): 1

/8/входная кодировка (индекс): 3

/9/выходной каталог: d:\docci\cat\&1|1 \

/10/рабочий каталог:

/11/сводный файл строк редакции (признак): 0

/12/только протокол (признак): 0

/13/вид протокола (индекс): 0

/14/статистика для протокола (признак): 0

/15/файл запроса: d:\docci\doccont9.txt

[ПАРАМЕТРЫ ВЫХОДНОГО КАТАЛОГА]

/1/запись измененных файлов (индекс): 0

/2/выходной каталог: d:\docci\cat\&1|1 \

/3/сохранять копии (признак): 0

/4/рабочий каталог: d:\docci\cat\&1|1 \

/5/копировать дерево файлов исходного каталога (признак): 0

/6/копировать в рабочий каталог (индекс): 0

>НАЧАТЬ: 12

 

!Добавление к именам п/п окончания _c

#[ЗАМЕНА КОНТЕКСТОВ] {16}

/1/входной текст (индекс): 1

/2/выходной текст (индекс): 0

/3/входной каталог: d:\docci\cat\&1|1 \&1

/4/шаблоны входных файлов: *

/5/искать в подкаталогах (признак): 0

/6/без учета регистра (признак): 0

/7/режим замены (индекс): 1

/8/входная кодировка (индекс): 3

/9/выходной каталог: d:\docci\cat\&1|1 \

/10/рабочий каталог:

/11/сводный файл строк редакции (признак): 0

/12/только протокол (признак): 0

/13/вид протокола (индекс): 0

/14/статистика для протокола (признак): 0

/15/файл запроса: d:\docci\doccont10.txt

[ПАРАМЕТРЫ ВЫХОДНОГО КАТАЛОГА]

/1/запись измененных файлов (индекс): 1

/2/выходной каталог: d:\docci\cat\&1|1 \

/3/сохранять копии (признак): 0

/4/рабочий каталог:

/5/копировать дерево файлов исходного каталога (признак): 0

/6/копировать в рабочий каталог (индекс): 0

>НАЧАТЬ: 12

 

!Замена содержимого раздела 'Использование' на обращение к п/п

!на Си и содержимого раздела 'Пример использования' на тест к п/п на Си

#[ЗАМЕНА КОНТЕКСТОВ] {17}

/1/входной текст (индекс): 1

/2/выходной текст (индекс): 0

/3/входной каталог: d:\docci\cat\&1|1 \&1

/4/шаблоны входных файлов: *

/5/искать в подкаталогах (признак): 0

/6/без учета регистра (признак): 0

/7/режим замены (индекс): 1

/8/входная кодировка (индекс): 3

/9/выходной каталог: d:\docci\cat\&1|1 \

/10/рабочий каталог:

/11/сводный файл строк редакции (признак): 0

/12/только протокол (признак): 0

/13/вид протокола (индекс): 0

/14/статистика для протокола (признак): 0

/15/файл запроса: d:\docci\doccont6.txt

[ПАРАМЕТРЫ ВЫХОДНОГО КАТАЛОГА]

/1/запись измененных файлов (индекс): 1

/2/выходной каталог: d:\docci\cat\&1|1 \

/3/сохранять копии (признак): 0

/4/рабочий каталог:

/5/копировать дерево файлов исходного каталога (признак): 0

/6/копировать в рабочий каталог (индекс): 0

>НАЧАТЬ: 12

 

!Замена в обращений к первым операторам п/п на языке ФОРТРАН

! subroutine fname( … )  на их аналог на языке Си

#[ЗАМЕНА КОНТЕКСТОВ] {18}

/1/входной текст (индекс): 1

/2/выходной текст (индекс): 0

/3/входной каталог: d:\docci\cat\&1|1 \&1

/4/шаблоны входных файлов: *

/5/искать в подкаталогах (признак): 0

/6/без учета регистра (признак): 0

/7/режим замены (индекс): 1

/8/входная кодировка (индекс): 3

/9/выходной каталог: d:\docci\cat\&1|1 \

/10/рабочий каталог:

/11/сводный файл строк редакции (признак): 0

/12/только протокол (признак): 0

/13/вид протокола (индекс): 0

/14/статистика для протокола (признак): 0

/15/файл запроса: d:\docci\doccont11.txt

[ПАРАМЕТРЫ ВЫХОДНОГО КАТАЛОГА]

/1/запись измененных файлов (индекс): 1

/2/выходной каталог: d:\docci\cat\&1|1 \

/3/сохранять копии (признак): 0

/4/рабочий каталог: d:\docci\cat\&1|1 \

/5/копировать дерево файлов исходного каталога (признак): 0

/6/копировать в рабочий каталог (индекс): 0

>НАЧАТЬ: 12

 

#КОНЕЦ:3

!Создание левого списка файлов htm-файлов каталога d:\docci\cat\&1|1 \

!(например, для подкаталога am)

#[СОЗДАНИЕ СПИСКОВ] {19}

/1/источник списка (индекс): 0

/2/входной (базовый) каталог: d:\docci\cat\&1|1 \

/3/шаблоны входных файлов: *.htm

/4/искать в подкаталогах (признак): 1

/5/неполный путь к файлу (признак): 0

/6/левый список (признак): 1

/7/правый список (признак): 0

/8/новый список (признак): 1

/9/добавить в список (признак): 0

/10/содержимое списка (индекс): 0

/11/уровень от базы (режим):   >=

/12/уровень от базы (значение): 0

>ПО ВХОДНОМУ КАТАЛОГУ

 

!Создание правого абстрактного списка htm-файлов каталога

! d:\docci\cat\&1|1 \ с добавлением к именам файлов окончания _c

#[СОЗДАНИЕ СПИСКОВ] {20}

/1/источник списка (индекс): 5

/2/входной (базовый) каталог:

/3/шаблоны входных файлов: *.*

/4/искать в подкаталогах (признак): 1

/5/неполный путь к файлу (признак): 0

/6/левый список (признак): 0

/7/правый список (признак): 1

/8/новый список (признак): 1

/9/добавить в список (признак): 0

/10/содержимое списка (индекс): 0

/11/уровень от базы (режим):   >=

/12/уровень от базы (значение): 0

[СОЗДАНИЕ АБСТРАКТНОГО СПИСКА]

/1/каталог: d:\docci\cat\&1|1 \

/2/префикс имени файла: _

/3/начальный индекс: 1

/4/расширение:

/5/размерность списка: -1

/6/добавление к имени файла/каталога: _c

/7/режим добавления (индекс): 1

/8/вид списка: 12

>АБСТРАКТНЫЙ СПИСОК

 

!Переименование файлов из левого списка в правый (например, Am00r.htm в Am00r_c.htm )

#[ФАЙЛОВЫЕ ОПЕРАЦИИ] {21}

/1/тип операции (индекс): 1

/2/входной (базовый) каталог:

/3/шаблоны входных файлов: *.*

/4/базировать путь к файлу (признак): 0

/5/выходной каталог:

/6/шаблоны файлов очистки: *.*

/7/режим очистки подкаталогов (индекс): -1

/8/создать структуру базы (признак): 0

/9/левый список (признак): 1

/10/правый список (признак): 0

/11/содержимое списка (индекс): 0

/12/использовать корзину (признак): 0

>ПЕРЕИМЕНОВАТЬ

 

!Перевод имен файлов на нижний регистр в каталоге d:\docci\cat\&1|1 \

!(например, . Am00r_c.htm в am00r_c.htm )

#[ЗАМЕНА РЕГИСТРА] {22}

/1/входной текст (индекс): 0

/2/выходной текст (индекс): 0

/3/входной каталог: d:\docci\cat\&1|1 \

/4/шаблоны входных файлов: *.*

/5/искать в подкаталогах (признак): 1

/6/режим замены (индекс): 1

/7/выходной каталог: d:\docci\cat\&1|1 \

/8/рабочий каталог:

/9/только протокол (признак): 0

/10/вид протокола (индекс): 0

/11/статистика для протокола (признак): 0

/12/тип преобразования (индекс): 0

/13/входная кодировка (индекс): 0

[ПАРАМЕТРЫ ВЫХОДНОГО КАТАЛОГА]

/1/запись измененных файлов (индекс): 1

/2/выходной каталог: d:\docci\cat\&1|1 \

/3/сохранять копии (признак): 0

/4/рабочий каталог:

/5/копировать дерево файлов исходного каталога (признак): 0

/6/копировать в рабочий каталог (индекс): 0

>НАЧАТЬ2

 

#КОНЕЦ:1

 

#[КОНЕЦ СЦЕНАРИЯ] {23}