Info 파일은 보통 `info' 디렉토리에 저장된ㄷ. Info 파일은 독립된 Info 파일이나, Emacs 내에 있는 Info 리더를 써서 읽을 수 있다. (See Info file `info', node `Top', for an introduction to Info.)
Info 가 동작하도록 하려면, `info' 디레고ㅌ리는 전체 Info 시스템의 맨 위 단계로 동작하는 파일이 있어야 한다. 전통적인 이유로, 이 파일은 `dir'라고 불리운다. (이 디렉토리의 위치는 Emacs에서 C-h i를 눌러서 Info로 들어간 다음에 C-x C-f를 타이프하면 `info' 디렉토리의 경로 이름(pathname)을 볼 수 있다.)
`dir' 파일 역시 Info 파일이다. 이 파일은 그 시스템의 모든 Info 파일에 대한 맨 위 단계의 메뉴를 가지고 있다. 그 메뉴는 다음과 같다:
* Menu:
* Info: (info). Documentation browsing system.
* Emacs: (emacs). The extensible, self-documenting
text editor.
* Texinfo: (texinfo). With one source file, make
either a printed manual using
TeX or an Info file.
...
이 메뉴의 각 항목은 괄호 속에 그 파일이름이 있는 Info 파일의 `Top' 노드를 가리킨다. (메뉴 항목은 `Top' 노드라고 지정할 필요가 없다. 왜냐하면 Info에서 노드 이름을 말하지 않으면 자동으로 `Top' 노드로 가기 때문이다. See section Referring to Other Info Files.)
즉, `Info' 하옥은 `info' 파일의 `Top' 노드를 가리키고, `Emacs' 항목은 `emacs' 파일의 `Top' 노드를 가리킨다.
각 Info 파일에서, `Up' 포인터와 `Top' 노드는 dir 파일을 거꾸로
가리키고 잇다. 예를 들어, Emacs 매뉴얼의 `Top' 노드는 Info에서 다음과
같이 보인다:
File: emacs Node: Top, Up: (DIR), Next: Distrib
(이 경우에, `dir' 파일은 대문자로 쓰여 있다---이것은 대문자로 쓰이나 소문자로 쓰이나 상관없다. Info는 쓰여진 파일을 찾지 못하면 파일 이름을 자동으로 소문자로 바꾸는 기능이 있다.)
새로운 Info 파일을 시스템에 추가하려면, `info' 디렉토리에 있는 `dir' 파일에 메뉴 항목을 하나 추가해야 한다. 예를 들어, GDB 문서를 추가하려면, 다음과 같은 항목을 쓸 것이다:
* GDB: (gdb). The source-level C debugger.
이 메뉴 항목의 첫번째 부분은 메뉴 항목의 이르이고, 그 다음에 콜론(colon)이 온다. 두번째 부분은 Info 파일의 이름으로, 괄호 안에 있고 마침표으로 끝난다. 세번째 부분은 설명이다.
Info 파일의 이름은 대부분 `.info' 확장자가 있다. 즉, GDB의 Info 파일은 `gdb' 혹은 `gdb.info'가 될 수도 있다. Info 리더(reader) 프로그램은 자동으로 `.info'가 있는 이름과 없는 이름의 두가지 이름을 시도한다; 혼란을 피하기 위해, `.info'를 직접 메뉴 항목에 넣지 않는 것이 더 좋다. 예를 들어, GDB 메뉴 항목은 파일 이름으로 `gdb.info'가 아닌 그냥 `gdb'를 사용해야 한다.
Info 파일이 `info' 디렉토리에 없으면, 이 위치를 지정하는 방법이 세가지 있다;
Info-directory-list 변수에
추가한다.
이렇게 하면 Emacs가 `dir' 파일들이 어디에 있는지 알 수 있다.
Emacs는 여기에 열거된 각 디렉토리에서 `dir'라는 이름의 파일들을
합친다. (Emacs 버전 18에서는, Info-directory 변수를 한개의
디렉토리로만 지정할 수 있다.)
INFOPATH 환경변수에서 지정한다. (환경변수를 지정하는
사람만이 이런 식으로 위치가 지정된 Info 파일을 찾을 수 있을 것이다.)
예를 들어, `/home/bob/manuals' 디렉토리에 있는 테스트 파일을 접근하려면, `dir' 파일의 메뉴에 다음과 같은 항목을 추가한다:
* Test: (/home/bob/manuals/info-test). Bob's own test file.
이 경우에 메뉴 항목의 두번째 부분으로 `info-test' 파일의 절대 파일이름(absolute file name)을 써야 한다.
이 대신에, 다음을 `.emacs' 파일에 쓸 수 있다:
(setq Info-directory-list
'("/home/bob/manuals"
"/usr/local/info"))
이렇게 하면, Emacs가 `/home/bob/manuals' 디렉토리의 `dir' 파일과 `/usr/local/info' 디렉토리의 `dir' 파일을 합친다. Info는 `/home/bob/manuals/info-test' 파일을 `/home/bob/manuals/dir' 파일 내의 메뉴 항목을 통해서 열거할 것이다.
마지막 방법으로, INFOPATH 환경 변수를 `.cshrc'나
`.profile' 파일에서 지정해서 Info가 어디를 찾을지 알려준다.
sh이나 bash같은 Bourne 셸 호환을 셸 명령어 해석기(shell
command interpreter)로 쓴다면, INFOPATH 호나경 변술ㅡㄹ
`.profile' 초기화 파일에서 지정한다; 하지만, csh나
tcsh을 쓴다면, `.cshrc' 초기화 파일에서 변수를 지정해야
한다. 이 두가지 타입의 셸은 다른 문법을 쓴다.
INFOPATH 변수는 다음과 같이 지정한다:
setenv INFOPATH .:~/manuals:/usr/local/emacs/info
INFOPATH=.:$HOME/manuals:/usr/local/emacs/info export INFOPATH
`.'는 현대 디렉토리를 뜻한다. Emacs는 Emacs 자신의
Info-directory-list 변수를 초기화할 때 INFOPATH 환경변수를
사용한다.
하지만, INFOPATH를 사용할 때, 마지막 문자가 콜론(colon)이면, 이
콜론(colon)은 기본 (컴파일되어 있는) 경로(path)로 바뀐다. 이런 기능은
모든 위치를 열거할 필요 없이 기본 디렉토리에 새로운 디렉토리를 늘릴 수
있도록 해 준다. 예를 들어 (sh 문법 사용):
INFOPATH=/local/info: export INFOPATH
는 `/local/info'를 첫번째로 찾고, 그 다음에 기본 디렉토리를 찾는다. 앞에 콜론이 오거나, 두개의 콜론이 오는 것은 특별히 해석되지 않는다.
Info 파일을 시스템에 설치할 때, install-info 프로그램을 써서
`dir' Info 디렉토리 파일을 변경할 수 있다. 보통 그 패키지의
makefile에서 Info 파일을 적절한 위치에 복사하고 나서
install-info를 실행한다.
Info 파일이 install-info와 동작하게 하려면,
@dircategory와 @direntry를 Texinfo 소스 파일에 써야
한다. @direntry는 Info 디렉토리 파일에 추가할 메뉴 항목을
지정하고, @dircategory는 Info 디렉토리의 어느 부분에 집어 넣을
것인지를 지정한다. 다음은 이 매뉴얼에서 사용되는 명령이다.
@dircategory Texinfo documentation system @direntry * Texinfo: (texinfo). The GNU documentation format. * install-info: (texinfo)Invoking install-info. ... ... @end direntry
이렇게 하면 Info 파일에서 다음을 만든다:
INFO-DIR-SECTION Texinfo documentation system START-INFO-DIR-ENTRY * Texinfo: (texinfo). The GNU documentation format. * install-info: (texinfo)Invoking install-info. ... ... END-INFO-DIR-ENTRY
install-info 프로그램은 Info 파일에서 이 줄을 본다. 이렇게
install-info가 무엇을 해야 할지 알 수 있다.
@direntry와 dircategory 명령은 Texinfo 입력이 시작할 때,
첫번째 @node 명령 앞에 쓴다. 만약 그 뒤에 쓴다면,
install-info는 알지 못한다.
Texinfo 소스 파일에서 @dircategory를 두번 이상 쓰면, 각각은
한개씩의 category를 지정한다; 새로운 메뉴 항목은 지정하는 각 하ㅇ목에
모두 차가된다. @direntry를 두번 이상 쓰면, 각각은 한개씩의 메뉴
항목이다; 각 메뉴 항목들은 지정된 각 category에 추가된다.
install-info는 Info 파일에서 메뉴 항목을 뽑아내 Info 시스템의
제일 상위 레벨인 `dir' 파일에 넣는다 (어떻게 `dir' 파일이
동작하는 지에 대한 설명은 앞의 절을 보라). 이것은 소프트웨어를 설치할
때나, 시스템의 메뉴얼들에서 dir 파일을 만들어 낼 때 주로 쓰인다.
사용법은:
install-info [option]... [info-file [dir-file]]
inffo-file이나 dir-file이 지정되지 않으면, 이 파일들을
지정하는 여러가지 옵션(아래에 설명됨)들이 있어야 한다. 컴파일시에
포함된 기본값은 없고, 표준 입력(standard input)은 절대 사용되지 않는다.
install-info는 오직 한개의 Info 파일을 읽을 수 있고, 한번 실행할
때 오직 한개의 dir 파일만 쓴다.
만약 dir-file이 없으면 (지정되긴 했지만), install-info는
(항목이 하나도 없는) dir-file을 만든다.
옵션:
--delete
--dir-file=name
--entry=text
--help
--info-file=file
--info-dir=dir
--item=text
--quiet
--remove
--section=sec
--version
Go to the first, previous, next, last section, table of contents.