Страница:
пулярная, но ошибочная).
111111. Полный перечень директив
В описании используются обозначения:
LB - означает двухсимвольную метку, на которую можно
ссылаться в последующем тексте документа (то
есть после ее определения). Ссылка вида
`\*(LB' обычно ссылается на личное свойство ди-
рективы, например, на номер раздела для раз-
дела, а `\n(LB' - на номер страницы. Поскольку
иногда метка обязательна по синтаксису, а метки
проверяются на уникальность, то существует спе-
циальная метка LB, которая не проверяется и
хранит именно последнее определение.
TEXT - некоторый текст. При наличии в нем пробелов
заключается в кавычки. Кавычки в внутри `TEXT'
удваиваются.
N - число.
A - аргументы директивы будут рассмотренны от-
дельно.
[A] - аргумент не является обязательным.
[A1 [А2]] -
Второй аргумент может использоваться только при
наличии первого. (Пустой аргумент директивы
обозначается парой кавычек.)
АБЗАЦЫ.
lp Абзац без отступа.
pp Абзац с красной строки.
19
qp [A] Абзац - примечание. Допускаются аргументы:
`+' - печатать слово `Примечание', `-' - не
делать абзацный отступ.
ip [TEXT [N]]
Абзац с ключом `TEXT'. Второй аргумент - за-
поминаемый под ключ отступ. Существует в
форме `jp' - после ключа ставить символ
`тире'.
np [LB [A]]
Нумерованный абзац. A - символ, отделяющий
номер от текста.
ap Абзац без отступа, имеющий базу предудущего
абзаца .np/.ip/.jp.
ba [A [B]]
Директива установки отступа абзацев (базы).
Аргумент А устанавливает отступ и может при-
нимать значения: `+' - увеличение на стан-
дартный отступ; `++' - увеличение на 2 стан-
дартных отступа; `цифра' - увеличение на это
число позиций; `-' или без аргумента - возв-
рат в предыдущее; `0' - сброс базы в 0. Ар-
гумент В аналогичен параметру N в директивах
.ip/.jp. Глубина вложенности директивы .ba -
3.
Все директивы абзацев (l,p,q,i,j,n,a) пропускают перед
выводом число строк в соответствии к ключом `-v' ко-
манды mx(1). При замене второй буквы в имени с `p' на
`q' пропуска не производится.
СНОСКИ.
f+ [A] Начало абзацной сноски. Аргумент `A' - слитый
с указателем сноски знак препинания. Сноска
завершается командой `f-'. Существует в крат-
кой форме `f=' с первым аргументом - текстом
сноски, а вторым - слитым со знаком препина-
ния.
БЛОКИ.
( [A] Начало блока. Допускаются аргументы: `l' - не
делать дополнительный отступ, `L' - игнориро-
вать текущую базу. Блок завершается директи-
вой `) [c]', где аргумент `c' требует непре-
рывности блока. Блок не нарушает текущих ус-
ловий форматирования.
| TEXT Краткая форма выровненного по левой базе блока
размером в одну строку. TEXT может включать
до 9 слов.
{ Начало плавающего блока, завершаемого директи-
20
вой `}'.
[ [LB] В данном случае первая квадратная скобка есть
название директивы формула. Обычное использо-
вание имеет вид (для формулы dx/da=10*w):
.[ AA
dx
-- = 10w \\*f
dt
.]
Внутри блоков разрешается использовать директивы `c+' -
начать центрировать строки, `c-' - закончить центриро-
вать строки и `c= TEXT' - сцентрировать строку `TEXT'.
С известной осторожностью внутри блоков можно использо-
вать некоторые директивы системы nroff из серии `in',
`ti', `fi', `nf', `tl', `ta'.
В любом месте текста можно применять директивы: `u+' -
начать подчеркивать строки, `u-' - закончить подчерки-
вать строки, `u= TEXT' - подчеркнуть строку TEXT.
РАЗДЕЛЫ.
s0 TEXT Раздел без номера.
sh TEXT Аналог `s0' со словом `ГЛАВА' и римской нуме-
рацией. Подразумевает дальнейшее дробление
на `s1'. Для дробления на `s2' необходимо
после каждой директивы `sh' выполнять команду
`.nr s1 \n(sh'.
s1 TEXT [LB]
Раздел первого уровня нумерации. Соответст-
венно есть `s2', `s3' и `s4'.
z1 [LB] Набор `z1...z5' служит для дробления доку-
мента ниже уровня `s0...s4' без сбора содер-
жания. По своим свойствам эти директивы по-
хожи на абзац, но продолжают нумерацию разде-
лов.
СТРУКТУРА ДОКУМЕНТА.
es [A] Титульный лист начинается с директивы `es' с
аргументом - регистрационным номером доку-
мента. Завершается директивой `pd'. При на-
личии у директивы `pd' аргумента `+' в конце
аннотации допечатывается статистика по доку-
менту.
По своим режимам форматирования аналогичен
блоку. При наличии аннотации используется
сочетание `es', `an', `pd'. Место между `an'
и `pd' по своим режимам форматирования анало-
21
гично абзацу.
Существует специальная директива `to A' для
пропуска строк на титульном листе. `A' -
принимает значение от 1 до 11 - номер 1/12
части титульного листа по высоте. Без аргу-
мента соответствует установке на предпредпос-
леднюю строку листа.
РАЗНОЕ.
bo TEXT [LB]
Описание книжки. Первый аргумент - название,
автор и т.д. Ссылка на метку дает номер в
библиографии. Существует макро с обратным
порядком аргументов: "ob LB TEXT", где метка
обязательна.
g= TEXT [LB]
Слово TEXT появится в списке терминов. Ис-
пользование в дальнейшем тексте директивы `g+
LB' добавит к слову номер текущей страницы.
pf TEXT [LB]
Название рисунка.
th TEXT [LB]
Название таблицы.
lb LB Запомнить страницу.
hl [A1 [A2]]
Провести горизонтальную линию от базы до
конца листа. Может иметь один/два аргумента
- от какой позиции по какую (то есть игнори-
ровать базу и длину строки).
si Вместе с `sk' и `sp' - пропуск строк. `Sp'
пропускает одну или `аргумент' строк если в
данном месте `mx' разрешает пропускать
строки. `Sk' работает аналогично, но пропус-
кает всегда (но не далее начала очередного
листа). `Si' пропускает `аргумент' строк,
если лист большой длины и ничего, если - ма-
ленькой. Для выделения текста пустыми стро-
ками рекомендуется использовать `si' без ар-
гумента - то есть одна или ни одной строки (в
соответствии с ключем `-v' команды mx(1)).
22
Литература
1. Kernighan B.W. A TROFF Tutorial. UNIX Programmer's Manu-
al vol.2, pp. 230-244, Bell Telephone Laboratories, In-
corporated. Murray Hill, New Jersey. Holt, Rinehart and
Winston. 1983
2. Lesk M.E. TBL - A Program to Format Tables. UNIX
Programmer's Manual vol.2, pp. 157-174, Bell Telephone
Laboratories, Incorporated. Murray Hill, New Jersey.
Holt, Rinehart and Winston. 1983
3. Lesk M.E. Typing Documents on the UNIX System. UNIX
Programmer's Manual vol.2, pp.125-145, Bell Telephone
Laboratories, Incorporated. Murray Hill, New Jersey.
Holt, Rinehart and Winston. 1983
4. Ossanna J.F. NROFF/TROFF User's Manual. UNIX
Programmer's Manual vol.2, pp. 196-229, Bell Telephone
Laboratories, Incorporated. Murray Hill, New Jersey.
Holt, Rinehart and Winston. 1983
5. Waterloo SCRIPT Reference Guide. University of Waterloo,
Ontario. 1976
23
СОДЕРЖАНИЕ
1. Введение............................................ 3
2. Подготовка документа................................ 4
3. Управляющие директивы............................... 4
4. Абзацы.............................................. 6
5. Метки............................................... 11
6. Сноски.............................................. 12
7. Блоки............................................... 12
8. Заголовки........................................... 15
9. Разное.............................................. 17
10. Вызов............................................... 17
11. Полный перечень директив............................ 19
88.x.3. Mx - копи райт! <tasha>
111111. Полный перечень директив
В описании используются обозначения:
LB - означает двухсимвольную метку, на которую можно
ссылаться в последующем тексте документа (то
есть после ее определения). Ссылка вида
`\*(LB' обычно ссылается на личное свойство ди-
рективы, например, на номер раздела для раз-
дела, а `\n(LB' - на номер страницы. Поскольку
иногда метка обязательна по синтаксису, а метки
проверяются на уникальность, то существует спе-
циальная метка LB, которая не проверяется и
хранит именно последнее определение.
TEXT - некоторый текст. При наличии в нем пробелов
заключается в кавычки. Кавычки в внутри `TEXT'
удваиваются.
N - число.
A - аргументы директивы будут рассмотренны от-
дельно.
[A] - аргумент не является обязательным.
[A1 [А2]] -
Второй аргумент может использоваться только при
наличии первого. (Пустой аргумент директивы
обозначается парой кавычек.)
АБЗАЦЫ.
lp Абзац без отступа.
pp Абзац с красной строки.
19
qp [A] Абзац - примечание. Допускаются аргументы:
`+' - печатать слово `Примечание', `-' - не
делать абзацный отступ.
ip [TEXT [N]]
Абзац с ключом `TEXT'. Второй аргумент - за-
поминаемый под ключ отступ. Существует в
форме `jp' - после ключа ставить символ
`тире'.
np [LB [A]]
Нумерованный абзац. A - символ, отделяющий
номер от текста.
ap Абзац без отступа, имеющий базу предудущего
абзаца .np/.ip/.jp.
ba [A [B]]
Директива установки отступа абзацев (базы).
Аргумент А устанавливает отступ и может при-
нимать значения: `+' - увеличение на стан-
дартный отступ; `++' - увеличение на 2 стан-
дартных отступа; `цифра' - увеличение на это
число позиций; `-' или без аргумента - возв-
рат в предыдущее; `0' - сброс базы в 0. Ар-
гумент В аналогичен параметру N в директивах
.ip/.jp. Глубина вложенности директивы .ba -
3.
Все директивы абзацев (l,p,q,i,j,n,a) пропускают перед
выводом число строк в соответствии к ключом `-v' ко-
манды mx(1). При замене второй буквы в имени с `p' на
`q' пропуска не производится.
СНОСКИ.
f+ [A] Начало абзацной сноски. Аргумент `A' - слитый
с указателем сноски знак препинания. Сноска
завершается командой `f-'. Существует в крат-
кой форме `f=' с первым аргументом - текстом
сноски, а вторым - слитым со знаком препина-
ния.
БЛОКИ.
( [A] Начало блока. Допускаются аргументы: `l' - не
делать дополнительный отступ, `L' - игнориро-
вать текущую базу. Блок завершается директи-
вой `) [c]', где аргумент `c' требует непре-
рывности блока. Блок не нарушает текущих ус-
ловий форматирования.
| TEXT Краткая форма выровненного по левой базе блока
размером в одну строку. TEXT может включать
до 9 слов.
{ Начало плавающего блока, завершаемого директи-
20
вой `}'.
[ [LB] В данном случае первая квадратная скобка есть
название директивы формула. Обычное использо-
вание имеет вид (для формулы dx/da=10*w):
.[ AA
dx
-- = 10w \\*f
dt
.]
Внутри блоков разрешается использовать директивы `c+' -
начать центрировать строки, `c-' - закончить центриро-
вать строки и `c= TEXT' - сцентрировать строку `TEXT'.
С известной осторожностью внутри блоков можно использо-
вать некоторые директивы системы nroff из серии `in',
`ti', `fi', `nf', `tl', `ta'.
В любом месте текста можно применять директивы: `u+' -
начать подчеркивать строки, `u-' - закончить подчерки-
вать строки, `u= TEXT' - подчеркнуть строку TEXT.
РАЗДЕЛЫ.
s0 TEXT Раздел без номера.
sh TEXT Аналог `s0' со словом `ГЛАВА' и римской нуме-
рацией. Подразумевает дальнейшее дробление
на `s1'. Для дробления на `s2' необходимо
после каждой директивы `sh' выполнять команду
`.nr s1 \n(sh'.
s1 TEXT [LB]
Раздел первого уровня нумерации. Соответст-
венно есть `s2', `s3' и `s4'.
z1 [LB] Набор `z1...z5' служит для дробления доку-
мента ниже уровня `s0...s4' без сбора содер-
жания. По своим свойствам эти директивы по-
хожи на абзац, но продолжают нумерацию разде-
лов.
СТРУКТУРА ДОКУМЕНТА.
es [A] Титульный лист начинается с директивы `es' с
аргументом - регистрационным номером доку-
мента. Завершается директивой `pd'. При на-
личии у директивы `pd' аргумента `+' в конце
аннотации допечатывается статистика по доку-
менту.
По своим режимам форматирования аналогичен
блоку. При наличии аннотации используется
сочетание `es', `an', `pd'. Место между `an'
и `pd' по своим режимам форматирования анало-
21
гично абзацу.
Существует специальная директива `to A' для
пропуска строк на титульном листе. `A' -
принимает значение от 1 до 11 - номер 1/12
части титульного листа по высоте. Без аргу-
мента соответствует установке на предпредпос-
леднюю строку листа.
РАЗНОЕ.
bo TEXT [LB]
Описание книжки. Первый аргумент - название,
автор и т.д. Ссылка на метку дает номер в
библиографии. Существует макро с обратным
порядком аргументов: "ob LB TEXT", где метка
обязательна.
g= TEXT [LB]
Слово TEXT появится в списке терминов. Ис-
пользование в дальнейшем тексте директивы `g+
LB' добавит к слову номер текущей страницы.
pf TEXT [LB]
Название рисунка.
th TEXT [LB]
Название таблицы.
lb LB Запомнить страницу.
hl [A1 [A2]]
Провести горизонтальную линию от базы до
конца листа. Может иметь один/два аргумента
- от какой позиции по какую (то есть игнори-
ровать базу и длину строки).
si Вместе с `sk' и `sp' - пропуск строк. `Sp'
пропускает одну или `аргумент' строк если в
данном месте `mx' разрешает пропускать
строки. `Sk' работает аналогично, но пропус-
кает всегда (но не далее начала очередного
листа). `Si' пропускает `аргумент' строк,
если лист большой длины и ничего, если - ма-
ленькой. Для выделения текста пустыми стро-
ками рекомендуется использовать `si' без ар-
гумента - то есть одна или ни одной строки (в
соответствии с ключем `-v' команды mx(1)).
22
Литература
1. Kernighan B.W. A TROFF Tutorial. UNIX Programmer's Manu-
al vol.2, pp. 230-244, Bell Telephone Laboratories, In-
corporated. Murray Hill, New Jersey. Holt, Rinehart and
Winston. 1983
2. Lesk M.E. TBL - A Program to Format Tables. UNIX
Programmer's Manual vol.2, pp. 157-174, Bell Telephone
Laboratories, Incorporated. Murray Hill, New Jersey.
Holt, Rinehart and Winston. 1983
3. Lesk M.E. Typing Documents on the UNIX System. UNIX
Programmer's Manual vol.2, pp.125-145, Bell Telephone
Laboratories, Incorporated. Murray Hill, New Jersey.
Holt, Rinehart and Winston. 1983
4. Ossanna J.F. NROFF/TROFF User's Manual. UNIX
Programmer's Manual vol.2, pp. 196-229, Bell Telephone
Laboratories, Incorporated. Murray Hill, New Jersey.
Holt, Rinehart and Winston. 1983
5. Waterloo SCRIPT Reference Guide. University of Waterloo,
Ontario. 1976
23
СОДЕРЖАНИЕ
1. Введение............................................ 3
2. Подготовка документа................................ 4
3. Управляющие директивы............................... 4
4. Абзацы.............................................. 6
5. Метки............................................... 11
6. Сноски.............................................. 12
7. Блоки............................................... 12
8. Заголовки........................................... 15
9. Разное.............................................. 17
10. Вызов............................................... 17
11. Полный перечень директив............................ 19
88.x.3. Mx - копи райт! <tasha>