product.el (Re: DEL and SPC in RMAIL-summary buffer)

[Shuhei KOBAYASHI]

>>>>> In <htxr92ugkpb.fsf_-_ ＠ urania.kanji.zinbun.kyoto-u.ac.jp>,
>>>>> tomo ＠ kanji.zinbun.kyoto-u.ac.jp (守岡 知彦 / MORIOKA Tomohiko) wrote:
> これに対し、半田さんは、product.el の中の関数は全部 doc-string がつい
> ているので、どれが API でどれが internal-use only なのか区別が付かない、
> という指摘をされています。

docstring の有無で internal-use かどうかを区別するというのはいつの時代の
感覚ですか?

Elisp Manual の Tips for Documentation Strings より:
==============================

   * An internal variable or subroutine of a Lisp program might as well
     have a documentation string.  In earlier Emacs versions, you could
     save space by using a comment instead of a documentation string,
     but that is no longer the case--documentation strings now take up
     very little space in a running Emacs.

この変更(dynamic-docstrings)が入ったのは Emacs 19.29 からです.

というわけで, internal な関数の docstring をわざわざ comment にすること
はないというのに 1 票.

もちろん,

> (b) API となる関数の明確化

は行なう必要があると思います.

-- 
Shuhei KOBAYASHI