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