[PHP-dev 1325] Re: [PHP-doc 649] mbstring の新関数のマニュアルについて

[TAKAGI Masahiro]

高木です。

確かに、mbstring の開発に関する情報があまり php-dev ＠ php.gr.jp に流れて
こないっていうのもちょっと残念な話なんですよね……。
# そういえば、マニュアル翻訳の更新状況も php-doc ＠ php.gr.jp に報告でき
# ていない……。今後はできるだけ ML のほうにも更新状況を流すようにしま
# す。

At Sun, 17 Sep 2006 22:52:27 +0900,
Tadashi Jokagi wrote:
> 
>       まず
> 
> TAKAGI Masahiroさんの<m3venmzoe3.wl%matakagi ＠ osk2.3web.ne.jp>から
> >■ 新しく追加した関数
> > mb_list_encodings_alias_names()
> > mb_list_mime_names()
> 
>     辺りの実装が「本当に使いやすいのか?」を考えていただきたいです．つ
>     まり，「マニュアルもうちょっと待って」です．マニュアルとしてでてく
>     ると変更が効かなくなるので．
> 
> #というか 5.2.0 でたら効かなくなるとも言えるのですが
> 
>       まずこの辺りを参照で．
> 
> http://blog.poyo.jp/archives/id-1149470397
> http://blog.poyo.jp/archives/id-1150686182
> 
>     大まかに言って mbstring の実態とエイリアスを関数の結果として出す必
>     要があるのでしょうか? ということです．これがあるため，すべてのサポー
>     トされるエンコーディングを取得するには
> 
>     mb_list_encodings()
>     mb_list_encodings_alias_names()
> 
>     を使わなければなりません．マニュアルで「実態」と「エイリアス」が
>     ありますが，その説明もありませんし，うまく理解できるように説明を
>     することも難しいのではないでしょうか?
> 
> #mb_list_mime_names() は MIME は技術的に PHP に限らない一般的な話なの
>  でいいと思いますが
> 
>     むしろ 5.2.0 では mb_list_encodings_alias_names() は一旦無効にして
>     欲しいのですが(仕様変更が仮にあると，function_exists() だけで分別
>     できなくなるので)
> 

廣川さんのご指摘にもあるように、今の時期に 5.2 系の仕様変更を行うこと
は事実上不可能だと思います。ただ、特に mb_list_* 系の関数の仕様につい
てはまだ議論の余地がありそうですので、これらの関数についてのマニュアル
の更新は、しばらく保留することにしましょうか。

-- 
高木 正弘 mailto:matakagi ＠ osk2.3web.ne.jp