improved doc format for misc.rst