src/framework/*: improve the doxygen documentation (work in progress). This also...