有unix/linux开发或者管理经验的程序员或者系统管理员都知道man是超级好用的一个命令。例如man malloc就可以看到malloc函数的用法,而man ssh则可以看到ssh客户端的各个参数的详细说明。
因为觉得man非常好用,所以我很早之前就想写一个php man,但是一直都没去做。07还是08年我写过一个php的ctags,通过解析php的html文档来生成tags文件,使得可以在vim方便地查看php函数定义。不过后来硬盘坏掉,导致部分代码丢失,之前的tags数据也丢失,就没再用过。
终于在昨天,PHP官方发布了一个消息,提到了pman这个东西。我不知道pman是第一次发布还是早就存在,总之我是第一次看到这个东西。
安装:
sudo pear channel-update doc.php.net
sudo pear install doc.php.net/pman
如果安装失败可以尝试先sudo pear upgrade pear
使用:
pman pack
此外,在这次发布的消息里,还提到了一个在线的PHP文档编辑器:https://edit.php.net/。UI似乎是用ExtJS。我分别尝试了一下用我的pear和pecl帐户登录,没有成功,也没任何提示,不知道是密码错误,抑或是根本不支持用pear和pecl帐户登录。不过我本身对这个兴趣并不是很大,但是相信应该能让php中文文档翻译更活跃起来。