[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Info 파일은 보통 `info' 디렉토리에 저장된ㄷ. Info 파일은 독립된 Info 파일이나, Emacs 내에 있는 Info 리더를 써서 읽을 수 있다. (See info: (info)Top, for an introduction to Info.)
• Directory file | The top level menu for all Info files. | |
21.1 Listing a New Info File | Listing a new info file. | |
21.2 Info Files in Other Directories | How to specify Info files that are located in other directories. | |
21.3 Installing Info Directory Files | How to specify what menu entry to add to the Info directory. | |
21.4 Invoking install-info | install-info options.
|
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 Nodes in 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는 쓰여진 파일을 찾지 못하면 파일 이름을 자동으로 소문자로 바꾸는 기능이 있다.)
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
새로운 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'를 사용해야 한다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
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'를 첫번째로 찾고, 그 다음에 기본 디렉토리를 찾는다. 앞에 콜론이 오거나, 두개의 콜론이 오는 것은 특별히 해석되지 않는다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
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에 추가된다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
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
info-file의 항목들을 dir-file에서 제거한다. dir-file 내의 항목에서 파일의 이름은 반드시 info-file이어야 한다 (`.info'가 뒤에 붙은 경우를 제외하고). 이 옵션을 쓰면 어떤 새로운 항목도 추가하지 않는다.
--dir-file=name
Info 디렉토리 파일의 이름을 지정한다. 이것은 dir-file 인자를 쓴 것과 동일하다.
--entry=text
text를 Info 디렉토리 항목으로 넣는다; text는 Info 메뉴 항목의 형태이고, 그 뒤에 공백으로 시작하는 줄들이 더 올 수 있다. 한개 이상의 항목을 지정할 경우, 전부 추가된다. 어떤 항목도 지정하지 않는다면, Info 파일 자체의 정보에 의해 결정된다.
--help
기본적인 사용법과 가능한 옵션에 대한 사용법 메세지를 표시하고, 성공적으로 종료한다.
--info-file=file
설치할 Info 파일의 이름을 지정한다. 이것은 info-file 인자를 사용한 것과 같다.
--info-dir=dir
`--dir-file=dir/dir'와 같다.
--item=text
`--entry=text'와 같다. Info 디렉토리 항목은 사실 메뉴 항목이다.
--quiet
경고를 내지 않는다.
--remove
`--delete'와 같다.
--section=sec
이 파일의 항목을 sec section에 넣는다. 한개 이상의 section을 지정하면, 모든 항목들이 각각의 section에 추가된다. section을 지정하지 않는다면 Info 파일 자체내의 정보에 의해 결정된다.
--version
버전 정보를 출력하고, 성공적으로 종료한다.
[ << ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This document was generated by Autobuild on March, 29 2007 using texi2html 1.76.