Info

Содержание


Следующая: , Вверх: (dir)

Info: Введение

Проект GNU Project распространяет большинство своих интерактивных руководств в формате Info, которые вы читаете, пользуясь программой чтения Info. Возможно сейчас вы как раз используете программу Info для чтения этого документа.


ПЕРЕВОД: Павел Марьянов для GNU, 03.06.2004 email:acid_jack@ukr.net http://acid-jack.tk


Следующая: , Предыдущая: Top, Вверх: Top

1 Начало работы

Эта первая часть руководства Info описывает, как перемещаться внутри Info. Вторая часть руководства описывает различные расширенные команды Info, и как написать Info в виде выдержки из файла Texinfo. Третья часть кратко объясняет, как создавать файлы Info из файлов Texinfo.

Этот руководство изначально рассчитано для просмотра на компьютере в программе чтения Info, поэтому вы можете пробовать команды Info, читая их описание. Чтение его c бумаги или в HTML-браузере менее эффективно, т.к. вы должны верить на слово тому, что описываемые команды делают действительно то, что написано в руководстве. В любом случае прочтите это руководство, раз уж оно есть у вас; однако, пожалуйста, попробуйте также ознакомиться и с интерактивной версией.

Существует два способа просмотра интерактивной версии этого руководства:

  1. Введите info в командной строке своего командного процессора. При этом способе используется автономная программа, разработанная для чтения файлов Info.
  2. Введите emacs в командной строке; затем наберите C-h i (Control-h плюс i). При этом способе используется режим Info программы Emacs - редактора со множеством других возможностей.

В любом случае, затем введите mInfo (просто буквы) с последующим нажатием на <RET> - клавиша “Return” или “Enter”. На этом этапе вы должны будете приготовиться к следованию инструкциям этого руководства по мере чтения их с экрана.


Следующая: , Вверх: Начало работы

1.1 Запуск Info в маленьком экране

(В программе Info вы увидите этот раздел только, если ваш терминал имеет небольшое число строк; большинство программ чтения пропускают его не глядя.)

Т.к. ваш терминал имеет относительно небольшое число строк на своем экране, для начала необходимо дать вам особую консультацию.

Если вы видите текст `--All----' в правом нижнем углу экрана, это означает, что текст, на который вы смотрите, целиком представлен на экране. Если вместо этого вы видите `--Top----', это означает, что еще ниже есть не поместившийся текст. Чтобы перейти далее по тексту и увидеть следующий экран, нажмите на <SPC> - клавишу ПРОБЕЛ. Чтобы вернуться назад, нажмите клавишу `Backspace' или `DEL' (на некоторых клавиатурах эта клавиша может быть обозначена как `Delete').


Следующая: , Предыдущая: Справка-Маленький-экран, Вверх: Начало работы

1.2 Как пользоваться Info

Вы разговариваете с программой Info для чтения документации.

Существуют два способа использования Info: из Emacs или как автономной программы чтения, которую вы можете запустить в командном процессоре, используя команду info.

Прямой сейчас вы смотрите на один Узел с информацией. Узел содержит текст, описывающий определенный раздел на определенном уровне детализации. Раздел этого узла - “Как пользоваться Info”. В строке состояния говорится, что это узел `Help' в файле info.

Верхней строкой узла является его заголовок. В заголовке этого узла (посмотрите на него сейчас) говорится, что узел `Next' после него называется `Справка-P'. Расширенная команда Info позволяет вам перейти к любому узлу, название которого вы знаете. В автономной программе Info в строке заголовка показываются имена этого узла и info-файла. В Emacs строка заголовка продублирована специальной гарнитурой шрифта, а копия все время находится в верхней части окна, даже если вы листаете узел.

Кроме `Next' узел может иметь ссылки `Prev' или `Up', или сразу обе. Как вы видите, этот узел имеет все эти ссылки.

Теперь настало время перейти на узел `Next' с названием `Справка-P'.

>> Введите n, чтобы перейти туда. Введите только один символ,
   не вводите кавычки и не нажимайте <RET> после этого.

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

>> Если вы находитесь в Emacs и у вас есть мышь, и если вы уже
   попрактиковались в набирании n для перехода на следующий
   узел, нажмите сейчас на среднюю кнопку мыши на ссылке
   `Next', чтобы сделать то же самое “мышиным способом”.


Следующая: , Предыдущая: Help, Вверх: Начало работы

1.3 Возврат к предыдущему узлу

Этот узел называется `Справка-P'. Узел `Prev', как вы видите, это `Help', с которого вы только что перешли, используя команду n. Еще одна команда n переместит вас на следующий узел - `Справка-^L'.

>> Но пока что не вводите n. Сначала попробуйте команду p
   или нажмите средней кнопкой мыши на ссылку `Prev'. При
   этом вы перейдете на узел `Next'. Затем используйте
   n, чтобы вернуться сюда.

Если вы читаете это в Emacs, вы увидите пункт `Info' на панели меню ближе к правому краю. При нажатии мышью на пункте панели меню `Info' откроется меню команд, включающее `Next' и `Prev' (а также некоторые другие, которые вы пока еще не изучили).

Все это, возможно, до настоящего момента выглядит до безобразия просто, но пожалуйста, не начинайте читать невнимательно. Эти вещи довольно скоро станут сложными! Также, пожалуйста, не пробуйте новые команды до тех пор, пока вам не будет сказано, что время пробовать настало. Вы могли вынудить Info пропустить предыдущее важное предупреждение, которое уже появлялось.

>> Теперь нажмите n или нажмите средней кнопкой мыши на ссылке
   `Next', чтобы перейти к узлу `Справка-^L'
   и продолжить изучение.


Следующая: , Предыдущая: Справка-P, Вверх: Начало работы

1.4 Команды Space, DEL, B и ^L

В строке состояния этого узла говорится, что вы сейчас находитесь в узле `Справка-^L', а в строке заголовка говорится, что p вернет вас назад в `Справка-P'. Заголовок узла подсвечен, а также может быть подчеркнут; в нем говорится о чем этот узел.

Это большой узел и он не полностью помещается на экране вашего монитора. Более того, вы можете сказать, что он не видим потому, что вы видите строку `--Top----', а не `--All----' в правом нижнем углу экрана.

Команды <SPC>, <BACKSPACE> (или <DEL>) 1 и b существуют для того, чтобы позволить вам “передвигаться” в пределах узла, который не помещается целиком на экране. Команда <SPC> перемещает вас вперед, показывая, что было ниже под экраном. Команда <DEL> или <BACKSPACE> перемещает вас назад, показывая, что было выше над экраном (сверху ничего нет до тех пор, пока вы не нажмете несколько раз на пробел).

>> Теперь попробуйте нажать <SPC> (после этого нажмите
   <BACKSPACE>, чтобы вернуться сюда).

