{"id":10100,"url":"https://patchwork.libcamera.org/api/1.1/covers/10100/?format=json","web_url":"https://patchwork.libcamera.org/cover/10100/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/1.1/projects/1/?format=json","name":"libcamera","link_name":"libcamera","list_id":"libcamera_core","list_email":"libcamera-devel@lists.libcamera.org","web_url":"","scm_url":"","webscm_url":""},"msgid":"<20201020000310.3008-1-laurent.pinchart@ideasonboard.com>","date":"2020-10-20T00:03:05","name":"[libcamera-devel,0/5] libcamera: Miscellaneous documentation fixes","submitter":{"id":2,"url":"https://patchwork.libcamera.org/api/1.1/people/2/?format=json","name":"Laurent Pinchart","email":"laurent.pinchart@ideasonboard.com"},"mbox":"https://patchwork.libcamera.org/cover/10100/mbox/","series":[{"id":1385,"url":"https://patchwork.libcamera.org/api/1.1/series/1385/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=1385","date":"2020-10-20T00:03:05","name":"libcamera: Miscellaneous documentation fixes","version":1,"mbox":"https://patchwork.libcamera.org/series/1385/mbox/"}],"comments":"https://patchwork.libcamera.org/api/covers/10100/comments/","headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 801EBBDB1F\n\tfor ;\n\tTue, 20 Oct 2020 00:04:07 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 5E9BE613BD;\n\tTue, 20 Oct 2020 02:04:06 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 687AA6052F\n\tfor ;\n\tTue, 20 Oct 2020 02:04:05 +0200 (CEST)","from pendragon.lan (62-78-145-57.bb.dnainternet.fi [62.78.145.57])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id DA7E352\n\tfor ;\n\tTue, 20 Oct 2020 02:04:04 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"v07i16xo\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1603152245;\n\tbh=8Ok8W1BF9o3jrNLEZoEUJk9VPzkGiOJfiDOzOsBHtKk=;\n\th=From:To:Subject:Date:From;\n\tb=v07i16xoKVWx/8N+MAA0GTkoqxk+KRWgM49bOvyHx52r6467Pl7wpwmNkKLPzPr1L\n\tZ4m644hQMQobHyRXSRRec0P0xrvFeePNxdraLLujavBPKQx0/Ij8ibxLjnh7byI1+h\n\ttyy96dTzIs/SX1CbG8b/nwjj0FZLpzRNDpz7M7Do=","From":"Laurent Pinchart ","To":"libcamera-devel@lists.libcamera.org","Date":"Tue, 20 Oct 2020 03:03:05 +0300","Message-Id":"<20201020000310.3008-1-laurent.pinchart@ideasonboard.com>","X-Mailer":"git-send-email 2.27.0","MIME-Version":"1.0","Subject":"[libcamera-devel] [PATCH 0/5] libcamera: Miscellaneous\n\tdocumentation fixes","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Content-Type":"text/plain; charset=\"us-ascii\"","Content-Transfer-Encoding":"7bit","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "},"content":"Hello,\n\nThis small patch series fixes miscellaneous issues with doxygen. It\nstems from the need to document the libcamera namespace with the latest\ndoxygen version (current master branch), which is done in patch 5/5.\nPatches 1/5 to 4/5 fixes small issues uncovered by the libcamera\nnamespace being documented.\n\nThe only patch that I think may be need discussion is 2/5. Adding\n#ifndef __DOXYGEN__ to all pipeline-specific IPA headers isn't very\nnice, but there's no easy way to get doxygen to skip them. Listing the\nfiles to be skipped explicitly to Doxyfile.in isn't great. Another\noption would be to move those files to a separate directory, for\ninstance include/ipa/pipeline/, which can then be listed in Doxyfile.in.\nPlease let me know of your preference.\n\nLaurent Pinchart (5):\n ipa: Rename ipa_vimc.h to vimc.h\n ipa: Skip doxygen parsing for pipeline-specific IPA headers\n libcamera: Place doxygen \\file block above namespace\n libcamera: Drop semicolon after LOG_{DECLARE,DEFINE}_CATEGORY\n libcamera: Document the libcamera namespace\n\n include/libcamera/ipa/raspberrypi.h | 4 ++++\n include/libcamera/ipa/rkisp1.h | 4 ++++\n include/libcamera/ipa/{ipa_vimc.h => vimc.h} | 6 +++++-\n src/ipa/vimc/vimc.cpp | 2 +-\n src/libcamera/byte_stream_buffer.cpp | 8 ++++----\n src/libcamera/camera_manager.cpp | 3 +++\n src/libcamera/camera_sensor.cpp | 2 +-\n src/libcamera/file.cpp | 2 +-\n src/libcamera/pipeline/raspberrypi/staggered_ctrl.cpp | 2 +-\n src/libcamera/pipeline/simple/converter.cpp | 2 +-\n src/libcamera/sysfs.cpp | 2 +-\n src/libcamera/v4l2_pixelformat.cpp | 1 +\n src/libcamera/v4l2_videodevice.cpp | 1 +\n test/ipa/ipa_interface_test.cpp | 2 +-\n 14 files changed, 29 insertions(+), 12 deletions(-)\n rename include/libcamera/ipa/{ipa_vimc.h => vimc.h} (80%)"}