aka:GNU Info

Infoファイルの置き場所について
- Infoコンパイル時に指定する`infodir'は単一であり、デフォルトは`/usr/local/share/info'であり、configureのオプションで変更可能。
- ここ以外にも、ファイルシステム上で自由に配置可能である。
- ただしそれぞれのディレクトリ毎に、`dir'というメニューファイルを配置する必要がある。

Infoのメニューの構成
- infoコマンドを実行したときに表示されるメニューは次のように構成される。
  - 環境変数INFOPATHが設定されていないときは、コンパイル時に指定したディレクトリの`dir'ファイルを表示する。
  - 環境変数INFOPATHが指定されているときは（`:'区切りで複数指定可能）、それらを調べて見つかった`dir'ファイルを、その順に単一メニューに連結して表示。ただし、どこにも`dir'ファイルが無いときは、前項のものを表示。
- EmacsのInfoモードを実行したときに表示されるメニューは次のように構成される。
  - 基本的な考え方はinfoコマンドと同じである。
  - ただし、環境変数`INFOPATH'そのままではなく、Emacs内の変数`Info-directory-list'を構成した上で、そのリストに含まれる順にディレクトリを処理していく。その構成の手順が多少複雑。手順は次のとおり。
    - 環境変数`INFOPATH'が存在しない場合は、`paths.el'にて定義されている`Info-default-directory-list'を`Info-directory-list'にコピーする。
    - 環境変数`INFOPATH'が存在して、その値が`:'で終わるときには、`INFOPATH'のディレクトリを`Info-default-directory-list'にappendする形で`Info-directory-list'を構成する。
    - ただし、emacsコマンドをソースツリーの中の`src'ディレクトリで実行し、かつ、環境変数INFOPATHが設定されていない場合は、ソースツリーの中のinfoディレクトリが`Info-directory-list'に設定される。
  - 加えて、`Info-additional-directory-list'に設定したディレクトリ達は、`Info-directory-list'の処理が終わった後に、追加的に処理される。

Multiple dir-files setting for Emacs
- How to investigate the current situation in your emacs
```
;; Evaluate these in the scratch.
(getenv "INFOPATH")
Info-additional-directory-list
Info-directory-list
Info-default-directory-list
```
- Most simple way to set up info-path for emacs is to redefine it with hook like this.
```
(add-hook 'Info-mode-hook
          (lambda ()
            (setq Info-directory-list '("/Applications/Emacs-23.2/Emacs.app/Contents/Resources/info/"
                                        "~/Dropbox/emacs/.emacs.23.2.d/info/"))))
```
  And each dir files must be a 'full-fledged' dir-file, e.g. if you have BBDB info file somewhere outside the original info directory, the dir file there must be like this.
```
^_
File: dir,      Node: Top

* Menu:
* BBDB: (bbdb). The Insidious Big Brother Database.
```
  Note that '^_' is a control character, so you have to put it by C-q C-_.
- If you want to synchronize info menu between emacs and standalone info, you ought to take care of INFOPATH environment variable.
Misc
- Texinfo
  - Texinfo 4.13 contains makeinfo 4.8. Makeinfo 4.8 seems not to support UTF-8.
  - So to generate info files from texi files with UTF-8, we have to use texi2info command on Emacs. numero rio

Last modified : 2012/01/23 15:43:08 UTC