Когда вы нажимаете <SPC>, две строки, которые были внизу экрана, оказываются сверху с последующим текстом. <DEL> или <BACKSPACE> берет две верхние строки и обычно перемещает их вниз, но если над ними был неполный экран с текстом, то команда может вообще не переместить эти строки вниз.

Если вы читаете это в Emacs, заметьте, что строка заголовка всегда видима и никогда не перемещается за пределы экрана. Там вы всегда можете видеть ссылки `Next', `Prev' и `Up', и вы в любое время можете легко перейти по любой из этих ссылок, нажав на нее средней кнопкой мыши.

Команды <SPC> и <DEL> не только перемещают вас вперед и назад по текущему узлу. Они также перемещают вас между узлами. Нажатие <SPC> в конце узла переместит вас на следующий узел; <DEL> (или <BACKSPACE>) в начале узла переместит вас на предыдущий узел. В сущности эти команды выполняют прокрутку через все узлы файла Info как одну логическую последовательность. Вы можете прочитать все руководство сверху вниз, просто нажимая на клавишу <SPC>, и вернуться назад через все руководство снизу вверх, нажимая <DEL> (или <BACKSPACE>).

В этой последовательности подразделы узла следуют за своим родителем. Если в узле есть меню, <SPC> переместит вас один за другим по всем подразделам, перечисленным в этом меню. Как только вы достигнете конца узла, просмотрев все его подразделы, <SPC> переместит вас на следующий узел или на следующий узел родителя.

В настоящее время на многих клавиатурах имеются две клавиши прокрутки - `PageUp' и `PageDown' (или, возможно, `Prior' и `Next'). Если ваша клавиатура оснащена этими клавишами, вы можете использовать их для движения вперед и назад по тексту одного узла, подобно <SPC> и <BACKSPACE> (или <DEL>). Однако, клавиши <PAGEUP> и <PAGEDOWN> при прокрутке никогда не выйдут за пределы начала или конца текущего узла.

Если ваш экран временами засоряется, вы можете заставить Info заново отрисовать его, набрав C-l (Control-L, т.е. удерживая клавишу <CTRL>, нажать L или l).

>> Введите сейчас C-l.

Чтобы перейти назад в начало узла, в котором вы сейчас находитесь, вы можете несколько раз нажать клавишу <BACKSPACE> (или <DEL>). Вы также можете просто один за нажать b. b означает “начало.”

>> Попробуйте это сейчас. (Мы поместили достаточно излишней информации,
   чтобы целиком заполнить экран этой страницы, но в наши дни экраны
   стали такими большими, что, возможно, этого уже будет недостаточно.
   Вам может понадобиться уменьшить окно своего Emacs или Info.)
   Затем вернитесь назад, нажав <SPC> один или несколько раз.

Если ваш экран достаточно высокий, содержимое этого узла может отобразиться полностью. В этом случае b ничего не сделает. Но вы сможете наблюдать эффект действия клавиши b, если будете использовать окно меньшего размера.

Вы только что изучили довольно большое число команд. Если вы хотите воспользоваться одной из них, но плохо ее запомнили, введите ? (в Emacs это запустит команду Info-summary), при этом будет выведен список коротких команд. Когда вы закончите читать список, уберите его, нажав несколько раз <SPC>.

>> Введите сейчас <?>. Нажимайте <SPC>, чтобы увидеть следующие
   один за другим экраны списка, пока они не закончатся. Затем несколько
   раз нажмите <SPC>. Если вы используете Emacs, справка закроется
   автоматически.

(Если вы используете автономную программу Info, введите C-x 0, чтобы вернуться сюда, это означает - нажав и удерживая <CTRL>, ввести x, затем отпустить <CTRL> и x, и ввести <0> - нуль, а не букву “o”.)

C этого момента вы будете сталкиваться с большими узлами без предупреждения, подразумевается, что вы уже знаете как пользоваться <SPC> и <BACKSPACE> для перемещения по узлу. Т.к. не все терминалы имеют одинаковый размер экрана, будет невозможно каждый раз предупреждать вас заранее.

>> Теперь введите n или нажмите средней кнопкой мыши на ссылку
   `Next', чтобы перейти на следующий узел.


Следующая: , Предыдущая: Справка-^L, Вверх: Начало работы

1.5 Невидимый текст в Emacs Info

Перед тем, как обсуждать меню, нам необходимо сделать несколько замечаний, касающихся только пользователей, читающих Info при помощи Emacs. Пользователи автономной версии могут пропустить этот узел, нажав сейчас ].

В Emacs определенный текст, видимый в автономной версии, обычно является скрытым; технически это связано с тем, что он имеет свойство `invisibility'. Невидимый текст на самом деле является частью текста. Он становится видимым (по умолчанию) после убивания и восстановления исходного текста из буфера, он появляется в выводе на печать, он сохранятся в файл как и любой другой текст и т.д. Таким образом, будет полезным разобраться что к чему.

Вы можете сделать невидимый текст видимым при помощи команды M-x visible-mode. Режим видимости - это второстепенный режим, поэтому использование команды во второй раз сделает текст снова невидимым. Наблюдайте эффекты от действия команды на элементе “menu” внизу и верхней строке этого узла

Если вы предпочитаете всегда видеть невидимый текст, вы можете установить значение Info-hide-note-references в nil. Включение постоянного режима видимости не является реальной альтернативой, потому что Emacs Info также использует (хотя и менее широко) другое свойство текста, которое может изменять видимость текста - `display'. Режим видимости эффективен только для свойства invisibility. Когда (в этом учебном пособии) мы ссылаемся на поведение `Emacs', мы подразумеваем поведение Emacs по умолчанию.

Теперь нажмите ], чтобы изучить команды ] и [.


Вверх: Справка-Inv

1.5.1 Команды ] и [

Если вы сейчас нажмете n, вы получите сообщение об ошибке, сообщающее, что у этого узла нет следующего узла. (Точный текст сообщения зависит от используемой вами программы Info.) Это связано с тем, что n и p выполняют переход на следующий и предыдущий узлы на одном и том же уровне. Текущий уровень находится в меню (см. далее) узла, с которого вы пришли, а значит он считается узлом более низкого уровня. Это единственный узел в меню предыдущего узла (даже, если он был перечислен три раза). Отсюда следует, что у него нет следующего и предыдущего узлов, на которые могли бы перейти n или p.

Если вы методично перемещаетесь по руководству, нажимая n, вы рискуете пропустить много узлов. Вы не подвергаетесь этому риску, если последовательно используете <SPC>, потому что, когда вы доходите до нижней части страницы и нажимаете <SPC>, вы переходите на следующую страницу руководства независимо от уровня. Если вы хотите немедленно перейти на этот узел без прокрутки до конца страницы, вы можете ввести ].

