Arrgghh. The wording in  http://yaml.org/type/merge.html  is correct. The  http://code.google.com/p/snakeyaml/issues/detail?id=139 issue isn't really with the merge behavior; the problem is that someone assumed there can be more than one instance of the key to merge. I'm posting a reply on that thread.

Oren.