ローカルにダウンロード済みのphpのマニュアルをemacsから参照する方法

emacsphp-mode を使います.

phpのマニュアルを簡単かつ素早く参照できるようになります.

マニュアルのダウンロード

マニュアルを保存するディレクトリを作成します

$ mkdir -p ~/doc/php-manual

https://www.php.net/download-docs.php から"Many HTML files"形式のマニュアルをダウンロードします

$ cd ~/doc/php-manual
$ wget https://www.php.net/distributions/manual/php_manual_en.tar.gz

展開します

$ tar xfz php_manual_en.tar.gz

~/doc/php-manual/php-chunked-xhtml というサブディレクトリができ,HTML形式のマニュアルが解答されます

emacs の設定

php-modeの設定に以下の2行を加えます

  (setq php-manual-path (expand-file-name "~/tmp/php-manual/php-chunked-xhtml/"))
  (setq php-search-documentation-function #'php-local-manual-search)

使い方

php-mode でソースコードを開いて,C-c C-f を押すと,ブラウザが起動してカーソル下のシンボル名のマニュアルを開きます

動作原理

php-local-manual-searchのソースコードを読むと,php-manual-path のディレクトリ以下にあるファイルから,シンボル名を含むファイルを探して,規定のブラウザで開いてるだけでした.simple is the best ですね