Аналогично, <BACKSPACE> переместит вас на предыдущий узел независимо от уровня после того, как вы переместитесь в начало текущего узла. Если вы хотите перейти на предыдущий узел немедленно, вы можете ввести [.

Например, ввод этой последовательности вернет вас назад сюда в три шага: [ n [. Чтобы проделать то же самое в обратном направлении, наберите ] p ].

Теперь нажмите ], чтобы перейти на следующий узел и научиться пользоваться меню.


Следующая: , Предыдущая: Справка-Inv, Вверх: Начало работы

1.6 Меню и команда m

При помощи одних только команд n (следующий), p (предыдущий), <SPC>, <BACKSPACE>, ] и [ для перемещения между узлами, последние ограничены линейной последовательностью. Меню позволяют создавать разветвленную структуру. Меню - это список других узлов, на которые вы можете переходить. На самом деле это просто часть текста узла, отформатированная специальным образом, чтобы Info мог ее интерпретировать. Начало меню всегда идентифицируется по строке, начинающейся с `* Menu:' (к сожалению эта идентификация зашита в Info и заменить ее локализованным `* Меню:' пока не представляется возможным: прим. переводчика). Узел содержит меню тогда, и только тогда, когда в нем есть строка, начинающаяся таким образом. Единственное меню, которое вы можете использовать в любой момент, - это то, что находится в текущем узле. Чтобы использовать меню в любом другом узле, вы должны сначала перейти в этот узел.

После начала меню каждая строка, начинающаяся с `*', идентифицируется как один подраздел. Эта строка обычно содержит короткое название подраздела (после которого следует `:', в Emacs обычно скрыто), название узла, рассказывающее об этом подразделе (опять же, в Emacs обычно скрыто), а затем некоторое необязательное описание подраздела. Строки в меню, не начинающиеся с `*' не имеют особого назначения - они предназначены только для удобства восприятия человеком и не определяют дополнительных подразделов. Вот один из примеров:

     * Фигня:	Узел о ФИГНЕ.      Рассказывает о всякой ФИГНЕ.

Название подраздела - Фигня, а узел, описывающий его - `Узел о ФИГНЕ'. Остаток строки является просто информацией для читателя. [[ Но эта строка не является пунктом настоящего меню просто потому, что выше не существует строки, начинающейся с `* Menu:'. Также в настоящем пункте меню `*' появлялся бы в самом начале строки. Вот почему текст, “обычно скрытый” в Emacs и звучащий как `: Узел о ФИГНЕ.', на самом деле видим в этом примере, даже когда режим видимости выключен.]]

Когда вы используете меню для перехода на другой узел (в некотором отношении, вскоре оно будет описано) то, что вы выбираете, - это название подраздела, первый символ в строке меню. Info использует его для поиска строки меню, извлекает из него имя узла и переходит на этот узел. Причина, по которой существуют и название подраздела, и имя узла, заключается в том, что имя узла должно быть понятным для компьютера, и поэтому может выглядеть некрасиво. Название подраздела может быть выбрано только для того, чтобы быть удобным для выбора пользователем. Часто имя узла бывает удобным для пользователя, поэтому оно и название раздела звучат одинаково. Для этого существует сокращение:

     * Фигня::   Рассказывает о всякой ФИГНЕ.

Это означает, что название подраздела и имя узла совпадают; это `Фигня'. (В Emacs `::' обычно скрыто.)

>> Теперь используйте <SPC>, чтобы найти меню в этом узле, затем
   вернитесь в начало при помощи b и нескольких SPC. Как
   видите, меню на самом деле видно в этом узле. Если вы не можете
   найти меню в узле, просматривая его, значит узел не содержит меню,
   а команда m не доступна.

Если вы продолжите нажимать <SPC>, когда на экране появится меню, он переместит вас на другой узел (первый в меню). Если это произойдет, нажмите <BACKSPACE> для возврата назад.

Команда для перехода на подразделы - m. Она очень отличается от команд, которые вы использовали: эта команда предлагает вам ввести дополнительную информацию.

Командам Info, которые вы знаете, не нужен дополнительный ввод данных; когда вы вводите одну из них, Info немедленно обрабатывает ее и затем уже готов для другой команды. Команда m отличается: ей необходимо знать название подраздела. После того как вы нажали m, Info пытается прочитать название подраздела.

Теперь в нижней части экрана автономного Info найдите строку, содержащую много дефисов (это автономный эквивалент строки статуса в Emacs). Под ней есть еще одна строка, но обычно она пуста (в Emacs это echo-строка). Когда она пуста, значит Info готов к команде, таких как n, b, <SPC> или m. Если в этой строке содержится текст, заканчивающийся двоеточием, это означает, что Info считывает дополнительные входные данные для последней команды. Вы не можете ввести команду Info, потому что Info пытается прочесть входные данные, а не команду. Вы должны либо предоставить эти данные и завершить начатую команду, либо набрать Control-g для отмены команды. Когда вы завершите одну из этих операций, поле ввода снова станет пустым. Затем вы можете снова вводить команды Info.

Команда для перехода в подраздел через меню - m. После нажатия m в строке внизу экрана высветится `Пункт меню: '. Затем вы должны будете ввести название нужного вам подраздела и завершить ввод клавишей <RET>. В Emacs m запускает команду Info-menu.

Вы можете сократить название подраздела. Если сокращение не является уникальным, выбирается первый подходящий подраздел. Некоторые меню содержат наиболее короткие сокращения для каждого названия подраздела заглавными буквами, поэтому вы сможете увидеть, сколько символов вам нужно ввести. Не имеет значения в каком регистре вы будете вводить название подраздела. Вы не должны вводить никаких пробелов в конце или внутри названия пункта за исключением одного пробела, который имеется в пункте меню.

Вы также можете использовать возможность завершения для упрощения ввода названия подраздела. Если вы нажмете клавишу <TAB> после ввода части названия, она дополнит название настолько, насколько Info сможет сделать вывод согласно введенной вами части.

Если вы переместите курсор на строку одного из подраздела меню, тогда вам нет необходимости вводить аргумент: просто нажмите <RET>, и это будет означать подраздел строки, на которой вы стоите. Вы также можете нажать средней кнопкой мыши на непосредственно на строке подраздела для перехода туда.

Здесь представлено меню, чтобы дать вам попрактиковаться. Это меню дает вам три способа для перехода в одно место - Справка-ФИГНЯ:

(Включите режим видимости, если вы используете Emacs.)

>>  Теперь просто введите m и посмотрите, что случится:

Теперь вы “внутри” команды m. Сейчас команды не могут быть использованы; далее вы должны ввести название подраздела.

Вы можете передумать выполнять команду m, нажав Control-g.

>> Попробуйте ее сейчас; обратите внимание на опустевшую строку внизу.
>> Затем еще раз введите m.
>> Теперь введите ЕРУНДА - название пункта. <RET> пока не
   нажимайте.

Пока вы вводите название пункта, вы можете использовать клавишу <DEL> (или <BACKSPACE>) для удаления за раз одного символа, если сделаете ошибку.

>> Нажмите <DEL> для удаления `А'. Вы могли бы ввести еще раз
   `А', чтобы заменить ее. Но в этом нет необходимости, т.к.
   `ЕРУНД' является верным сокращением.
