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

emacs の php-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 ですね