Texinfo

Формат документации GNU

для Texinfo версии 4.0, 28 сентября 1999г

Роберт Дж. Чассел
Ричард М. Столмен


(1)

Первый слог в слове "Texinfo" произносится как "тек", а не "текс". Такое необычное произношение происходит от произношения слова TeX, но не идентично ему. Буква `X' в слове TeX, на самом деле, -- это греческая буква "хи", а не английская "экс". Произносите TeX, как если бы `X' был последним звуком имени `Bach'; но в Texinfo произносите `x' как `к'. Пишите "Texinfo" с заглавной "T" и остальными строчными буквами.

(2)

В некоторых документах первый потомок не имеет указателя `Previous'. Иногда последний потомок указывает как на `Next' на следующую ноду более высокого уровня.

(3)

Вы также можете использовать программу texi2roff, если у вас нет TeX; так как Texinfo предназначена для использования с TeX, texi2roff здесь не рассматривается. texi2roff не входит в стандартную поставку GNU, не поддерживается и не соответствует всем последним возможностям языка Texinfo, описанным в данном руководстве.

(4)

Слово аргумент употребляется здесь в смысле, принятом в математике, и не имеет отношения к дискуссиям между людьми; оно относится к информации, передаваемой команде. В соответствии со словарем Oxford English Dictionary, это слово происходит от латинского разъяснять, доказывать; таким образом, оно означает `очевидность, предоставленная как доказанное', то есть `предоставленная информация', что приводит к его значению в математике. В другой ветви заимствования это слово стало означать `высказываться так, чтобы другие могли высказывать противоположные суждения', что привело к значению слова `аргумент' относительно к спору.

(5)

Мы нашли, что полезно обращаться к версиям руководств как "редакция", а к версиям программ как "версия"; иначе, говоря одними словами и о программах, и о документации, мы вводим друг в заблуждение.

(6)

Меню могут привести вас к любой ноде, вне зависимости от иерархической структуры, даже к нодам другого Info-файла. Однако, команды обновления режима Texinfo для GNU Emacs могут создавать только меню подчиненных нод. Обычно для обращения к другим нодам применяют перекрестные ссылки.

(7)

Нетрудно расширить Texinfo для аналогичной работы с Си, Фортраном или другими языками.

(8)

Сноски могут дополнять или расширять основной текст, но читатель должен иметь возможность понять текст, не читая сносок. Подробное обсуждение применения сносок вы можете прочитать в книге The Chicago Manual of Style, опубликованной издательством University of Chicago Press.

(9)

Это пример сноски.

(10)

На данный момент @definfoenclose работает только с texinfo-format-buffer и texinfo-format-region, но не с @command{makeinfo

(11)

Обратите внимание на использование в качестве разделителя каталогов символа `;' вместо `:' в этих системах.

(12)

В системах MS-DOS/MS-Windows, Info также попробует файл с расширением `.inf'.

(13)

Обратите внимание на использование `;' в качестве разделителя каталогов и на другой синтаксис для получения значений переменных среды.

(14)

В системах MS-DOS/MS-Windows, используйте вместо двоеточия точку с запятой.

(15)

Может быть, эту команду стоило назвать @refillandindent, но @refill короче, и имя было выбрано до того, как стали возможны отступы.


This document was generated on 2 April 2002 using texi2html 1.56k.

Наш баннер
Вы можете установить наш баннер на своем сайте или блоге, скопировав этот код:
RSS новости