From patchwork Wed Sep 17 20:17:34 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 24381 Return-Path: X-Original-To: parsemail@patchwork.libcamera.org Delivered-To: parsemail@patchwork.libcamera.org Received: from lancelot.ideasonboard.com (lancelot.ideasonboard.com [92.243.16.209]) by patchwork.libcamera.org (Postfix) with ESMTPS id 3603EC328C for ; Wed, 17 Sep 2025 20:18:24 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id B9F8B6937E; Wed, 17 Sep 2025 22:18:23 +0200 (CEST) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="wDc/KYMm"; dkim-atps=neutral Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 1EE0F69367 for ; Wed, 17 Sep 2025 22:18:16 +0200 (CEST) Received: from pendragon.ideasonboard.com (81-175-209-231.bb.dnainternet.fi [81.175.209.231]) by perceval.ideasonboard.com (Postfix) with UTF8SMTPSA id 8ACB6E92; Wed, 17 Sep 2025 22:16:57 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1758140217; bh=mKScnHea3GrxukNJbGL0G0ULW8tuIXJRzlsL+XLd8/Q=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=wDc/KYMmkfD12rBggq8IMK3o+7D39IydWIISsdx00fFbv1rEEOTTHTw3A3mXhFvas cbHuTFJ3czVb0d1ZWkK15kOumKZiKea9QptygfwNC84Vh5pzD9MZn4XKq50aGWF7PE F+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 X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" From: Stefan Klug Include doxygen-awesome-css in the doxygen config. The project's documentation indicated that the HTML_COLORSTYLE option needs to be set to LIGHT starting with Doxygen 1.9.5. The reason isn't explained, and tests have not shown any noticeable difference with Doxygen 1.9.5, 1.13.2 and 1.14.0. Unlike Doxygen itself that generates different CSS files depending on the HTML color style, doxygen-awesome-css use the same CSS that defaults to auto-light, and relies on adding "light-mode" to the class of the element manually to disable dark mode. As we don't this, doxygen-awesome-css effectively operates in auto-light mode. Given that setting HTML_COLORSTYLE to LIGHT makes no visible difference, leave the option unset to default to auto-light mode that matches the actual behaviour. Signed-off-by: Stefan Klug Signed-off-by: Laurent Pinchart Reviewed-by: Stefan Klug Reviewed-by: Barnabás Pőcze --- Changes since v2: - Drop HTML_COLORSTYLE - Drop GENERATE_TREEVIEW=YES as it is the default Changes since v1: - Fix ordering of configuration options - Use TOP_SRCDIR instead of CURRENT_SRCDIR to avoid introducing a new variable --- Documentation/Doxyfile-common.in | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/Doxyfile-common.in b/Documentation/Doxyfile-common.in index c9527da03ed5..23a0e3626f9d 100644 --- a/Documentation/Doxyfile-common.in +++ b/Documentation/Doxyfile-common.in @@ -54,6 +54,9 @@ EXCLUDE_SYMBOLS = libcamera::BoundMethodArgs \ IMAGE_PATH = "@TOP_SRCDIR@/Documentation/images" +HTML_EXTRA_STYLESHEET = "@TOP_SRCDIR@/Documentation/doxygen-awesome-css/doxygen-awesome.css" \ + "@TOP_SRCDIR@/Documentation/doxygen-awesome-css/doxygen-awesome-sidebar-only.css" + GENERATE_LATEX = NO MACRO_EXPANSION = YES