>> Теперь вы готовы продолжать. Нажмите <RET>.

После посещения `Справка-ФИГНЯ', вы должны были вернуться сюда.

Другим способом перемещения на строки подразделов меню и между ними является нажатие <TAB>. Каждый раз, когда вы нажимаете <TAB>, вы перемещаетесь на строку следующего подраздела. Чтобы перейти на строку предыдущего подраздела, введите M-<TAB> - это означает, нажав и удерживая клавишу <META>, нажать затем <TAB> (на некоторых клавиатурах клавиша <META> может быть обозначена как `Alt'.)

После того как вы переместите курсор на строку подраздела, нажмите <RET> для перехода на узел этого подраздела.

Если ваш терминал поддерживает мышь, у вас есть еще один способ перехода в подраздел. Переместите свой указатель мыши на строку подраздела между начальным `*' и двоеточием `:', которое завершает короткое название подраздела. Вы увидите, что название подраздела изменит свой внешний вид (обычно изменяется цвет его фона), и изменится форма указателя мыши, если ваша система поддерживает это. Через некоторое время, если вы оставите мышь на этом месте, всплывет небольшое окно с сообщением “Мышь-2: перейти на этот узел”, или это же сообщение может появиться внизу экрана.

Мышь-2 - это вторая кнопка вашей мыши, если считать слева, или средняя кнопка 3-кнопочной мыши. (На 2-кнопочной мыши вам может понадобится одновременно нажать обе кнопки, чтобы сэмулировать “нажатие средней кнопки”.) В сообщение сказано, что нажатие Мышь-2 в текущем положении указателя (на подразделе в меню) переместит вас в этот подраздел.

Более обобщенно, Мышь-2 находит в буфере Info ближайшую ссылку на другой узел и переходит туда. Например, рядом с перекрестной ссылкой она действует как f, в меню - как m, в строке заголовка узла - как n, p или u и т.д. В конце текста узла Мышь-2 переходит на следующий узел или наверх, если следующего узла нет.

>> Введите n, чтобы увидеть дополнительные команды.


Вверх: Справка-M

1.6.1 Команда u

Поздравляем! Это узел `Справка-ФИГНЯ'. У него есть указатель `Up' на `Справка-M' - узел, с которого вы только что пришли при помощи команды m. Это обычно сокращение - узлы, к которым вы получаете доступ из меню имеют узлы `Up', ведущие назад к меню. Меню перемещают вас вниз по дереву, а `Up' - вверх. С другой стороны, `Prev' обычно используется для того, чтобы “оставаться на том же уровне, но возвращаться назад”

Вы можете вернуться назад на узел `Справка-M', набрав команду u для перехода “Вверх” (команда Emacs, запускаемая u - Info-up). Она переместит вас в начало узла - чтобы вернуться туда, где вы читали, нужно несколько раз нажать <SPC>. (Некоторые программы чтения Info, такие как встроенная в Emacs, перемещают вас в то же место, где вы читали `Справка-M'.)

Другим способом подняться вверх является нажатие Мышь-2 на указатель `Up', находящийся в строке заголовка (предполагается, что у вас есть мышь).

>> Теперь нажмите u, чтобы вернуться назад `Справка-M'.


Следующая: , Предыдущая: Справка-M, Вверх: Начало работы

1.7 Следование по перекрестным ссылкам

В документации Info вы увидите множество перекрестных ссылок. Перекрестные ссылки выглядят так: Смотрите Пересечение. Это настоящий текст, живая перекрестная ссылка с названием `Пересечение', которая указывает на узел с именем `Справка-Пересечение'. (В Emacs имя узла скрыто. Выполните M-x visible-mode, чтобы отобразить или скрыть его.)

Существует два способа следования по ссылкам. Вы можете поместить курсор на нее и нажать <RET>, как в меню. <RET> следует по перекрестной ссылке, находящейся под курсором. Или вы можете нажать f, а затем указать название перекрестной ссылки (в этом случае `Пересечение') в качестве аргумента. В Info Emacs'a f запускает Info-follow-reference.

В команде f вы выбираете перекрестную ссылку по ее названию, поэтому не имеет значения, где находится курсор. Если курсор находится на перекрестной ссылке или рядом с ней, f по умолчанию полагает, что название ссылки в круглых скобках; нажатие на <RET> проследует по этой ссылке. Однако, если вы введете название другой ссылки, f проследует по другой ссылке с этим именем.

>> Введите f с последующим Пересечение, а затем нажмите
   <RET>.

При вводе названия ссылки вы можете использовать клавишу <DEL> (или <BACKSPACE>) для редактирования вводимых данных. Если вы передумаете переходить по ссылке, вы можете использовать Control-g для отмены команды. Для команды f допускается завершение; вы можете выполнять завершение для названий всех перекрестных ссылок в текущем узле, нажимая <TAB>.

Чтобы получить список всех перекрестных ссылок в текущем узе, вы можете ввести ? после f. f продолжает ожидать имя перекрестной ссылки даже после вывода списка, поэтому, если вы на самом деле не хотите переходить по ссылке, вы должны нажать Control-g для отмены f.

>> Введите f? для получения списка перекрестных ссылок в этом
   узле. Затем нажмите Control-g и посмотрите, как отменяется
   действие `f'.

Клавиша <TAB> и M-<TAB>, при помощи которой вы переходите по пунктам меню, также перемещает вас по перекрестным ссылкам за пределами меню.

Иногда перекрестная ссылка (или узел) может ссылаться на другой файл (другими словами на другое “руководство”), или, временами, даже на файл на удаленной машине (несмотря на то, что файлы Info, распространяемые вместе с Emacs или автономным Info, избегают использования ссылок на удаленные ресурсы). Такая перекрестная ссылка выглядит следующим образом: Смотрите Overview of Texinfo. (После перехода по этой ссылке, нажмите l для возврата на этот узел.) Здесь название в скобках `texinfo' (показываемое в автономной версии) ссылается на имя файла. Это имя файла появляется в перекрестных ссылках и именах узлов, если оно отличается от текущего файла. В Emacs имя файла скрыто (вместе с другим текстом). (Используйте M-x visible-mode, чтобы отобразить или скрыть его.)

Остальная часть этого узла относится только к версии Emacs. Если вы используете автономную версию, вы можете прямо сейчас нажать n.

Для некоторых пользователей переключение между руководствами более важно, чем переключение между разделами. Эти пользователи хотят знать, что они будут переключены на другое руководство (и на какое) перед тем, как перейти туда, особенно в том случае, если об этом не будет уведомления, т.к. команды Info типа t (просмотр следующего узла) могут привести к сомнительным результатам.

Если вы поместите свою мышь на перекрестную ссылку, и если она указывает на другое руководство, тогда информация, появившаяся в отдельном окне (всплывающей подсказке) или echo-строке, сообщит о файле (в круглых скобках), на который перекрестная ссылка вас переместит. Это также имеет место и для названий подразделов. Если у вас есть мышь, просто оставьте ее над перекрестной ссылкой `Overview' и посмотрите, что произойдет.

Если вы предпочитаете всегда иметь эту информацию о без необходимости размещения мыши над ссылкой, установите значение переменной Info-hide-note-references в отличное от t (see Info-переменные Emacs). Вы также можете воспользоваться этим, если у вас много ссылок на файлы на удаленных машинах и непостоянный или медленный доступ, т.к. в противном случае вы можете быть не в состоянии отличить локальные ссылки от удаленных.

>> Теперь нажмите n, чтобы изучить дополнительные команды.


Следующая: , Предыдущая: Справка-Xref, Вверх: Начало работы

1.8 Некоторые промежуточные команды Info

Вводный курс почти закончен; пожалуйста, уделите еще немного своего времени для изучения некоторых команд промежуточного уровня.

Большинство файлов Info имеют индекс, который по сути является большим узлом с небольшим, но все же меню. Меню имеет по одному пункту для каждого раздела, перечисленного в индексе. (Как отдельная возможность, меню для индексов могут также включать номера строк в узле с содержимым индекса. Это позволяет программам чтения Info переходить непосредственно на строку пункта, а не просто в начало содержащего его узла.)

Вы можете попасть в индекс из главного меню файла при помощи команды m; затем вы можете снова использовать команду m в узле индекса для перехода на узел с описанием нужного вам раздела.

Также существует команда Info быстрого вызова - i, - которая выполнит все это для вас. Она выполняет поиск указанного раздела (строки) в индексе и переходит на узел, соответствующий этому разделу. Смотрите Смотрите Поиск в Info, для получения полного описания.

Если вы передвигались по различным узлам и хоте ли бы проследить свои шаги, команда l (от слова last) сделает это для вас по одному узлу за раз. По мере перехода с узла на узел Info записывает посещенные узлы в специальный список истории. Команда l посещает узлы из списка истории; каждая последующая команда l перемещает вас назад на один шаг в истории.

В Emacs l запускает команду Info-last.

>> Попробуйте ввести p p n, а затем три раза l,
задерживаясь для того, чтобы посмотреть, что делает l. В
результате вы должны будете снова попасть сюда

Обратите внимание на разницу между l и p: l переходит туда, где вы были в последний раз, в то время как p всегда переходит на узел, в чьем заголовке сказано, что это `Prev' узел (в этом узле ссылка `Prev' указывает на `Справка-Xref').

