Well, here's a recent example that's near and dear to my heart, I recently discovered that using the widgets as HList items, when one deletes an item using $HList->delete('all'), if the item has any widget entries, they will not be destroyed. Perhaps I am wrong in assuming that this should happen, but there is nothing in the documentation to lead me to believe that behavior should be otherwise. If I destroy a widget, it's children should be destroyed as well. I was under the impression that deleting an item (or an entry) was equivalent to destroying it.

With the Optionmenu widget, if you use an option list like [[label1=>1],[label2=>2]] you cannot simply set the -variable option, if you want the correct value displayed, you must also set the -textvariable option. If you only set the variable, the value in the variable will be overwritten by the first item in the option list.

These may be bugs, or they might be deficiencies in the docs. I don't care, I just don't like having to experiment to discover these behaviors.