Record the reason for the restrictions in hash-table/modify!
authorAlexey Radul <axch@mit.edu>
Sun, 29 May 2011 22:06:42 +0000 (23:06 +0100)
committerTaylor R Campbell <campbell@mumble.net>
Tue, 9 Apr 2013 02:39:46 +0000 (02:39 +0000)
commitaa1581f35306bdb502dac2ed3f70244d3043cdd2
tree28714c84a3bbd0f05d28d7652b20629086d626da
parent7d53ce9b07bff6fa94d5d2357baf4c2c2eff921b
Record the reason for the restrictions in hash-table/modify!

I found this non-obvious when I was writing the documentation, so it
seems appropriate to record it somewhere.  On the other hand, it does
not seem appropriate to burden the user with having to read it ---
just obey the restriction and you'll be fine.  Will anyone ever read
comments in the source of the manual?  Is there a better place to
record this knowledge?
doc/ref-manual/associations.texi