.ЗГ Текстовый форматировщик
.РС 64,60
.АА
.ПС 5
.ЦС Version 1.3
.ЦС (c) Copyright by Mike, 1990,october
.ЦС All right reserwed.
.ПС 5
.ЦС АННОТАЦИЯ
 В данном документе описывается форматировщик текстов FMT.
Он подобен известному текстовому форматировщику текстов
фирмы "Digital equipment corporation" (DEC) -- программе RNO.
 Форматировщик RNO был взят как прообраз, т.к. он достаточно прост
в освоении и удобен в работе.
 Форматировщик FMT не является переносом RNO, это самостоятельная
разработка. Ее возможности вполне достаточны для оформления небольших
текстовых документов (описаний, пояснительных записок, и т.п.)
 Форматировщик предназначен для разбивки текста на страницы,
выравнивания текста по правой и левой границам страницы,
получения оглавления.
 Возможно применение форматировщика для получения исходных текстовых
файлов для программы AUTODOC - программы автоматизированного оформления
документов.
 Для получения дополнительной информации следует обращаться:
.ЦС 454080 Челябинск, пр.Ленина, 87 (ЧПИ, корп.3/Б), а.1001
.НС
.ГЛ Работа с форматировщиком
.ПУ 1 Запуск форматировщика
  Запуск форматировщика возможен двумя способами:
.ПУ 2 Первый способ
  Для запуска форматировщика в ответ на подсказку системы
введите строку FMT  ,и нажмите <CR>.
Операционная система загрузит форматировщик, и он выдаст Вам
приглашение: FMT>
 В ответ на него наберите командную строку (см. ниже), и нажмите
клавишу <CR>
.ПУ 2 Второй способ
  Для запуска форматировщика в ответ на подсказку системы
введите строку FMT "командная строка" ,и нажмите <CR>.
.ПУ 1 Командная строка форматировщика
.НЛ
 Формат командной строки:
 "выходной файл"[ключи]="входной файл"[ключи]
  Где:
   выходной файл - имя выходного файла в формате МикроДОС
   входной файл  - имя входного  файла в формате МикроДОС
   ключи - см. ниже.
.КЛ
.ПУ 1 Файлы, используемые форматировщиком
.ПУ 2 Формат имени файла
.НЛ
 Формат имени файла:
    [Диск:]имя[.тип]
  Где:
    Диск - имя диска (один символ).
    Имя  - имя файла (не более восьми символов).
    Тип  - тип(расширение) (не более трех символов).
.КЛ
Параметры, указанные в квадратных  скобках, не являются обязательными.
 Если в имени файла опущено имя диска, используется текущий дисковод.
Если в имени файла опущено расширение, то для входного файла
используется расширение "ТXT" ("Text"), а для выходного -
расширение "DOC" ("Document").
.ПУ 2 Входной файл
  Входной файл является текстовым файлом в смысле МикроДОСа,
созданным с помощью любого редактора текста (Микромир'а(MIM), IME, EDI,
WDT и др.). Он содержит форматируемый текст, и директивы форматировщика
для управления форматированием (директивы - см. ниже).
.ПУ 2 Выходной файл
  Выходной файл также является текстовым файлом в смысле МикроДОСа,
и является результатом работы форматировщика. Он содержит отформатированный
текст, пригодный для распечатки с помощью программ SHOW или PRT.
 В качестве выходного файла также возможно применение устройств CON: - дисплея
или LST: -  принтера.
.ПУ 1 Ключи форматировщика.
 Ключи форматировщика являются необязательными параметрами, указываемыми в
команной строке для получения определенных дополнительных функций.
Форматировщик воспринимает следующие ключи:
.НЛ
        /FF - (Format Feed)
        /WT - (Waining)
.КЛ
.ПУ 2 Kлюч /FF
 Kлюч /FF вызывает разделение страниц символом <FF> - "прогон формата"
Символ прогона формата не ставится перед первой страницей.
.ПУ 2 Kлюч /WT
 Kлюч /WT вызывает остановку вывода перед выводом очередной страницы.
