[utils/macros] document
[gtk, utils] clean up