AW: hashtable documentation

[Hoehle, Joerg-C. <Joe...@t-...>]

Bruno wrote:
>>  - :value-type and:key-type are not documented
>:value and :key are documented in impext.xml.
I had seen that.

> We have split the description
>of MAKE-HASH-TABLE into a more general part in impbody.xml and a
>weak hash table description in impext.xml.

Yes, yet :value-type :key-type are still not documented.

And I found documentation very misleading that start like
"the options are :this, :that"
and several paragraphs later
"allowed options are also :foo and :bar".
I expect a complete summary at the start, or none at all (or some =
verbiage to tell that this is part of the picture).

I've submited bugreports for mnpages written that way (e.g. dpkg on =
Debian), make-hash-table is described similarly in impnotes and I =
forgot another similar description I encountered.

Regards,
	J=C3=B6rg H=C3=B6hle.