При этом на консоль выводится сообщение, что программа приостановлена
, и ждет нажатия любой клавиши для продолжения работы.
Это может быть полезно, например, при выводе непосредственно  на печатающее устройство.
.НС
.ГЛ Управление форматированием
 Tекст в исходном файле располагается произвольно - в строке может
располагаться любое количество строк, с любым числом пробелов между ними.
При форматировании строки будут выравнены (если Вы не отключили
форматирование директивой "КЛ" - см. ниже).
  Для управления форматированием в исходный текст включаются директивы
форматировщика. Они обязательно начинаются с символа '.' (точка),
и каждая директива должна быть первой в строке.
.ПУ 1 Директивы форматировщика.
.ПУ 2 Директива .ЗГ
 Директива .ЗГ задает название форматируемого текста, которое
впоследствии выводится (вместе с номером страницы) первой строкой
каждой страницы.
.НЛ
Формат директивы:
        .ЗГ "название"
.КЛ
.ПУ 2 Директива .РС (Размер Страницы)
  Директива .РС задает размер страницы.
.НЛ
Формат директивы:
        .РС m,n
 Где m,n - натуральные числа, имеющие смысл:
     m - число строк в странице  (по умолчанию 60).
     n - число символов в строке (по умолчанию 55).
.КЛ
.ПУ 2 Директива .АА (АтоАбзац)
 Директива .АА включает режим автоматического выделения абзацев в
тексте. То есть, если строка начинается с любого числа пробелов,
то она будет выделена "красной строкой" с 5-й позиции.
.НЛ
Формат директивы:
        .АА
.КЛ
.ПУ 2 Директива .КА (Конец Автоабзаца)
 Директива .КА выключает режим автоматического выделения параграфов в
тексте .
.НЛ
Формат директивы:
        .КА
.КЛ
.ПУ 2 Директива .АБ (АБзац)
 Директива .АБ выделяет  абзац в
тексте (т.е. следующую строку выделяет "красной строкой".).
.НЛ
Формат директивы:
        .АБ
.КЛ
.ПУ 2 Директива .НЛ (Начало Литерала)
 Директива .НЛ позволяет произвести временный отказ от форматирования
части текста. Весь текст, помещенный после директивы .НЛ , передается
в выходной файл без форматирования. Такой текст называют литералом.
Эта возможность может
оказаться полезной, например, при включении в исходный файл таблиц.
Заканчивается литерал директивой .КЛ
.НЛ
Формат директивы:
        .НЛ
.КЛ
.ПУ 2 Директива .КЛ (Конец Литерала)
 Директива .КЛ заканчивает литерал (см. директиву .НЛ).
Текст, следующий за директивой .КЛ , будет отформатирован.
.НЛ
Формат директивы:
        .КЛ
.КЛ
.ПУ 2 Директива .ЦС (Центровка Строки)
 Директива .ЦС указывает форматировщику, что строку, следующую за
этой директивой необходимо отцентрировать, т.е. поместить посередине
строки. Если длина строки в директиве больше, чем размер строки,
заданный директивой .РС ,то лишняя часть строки обрезается.
.НЛ
Формат директивы:
        .ЦС "строка"
.КЛ
.ПУ 2 Директива .НС (Новая Страница)
 Директива .НС указывает форматировщику начать новую страницу.
.НЛ
Формат директивы:
        .НС
.КЛ
.ПУ 2 Директива .ГЛ (ГЛава)
 Директива .ГЛ открывает новую главу текста. Глава автоматически нумеруется
Название главы включается в оглавление.
В текст включается строка:
.НЛ
     Глава #. "название главы"

Формат директивы:
        .ГЛ "название главы"
.КЛ
.ПУ 2 Директива .ПУ (Параграф Уровня N)
 Директива .ПУ открывает новый параграф текста. Параграф автоматически
