[libcamera-devel] [PATCH 0/2] Documentation: Quieten Doxygen

Kieran Bingham kieran.bingham at ideasonboard.com
Tue Jan 8 14:21:04 CET 2019


Presently Doxygen produces a lot of verbose output for all the files it
processes. This means that any warnings and errors are quite obfuscated
against the noise.

Set the Doxygen option QUIET to 'yes' which removes all output except
for warnings and errors.

I don't think we are yet keen on making Doxygen warnings build failure
errors though ?


The second patch is optional and certainly deserves some discussion.
Enabling parameter documentation warnings brings in a few extra across
pipeline/vimc.cpp, camera_manager.h, device_enumerator.h, log.h,
media_object.h, and pipeline_handler.h.

Should we enable this option and fixup these extra warning levels?


Kieran Bingham (2):
  Documentation: Suppress normal doxygen output
  [RFC] Documentation: Enable parameter documentation warnings

 Documentation/Doxyfile.in | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

-- 
2.17.1



More information about the libcamera-devel mailing list