Команда d (в Emacs - Info-directory) отправляет вас непосредственно в узел Каталог. Этот узел, который вы видели первым при запуске Info, содержит меню со ссылками (прямыми или непрямыми, через другие меню) на все существующие узлы. Узел Каталог перечисляет всех руководства и другие документы Info, которые установлены или могли бы быть установлены в вашей системе.

>> Попробуйте выполнить d, а затем l, чтобы вернуться сюда
   (да, выполнить возврат).

Команда t переходит на узел `Top' руководства. Это полезно, если вы хотите перейти в главное меню руководства или выбрать какой-нибудь отдельный пункт из меню верхнего уровня. Команда Emacs, запускаемая по t - Info-top-node.

Нажатие Мышь-2 на перекрестную ссылку или рядом с ней также выполнит переход по этой ссылке. Вы можете увидеть, что перекрестная ссылка реагирует при перемещении на нее указателя мыши, а также как в ответ на это подчеркивается текст и изменяется указатель мыши.

>> Теперь нажмите n, чтобы увидеть последний узел руководства.

Смотрите Экспертный Info, дополнительные расширенные возможности Info.


Следующая: , Предыдущая: Начало работы, Вверх: Top

2 Info для экспертов

Эта глава описывает различные команды Info для экспертов. (Если вы пользуетесь автономной программой чтения Info, то для нее имеются особые дополнительные команды, описанные а различных разделах GNU Info.)

Эта глава также объясняет, как написать Info в виде выдержки из файла Texinfo. (Однако, в большинстве случаев, лучше написать файл Texinfo, т.к. вы можете использовать его для создания печатного руководства или производства других форматов, таких как HTML и DocBook, а также создания файлов Info.) Смотрите Overview of Texinfo.


Следующая: , Вверх: Экспертный Info

2.1 Расширенные команды Info

Здесь представлены некоторые дополнительные команды Info, которые облегчают навигацию.

g переходит на узел по его имени

Если вы знаете имя узла, вы можете перейти в него, набрав g, имя узла и <RET>. Таким образом, gTop<RET> переместит вас на узел в этом файле с именем `Top'. (Это эквивалент t, см. Справка-Int.) gРасширенный<RET> приведет вас обратно сюда. g в Emacs запускает команду Info-goto-node.

В отличие от m, g не разрешает использовать сокращения. Но она допускает завершение, так вы можете нажать <TAB> для завершения неполного имени узла.

Чтобы перейти на узел в другом файле, вы можете включить имя файла в имя узла, поместив его спереди в круглых скобках. Так g(dir)Top<RET> перейдет в узел Каталог Info, который является узлом `Top' в Info-файле dir. Подобным образом g(emacs)Top<RET> перейдет на верхний узел руководства Emacs.

Имя узла `*' определяет весь файл. Так вы можете просмотреть весь текущий файл, набрав g*<RET>, или любой другой файл при помощи команды g(имя_файла)<RET>.

1 - 9 выбор подраздела меню по его номеру

Если вы экономите каждый набираемый символ, нужный для вашей системы, вам может понравиться использовать команды 1, 2, 3, 4, ..., 9. Это сокращенный вариант команды m, совмещенной с названием подраздела. 1 отвечает за первый пункт меню текущего узла; 1 - второй пункт и т.д. В автономной программе чтения 0 соответствует последнему пункту меню; это для того, чтобы вам не надо было считать общее число пунктов. В Emacs цифровые клавиши запускают команду Info-nth-menu-item.

Если ваш дисплей поддерживает многочисленные шрифты, цвета или подчеркивание, и вы используете режим Info Emacs'а для чтения файлов Info, третий, шестой и девятый пункты меню имеют `*', которые выделяются цветом или каким-нибудь другим атрибутом, таким как подчеркивание; это облегчает быстрое определение номера пункта.

Некоторые терминалы не поддерживают ни многочисленные шрифты, ни цвета, ни подчеркивание. Если вам действительно нужно посчитать количество пунктов, то лучше будет использовать m с указанием названия, или использовать <TAB> для быстрого перемещения по пунктам меню.

e делает документ Info редактируемым

Команда Info e переключает режим Info в обычный режим редактирования Emacs, так вы сможете редактировать текст текущего узла. Введите C-c C-c для переключения обратно в Info. Команда e разрешается только, если значение переменной Info-enable-edit не равно nil.

