Improved util.merge_dict and included few docstrings

Python dictionaries have [`dict.update`](http://docs.python.org/2/library/stdtypes.html#dict.update) method. That would be far more efficient than converting the `dict.items` to list and creating a `dict` at the end.