нумеруется, его название включается в оглавление. Параметр - уровень
вложенности - показывает, является ли следующая часть текста параграфом,
подпараграфом, и.т.д.
.НЛ
Формат директивы:
        .ПУ n "название параграфа"
Где: n - уровень вложености
.КЛ
.ПУ 2 Директива .ПР (ПРиложение)
 Директива .ПР открывает новое приложение. Приложение автоматически обозначается
латинской буквой. Допускается не более 26 приложений к документу.
Название приложения включается в оглавление.
В текст включается строка:
.НЛ
     Приложение #. "название приложения"

Формат директивы:
        .ПР "название приложения"
.КЛ
.ПУ 2 Директива .ПМ (Проверка Места)
 Директива .ПМ выполняет следующие действия: проверяется число оставшихся
в странице пустых строк. Если число пустых строк меньше, чем число,
заданное в директиве, то начинается новая страница.
.НЛ
Формат директивы:
        .ПМ n
Где: n - требуемое число строк.
.КЛ
.ПУ 2 Директива .ПС (Пустая Строка)
 Директива .ПС включает в выходной файл необхоимого числа пустых строк.
.НЛ
Формат директивы:
        .ПС n
Где: n - требуемое число строк.
.КЛ
.ПУ 2 Директива .ЛГ (Левая Граница)
 Директива .ЛГ сдвигает левую границу отформатированного текста
в требуемую позицию. Для отмены сдвига используется директива ".LM 0".
.НЛ
Формат директивы:
        .ЛГ n
Где: n - номер колонки левой границы текста.
.КЛ
.НС
.ГЛ Диагностика ошибок
 В случае какой-либо ошибки форматтер выдает сообщение об ошибке
и прекращает работу. Возможны следующие сообщения
.ПУ 1 "Ошибка открытия входного файла".
 Чаще всего эта ошибка возникает при попытке отформатировать отсутствующий
файл. Выдается сообщение о данной ошибке и форматировщик прекращает работу.
.ПУ 1 "Ошибка открытия выходного файла".
 Это сообщение выдается, если на диске нет места, или если уже
имеется файл, одноименный с выходным файлом, причем защищенный
от записи, или системный.
.ПУ 1 "Превышена вложенность".
 В директиве ".ПУ" указана вложеность больше 5.
.ПУ 1 "Нет места под оглавление".
 Получившееся оглавление большое и не влезает в оперативную память.
Можно только посоветовать не пользоваться так широко директивами
"CH", "ПУ" и "ПР".
.ПУ 1 "Недопустимый символ".
 В файле обнаружен недопустимый символ - не пробел и не алфавитно-цифровой.
Вслед за данным сообщением выдается шестнадцатиричный код этого символа,
программа игнорирует этот символ и продолжает работу.
.ПУ 1 "Неверная директива".
 Это сообщение означает, что Вы либо ошиблись в написании директивы,
либо Ваша строка начинается с точки (чего недопускает форматтер).
.ПУ 1 "Слишком длинное слово".
 В Вашем файле обнаружено слово длиной больше, чем длина строки
(заданная директивой .РС или по умолчанию).
.НС
.НЛ
.ПР  Форматы директив:
        .ЗГ "название"
        .РС m,n
 Где m,n - натуральные числа, имеющие смысл:
     m - число строк в странице  (по умолчанию 60).
     n - число символов в строке (по умолчанию 55).
        .АА
        .КА
        .АБ
        .НЛ
        .КЛ
        .ЦС "строка"
        .НС
        .ГЛ "название главы"
        .ПУ n "название параграфа"
Где: n - уровень вложености
        .ПР "название приложения"
        .ПМ n
Где: n - требуемое число строк.
        .ПС n
Где: n - требуемое число строк.
        .ЛГ n
Где: n - левая граница текста.
.НС
.ПР  Алфавитный список директив
        .АА
        .АБ
        .ГЛ
        .ЗГ
        .КА
        .КЛ
        .ЛГ
        .НЛ
        .НС
        .ПМ
        .ПР
        .ПС
        .ПУ
        .РС
        .ЦС
.КЛ