Команда e работает только в Emacs, где она запускает команду Info-edit. Автономная программа чтения Info не позволят вам редактировать файл Info, поэтому нажатие e переместит вас в конец текущего узла.

M-n создает новый независимый буфер Info в Emacs

Если вы читаете Info в Emacs, вы можете создать новый независимый буфер Info в другом окне, набрав M-n. Новый буфер начнется с точной копии старого, но вы сможете независимо передвигаться между узлами в этих двух буферах. (В режиме Info M-n запускает команду Emacs clone-buffer.)

В Emacs Info вы также можете создавать новые буферы Info, указав числовой аргумент префикса для команд m и g. C-u m и C-u g выполняют переход на новый узел тем же самым способом, что m и g, но они делают это в новом буфере Info, который они открывают в другом окне.


Следующая: , Предыдущая: Расширенный, Вверх: Экспертный Info

2.2 Как выполнять поиск разделов в документах Info.

Команды, которые перемещают вас в пределах узла и между ними, позволяют вам прочесть все руководство или его большие части. Но что, если вам понадобится найти в руководстве некоторую информацию как можно быстрее, а вы не знаете или не помните в каком узле ее искать? Эта необходимость возникает, когда вы используете руководство в качестве справочника, или когда нецелесообразно читать все руководство перед тем, как начать использовать описываемую им программу.

Info имеет мощные средства поиска, позволяющие вам быстро найти информацию. Вы можете выполнять поиск либо в индексах руководства, либо в его тексте.

Т.к. многие разделы, связанные с тем, что описывает руководство, должны быть проиндексированы, вам следует сначала попробовать поиск в индексе. Команда i запрашивает у вас раздел, а затем ищет этот раздел в индексах. Если она найдет статью индекса с введенным вами разделом, она перейдет на узел, на который указывает эта статья индекса. Вы должны будете пролистать этот узел, чтобы увидеть, тот ли это результат, что вы искали. Если это не так, нажмите , один или более раз для перехода по дополнительным статьям индекса, соответствующих вашему разделу.

Команда i находит все статьи индекса, включающие введенную вами строку в качестве подстроки. Для каждого совпадения, Info показывает в echo-строке полную найденную им статью. Часто текст полной статьи индекса уже предоставляет вам достаточно информации для принятия решения, относится ли она к тому, что вы ищете, поэтому мы рекомендуем, чтобы вы читали то, что Emacs показывает в echo-строке, перед прочтением узла, который она показывает.

Т.к. i ищет подстроку, вы можете выполнять поиск разделов даже, если вы не уверены в том, как они звучат в индексе. Например, предположим, что вы хотите найти что-то, то имеет отношение к командам, завершающим частично введенные данные (напр., когда вы нажимаете <TAB>). Если вы хотите захватить статьи индекса, ссылающиеся на “завершить”, “завершение” и “завершающий”, вы можете ввести iзаверш<RET>.

Документы Info, описывающие программы, должны индексировать команды, опции и клавишные последовательности, предоставляемые программой. Если вы ищете описание команды, опцию или клавишу, просто введите их имена, когда i предложит вам ввести раздел. Например, если вы хотите прочитать описание того, что делает клавиша C-f, введите i C - f <RET>. Здесь C-f - это 3 буквенных символа `C', `-' и `f', а не управляющая клавиша “Control-f”, которую вы вводите в Emacs'е для запуска команды, привязанной к C-f.

В Emacs, i запускает команду Info-index.

Если вы не знаете никаких документов руководства, попробуйте команду M-x info-apropos. Она запросит у вас строку, а затем выполнит поиск этой строки во всех индексах всех документов Info, установленных в вашей системе.

Команда s позволят вам выполнять поиск строки по всему файлу. Она переключается на другой узел, если и когда в этом есть необходимость. Вам надо ввести s с последующей строкой для поиска и <RET> в конце. Чтобы искать ту же строку еще раз просто введите s с последующим <RET>. Узлы файла сканируются в том порядке, в котором они находятся в файле, для которого нет необходимости иметь взаимосвязь с порядком, в котором они могут быть в древовидной структуре дерева меню и указателей `следующий'. Но обычно два порядка не слишком отличаются. В любом случае вы всегда можете выполнить b, чтобы узнать, какого узла вы достигли, если заголовок не видим (это может произойти из-за того, что s поместил ваш курсор в месте появления строки, а не в начале узла.).

В Emacs, Meta-s является эквивалентом s. Это нужно для совместимости с другими пакетами GNU, использующими M-s для аналогичной команды поиска. И s, и M-s запускают в Emacs команду Info-search.


Следующая: , Предыдущая: Поиск в Info, Вверх: Экспертный Info

2.3 Добавление нового узла в Info

Чтобы добавить новый раздел в список каталогов Info, вы должны:

  1. Создать какие-либо узлы в каком-нибудь файле для документирования этого раздела.
  2. Поместить этот раздел в меню каталога. Смотрите Меню.

Обычно узлы создаются при помощи Texinfo (see Overview of Texinfo); он обладает преимуществом в том, что вы также можете создать из него печатное руководство или HTML. Вам следовало бы воспользоваться командами `@dircategory' и `@direntry' для помещения руководства в каталог Info. Однако, если вы хотите вручную редактировать файл Info и вручную установить его, это как раз то, что вам нужно.

Новый узел может размещаться в существующем файле документации или в новом файле. Он должен содержать символ `^_' в начале (невидимый для пользователя; в этом узле есть такой символ, но вы не сможете его увидеть), и заканчивается он либо на `^_', `^L' (“перевод страницы”), либо концом файла. 2

После начинающего узел `^_' должна следовать новая строка или `^L' разделитель строк, после которого идет строка заголовка узла. Строка заголовка должна содержать имя узла (по которому Info найдет его) и штатный набор имен узлов `Next', `Prev' и `Up' (если таковые существуют). Как видите, узлом `Up' этого узла является узел `Экспертный Info'. А узел `Next' - `Меню'.

Ключевые слова Node, Next, Prev и Up могут находиться в любом порядке в любом месте строки заголовка, но рекомендуемый порядок представлен в этом предложении. После каждого ключевого слова должно идти двоеточие, пробелы и табуляторы, а затем соответствующее имя. Имя может завершаться табулятором, запятой или разделителем строк. Пробел не завершает имен; они могут содержать пробелы. Регистр букв в именах не имеет значения.

