Doxygen shouldn't generate proper documentation for this method, since description and declaration are different: "num_bits" and "dim". Also, please check doxygen warnings, there are some of them, that you can fix :)