Project: datamanagement
Issue DM-4639: modernize afw code and reduce doxygen errors
I would like to make some simple modernizations afw code and reduce doxygen warnings as much as practical. The modernizations I had in mind were: - Move doc strings from .cc files to .h files and standardize their format - Use {{namespace lsst { namespace afw { ...}} in .cc files to make the code easier to read - Eliminate all {{::Ptr}} and {{::ConstPtr}} typedefs (replacing with {{PTR()}} and {{CONST_PTR()}}). - Make sure .py files import the appropriate packages from future and (where practical) pass the flake8 linter Regarding doxygen warnings: I think moving the documentation to .h files will help in many cases. Some warnings may be impractical to fix, such as complaining about not documenting "cls" for python class methods.
Story points: 6