Имя узла имеет две формы. Именем текущего файла является то, что следует после `Node: ' в первой строке этого узла. Например, имя этого узла - `Добавление'. Узел в другом файле носит имя `(имя_файла)узел-в-пределах-файла', как, например, `(info)Добавление' для этого узла. Если имя файла начинается с “./”, тогда он является относительным для текущего каталога; в противном случае, он является относительным для начала стандартного каталога для файлов Info вашего сайта. Имя `(имя_файла)Top' может быть сокращено вплоть до `(имя_файла)'. Согласно принятому соглашению имя `Top' используется для “наивысшего” узла любого отдельного взятого файла - это узел, чей `Up' указывает за пределы файла. Узел `Каталог' - это (dir), он указывает на файл dir, который содержит большое меню с перечнем всех документов Info, установленных на вашем сайте. Узел `Top' файла документа, находящегося в списке `Каталога', должен содержать в себе `Up:(dir)'.

Имя узла * является специальным: оно ссылается на весь файл. Таким образом, g* показывает вам текущий файл целиком. Использование узла * делает возможным создание устаревших неструктурированных файлов в виде узлов дерева.

Имя `Node:', в котором узел излагает свое собственное имя, не должно содержать имя файла, т.к. Info при поиске узла не ожидает, что там может быть имя файла. Имена `Next', `Prev' и `Up' могут содержать его. В этом узле вследствие того, что узел `Up' находится в том же файле, необходимости в его использовании нет.

Заметьте, что узлы в этом файле содержат имена файлов в строке заголовка. Имена файлов игнорируются Info, но они служат комментариями, чтобы помочь пользователю идентифицировать узел.


Следующая: , Предыдущая: Добавление, Вверх: Экспертный Info

2.4 Как создавать меню

Любой узел в иерархии Info может иметь меню - список подразделов. Команда m ищет в меню текущего узла раздел, прочитанный с терминала.

Меню начинается со строки, начинающейся с `* Menu:'. Остальная часть строки является комментарием. После начальной строки каждая строка, начинающаяся с `* ', соответствует одному разделу. Название раздела - то, что пользователь должен ввести в приглашении команды m для выбора этого раздела - идет справа после звездочки и пробела, после него следуют двоеточие, пробелы, табуляторы и название узла, описывающего этот раздел. Название узла, как и имена узлов, следующие после `Next', `Prev' и `Up', могут заканчиваться табулятором, запятой или разделителем строк; оно также может заканчиваться точкой.

Если название узла и название раздела совпадают, тогда вместо того, чтобы указывать название дважды, может быть использовано сокращение `* название::' (и должно быть использовано, когда это возможно, т.к. это уменьшает избыток визуальной информации в меню.)

Выбирайте названия для разделов так, чтобы они отличались друг от друга как можно ближе к началу - это позволяет пользователям вводить короткие сокращения. В длинном меню хороший идеей будет использование прописных букв в начале названий каждого пункта, которые являются для них минимально допустимыми сокращениями (под длинным меню подразумевается меню с 5-ю и более пунктами).

Узлы, перечисленные в меню узла называются его “подузлами”, а он для них - “вышестоящим”. Каждый из них должен иметь указатель `Up:', ссылающийся на вышестоящий узел. Часто бывает полезным выстраивать все или большинство подузлов в последовательность указателей `Next' и `Prev' для того, чтобы любому, кто захочет увидеть их всех, не нужно было повторно заходить в меню.

Каталог Info - это простое меню узла `(dir)Top', т.е. узел `Top' в файле .../info/dir. Вы можете добавлять новые пункты в это меню так же, как и в любые другие меню. Каталог Info - это не то же самое, что и файл каталога, называемый info. Случается, что многие файлы Info живут в этом файле каталога, хотя на самом деле не должны; и файлы в этом каталоге не добавляются автоматически в список узла Каталога Info.

Также, несмотря на то, что схема узла Info должна быть “иерархией”, в действительности она может быть любой направленной схемой. Вполне возможны и могут быть использованы общие структуры и циклы указателей, если они подходят для обозначения того, что должно быть высказано. Нет необходимости формировать связанную структуру для всех узлов файла. Фактически этот файл имеет два связанных компонента. Вы находитесь в одном из них, находящемся под узлом `Top'; другой содержит узел `Help', переход на который выполняет команда h. На самом деле, т.к. здесь нет "сборщика мусора", не произойдет ничего страшного, если подструктура не привязана, но такая подструктура, пожалуй, бесполезна, т.к. никто никогда не сможет узнать, что она существует.


Следующая: , Предыдущая: Меню, Вверх: Экспертный Info

2.5 Создание перекрестных ссылок

Перекрестная ссылка может быть размещена в тексте где угодно в отличие от пункта меню, который должен находиться в начале строки. Перекрестная ссылка выглядит как пункт меню за исключением того, что она содержит `*note' вместо `*'. Она не может заканчиваться `)', потому что `)' часто являются частью имен узлов. Если вы хотите заключить перекрестную ссылку в круглые скобки, сначала завершите ее точкой. Ниже представлены два примера указателей перекрестных ссылок:

     *Note подробнее: команды.  (См. *note 3: Полное руководство)

Это просто примеры. Мест назначения, куда они “указывают” на самом деле не существует!


Вверх: Ссылки

2.5.1 Узел, достигаемый в Info по перекрестной ссылке

Это узел был достигнут по перекрестной ссылке `Пересечение'.

В то время как этот узел был предназначен специально для того, чтобы на него был выполнен переход по перекрестной ссылке, большинство этих ссылок приводят к узлам, которые “принадлежат” какому-либо месту далеко за пределами структуры документа Info. Поэтому вы не в праве ожидать, что этот узел будет иметь ссылки `Next', `Prev' или `Up', указывающие туда, откуда вы пришли. Вообще, команда l (el) является единственным способом для возврата туда.

>> Введите l, чтобы вернуться на узел, на котором была
перекрестная ссылка.


Предыдущая: Справка-Int, Вверх: Начало работы

2.6 Выход из Info

Чтобы выйти из Info и вернуться к тому, чем вы занимались до этого, нажмите q. В Emacs эта команда запустит Info-exit.

Это конец базового курса по использованию Info. Вы изучили, как перемещаться по документу Info и как переходить перекрестным ссылкам и пунктам меню. Это подготовило вас к чтению руководств сверху вниз, как следовало бы поступать новым пользователям при изучении нового пакета.

Другой набор команд Info будет вам полезен, когда необходимо быстро найти что-нибудь в руководстве, т.е. когда вам необходимо использовать руководство в качестве справочника, а не учебного пособия. Мы настоятельно рекомендуем вам изучить эти команды поиска. Если вы хотите сделать это немедленно, следуйте по этой перекрестной ссылке Поиск в Info.

Еще один набор команд предназначен для опытных пользователей; вы можете найти их, просмотрев узел Каталог документации по Info. Их поиск будет хорошим упражнением по использованию Info в обычном режиме.

>> Нажмите d, чтобы перейти в узел каталога Info; затем
   введите mInfo и нажмите Enter для перехода в узел об Info и
   чтения дополнительной справки.


Следующая: , Предыдущая: Ссылки, Вверх: Экспертный Info

2.7 Таблицы тегов для файлов Info

