{"id":24381,"url":"https://patchwork.libcamera.org/api/patches/24381/?format=json","web_url":"https://patchwork.libcamera.org/patch/24381/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/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":"<20250917201742.16406-4-laurent.pinchart@ideasonboard.com>","date":"2025-09-17T20:17:34","name":"[v3,03/10] Documentation: Enable doxygen-awesome-css","commit_ref":null,"pull_url":null,"state":"accepted","archived":false,"hash":"4b9d6c22d06f8a988d1bd94f66939cede8f6ea35","submitter":{"id":2,"url":"https://patchwork.libcamera.org/api/people/2/?format=json","name":"Laurent Pinchart","email":"laurent.pinchart@ideasonboard.com"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/24381/mbox/","series":[{"id":5448,"url":"https://patchwork.libcamera.org/api/series/5448/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=5448","date":"2025-09-17T20:17:31","name":"Documentation theming update","version":3,"mbox":"https://patchwork.libcamera.org/series/5448/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/24381/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/24381/checks/","tags":{},"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 3603EC328C\n\tfor ;\n\tWed, 17 Sep 2025 20:18:24 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id B9F8B6937E;\n\tWed, 17 Sep 2025 22:18:23 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 1EE0F69367\n\tfor ;\n\tWed, 17 Sep 2025 22:18:16 +0200 (CEST)","from pendragon.ideasonboard.com (81-175-209-231.bb.dnainternet.fi\n\t[81.175.209.231])\n\tby perceval.ideasonboard.com (Postfix) with UTF8SMTPSA id 8ACB6E92;\n\tWed, 17 Sep 2025 22:16:57 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"wDc/KYMm\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1758140217;\n\tbh=mKScnHea3GrxukNJbGL0G0ULW8tuIXJRzlsL+XLd8/Q=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=wDc/KYMmkfD12rBggq8IMK3o+7D39IydWIISsdx00fFbv1rEEOTTHTw3A3mXhFvas\n\tcbHuTFJ3czVb0d1ZWkK15kOumKZiKea9QptygfwNC84Vh5pzD9MZn4XKq50aGWF7PE\n\tF+jTw/k6RYLws2AVkpbZmWlKlTdfvQM6DYQox6Q4=","From":"Laurent Pinchart ","To":"libcamera-devel@lists.libcamera.org","Cc":"Stefan Klug ","Subject":"[PATCH v3 03/10] Documentation: Enable doxygen-awesome-css","Date":"Wed, 17 Sep 2025 23:17:34 +0300","Message-ID":"<20250917201742.16406-4-laurent.pinchart@ideasonboard.com>","X-Mailer":"git-send-email 2.49.1","In-Reply-To":"<20250917201742.16406-1-laurent.pinchart@ideasonboard.com>","References":"<20250917201742.16406-1-laurent.pinchart@ideasonboard.com>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","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","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "},"content":"From: Stefan Klug \n\nInclude doxygen-awesome-css in the doxygen config.\n\nThe project's documentation indicated that the HTML_COLORSTYLE option\nneeds to be set to LIGHT starting with Doxygen 1.9.5. The reason isn't\nexplained, and tests have not shown any noticeable difference with\nDoxygen 1.9.5, 1.13.2 and 1.14.0.\n\nUnlike Doxygen itself that generates different CSS files depending on\nthe HTML color style, doxygen-awesome-css use the same CSS that defaults\nto auto-light, and relies on adding \"light-mode\" to the class of the\n element manually to disable dark mode.\n\nAs we don't this, doxygen-awesome-css effectively operates in auto-light\nmode. Given that setting HTML_COLORSTYLE to LIGHT makes no visible\ndifference, leave the option unset to default to auto-light mode that\nmatches the actual behaviour.\n\nSigned-off-by: Stefan Klug \nSigned-off-by: Laurent Pinchart \n---\nChanges since v2:\n\n- Drop HTML_COLORSTYLE\n- Drop GENERATE_TREEVIEW=YES as it is the default\n\nChanges since v1:\n\n- Fix ordering of configuration options\n- Use TOP_SRCDIR instead of CURRENT_SRCDIR to avoid introducing a new\n variable\n---\n Documentation/Doxyfile-common.in | 3 +++\n 1 file changed, 3 insertions(+)","diff":"diff --git a/Documentation/Doxyfile-common.in b/Documentation/Doxyfile-common.in\nindex c9527da03ed5..23a0e3626f9d 100644\n--- a/Documentation/Doxyfile-common.in\n+++ b/Documentation/Doxyfile-common.in\n@@ -54,6 +54,9 @@ EXCLUDE_SYMBOLS = libcamera::BoundMethodArgs \\\n \n IMAGE_PATH = \"@TOP_SRCDIR@/Documentation/images\"\n \n+HTML_EXTRA_STYLESHEET = \"@TOP_SRCDIR@/Documentation/doxygen-awesome-css/doxygen-awesome.css\" \\\n+ \"@TOP_SRCDIR@/Documentation/doxygen-awesome-css/doxygen-awesome-sidebar-only.css\"\n+\n GENERATE_LATEX = NO\n \n MACRO_EXPANSION = YES\n","prefixes":["v3","03/10"]}