Вы можете ускорить доступ к узлам большого файла Info, добавив в него таблицу тегов. В отличие от таблицы тегов для программ, таблица тегов для файла Info находится внутри самого файла и используется автоматически всякий раз, когда Info читает файл.

Для создания таблицы тегов зайдите на узел в файле, используя в Emacs режим Info, и наберите M-x Info-tagify. Затем вы должны использовать C-x C-s для сохранения файла. Файлы Info, созданные при помощи команды makeinfo, которая является частью пакета Texinfo, всегда начинаются с таблицы тегов.

После того, как файл Info будет содержать таблицу тегов, вы должны будете постоянно его обновлять. Если вы редактируете непосредственно файл Info (подразумевается редактирование его исходного Texinfo), и в результате удаления текста какой-либо узел перемещается в файле назад более, чем на тысячу символов, начиная с положения, записанного в таблице тегов, Info больше не сможет найти этот узел. Для обновления таблицы тегов воспользуйтесь еще раз командой Info-tagify. Таблица тегов файла Info находится в конце файла и выглядит следующим образом:

     ^_^L
     Tag Table:
     File: info, Node: Ссылки^?21419
     File: info,  Node: Теги^?22145
     ^_
     End Tag Table

Заметьте, что он содержит по одной строке на узел, а эта строка содержит начало заголовка узла (заканчивающееся сразу после имени узла), символ `DEL' и его положение в файле относительно начала узла.


Следующая: , Предыдущая: Теги, Вверх: Экспертный Info

2.8 Проверка файла Info

При создании файла Info легко забыть имя узла, когда вы создаете на него указатель из другого узла. Если вы вставите неверное имя узла, это не будет обнаружено до тех пор, пока кто-нибудь не попытается перейти по этому указателю, используя Info. Проверка файла Info является автоматическим процессом, который проверяет все указатели на узлы и сообщает о всех неверных указателях. Проверяется каждый `Next', `Prev' и `Up', также как и каждый пункт меню и перекрестная ссылка. Кроме того, сообщается о любом `Next', не имеющем `Prev' с указателем назад. Проверяются только указатели внутри файла, потому что проверка указателей и в других файлах была бы ужасно медленной. Но таких обычно всего несколько штук.

Для проверки файла Info выполните M-x Info-validate, читая при этом на любой узел файла при помощи Emacs в режиме Info.


Предыдущая: Проверка, Вверх: Экспертный Info

2.9 Переменные Emacs в режиме Info

Следующие переменные могут изменять поведение режима Info в Emacs; вы можете установить одну или несколько этих переменных интерактивно или в своем файле инициализации ~/.emacs. Смотрите Examining and Setting Variables. Автономная программа чтения Info имеет свой собственный набор переменных, описанных в Manipulating Variables.

Info-directory-list
Список каталогов для поиска файлов Info. Каждый элемент представляет собой строку (имя каталога) или nil (пробует каталог по умолчанию). Если он не инициализирован, Info использует переменную окружения INFOPATH для его инициализации или Info-default-directory-list, если переменной INFOPATH нет в окружении.

Если вы хотите переделать список поиска каталога Info и для Emacs, и для автономного Info, лучше всего установите переменную INFOPATH, т.к. она применима для обеих программ.

Info-additional-directory-list
Список дополнительных каталогов для поиска файлов документации Info. В этих каталогах не выполняется поиск объединенного файла dir.
Info-fontify
При установке значения не-nil, включается подсветка файлов Info. Значение по умолчанию - t. Вы можете настроить подсветку, изменив оформление видов info-node, info-xref, info-header-xref, info-header-node, info-menu-5, info-menu-header и info-title-n-face (где n - это уровень раздела, число в диапазоне между 1 и 4). Чтобы настроить оформление, введите M-x customize-face <RET> вид <RET>, где вид - это один из перечисленных здесь видов.
Info-use-header-line
Если не-nil, Emacs помещает в буфер Info строку заголовка, показывающего ссылки `Next', `Prev' и `Up'. Строка заголовка не прокручивается вместе с остальным буфером, оставляя эти ссылки всегда видимыми.
Info-hide-note-references
Как описано ранее в узлах, Emacs-версия Info обычно скрывает некоторый текст в меню и перекрестных ссылках. Вы можете полностью отключить эту возможность, установив этот параметр в nil. Установка его значения ни в nil, ни в t приведет к промежуточному поведению, скрывающему ограниченную часть текста, но показывающему весь текст, который может быть потенциально полезным.
Info-scroll-prefer-subnodes
Если установлено значение не-nil, клавиши <SPC> и <BACKSPACE> (или <DEL>) в меню выполняют переход на подразделы текущего узла, а не его прокрутку в начало или конец соответственно. Например, если на экране появляется меню узла следующее нажатие на <SPC> переходит на подраздел, на который указывает следующий пункт меню. Установка этого параметра в nil приводит к поведению, похожему на автономную программу чтения Info, которая переходит на первый подраздел меню, только когда вы достигаете конца текущего узла. Значение по умолчанию - nil.
Info-enable-active-nodes
Когда установлено значение не-nil, позволяет Info выполнять код Lisp, связанный с узлами. Код Lisp выполняется при выборе узла. Исполняемый код Lisp должен идти после разделителя узла (символ `DEL') и тега `execute: ' в следующем виде:
          ^_execute: (message "Это активный узел!")
     

Info-enable-edit
Установка в nil отключает команду `e' (Info-edit). Значение не-nil включает ее. Смотрите Edit.


Следующая: , Предыдущая: Экспертный Info, Вверх: Top

3 Создание файла Info из файла Texinfo

makeinfo - это утилита, преобразующая файл Texinfo в файл Info; texinfo-format-region и texinfo-format-buffer являются функциями GNU Emacs, выполняющими то же самое.

Смотрите Смотрите Overview of Texinfo, чтобы изучить, как написать файл Texinfo.

Смотрите Смотрите Creating an Info File, чтобы изучить, как создать файл Info из файла Texinfo.

Смотрите Смотрите Installing an Info File, чтобы изучить, как установить файл Info после того, как вы его создали.


Предыдущая: Создание файла Info, Вверх: Top

Индекс

Это алфавитный перечень всех команд, переменных и разделов, рассмотренных в этом документе.


Сноски

[1] Клавиша, которую в этом руководстве мы называем “Backspace или DEL”, на разных клавиатурах обозначена по-разному. Найдите клавишу, которая расположенную недалеко над клавишей <ENTER> или <RET>, и которую вне Emacs вы обычно используете для удаления символа перед курсором, т.е.: символа, который вы ввели последним. Она может быть обозначена как `Backspace' или `<-', или `DEL', или иногда `Delete'.

[2] Если вы поместите `^L' в конец нового узла, убедитесь, что после него есть `^_' для создания нового узла, т.к. `^L' не может начать узел. Также, более предпочтительным способом создания границ узла одновременно с границами страницы будет помещение `^L' сразу после `^_'.