[{"id":35730,"web_url":"https://patchwork.libcamera.org/comment/35730/","msgid":"<20250908162639.GA18349@pendragon.ideasonboard.com>","date":"2025-09-08T16:26:39","subject":"Re: [PATCH 1/6] documentation: Add doxygen-awesome-css","submitter":{"id":2,"url":"https://patchwork.libcamera.org/api/people/2/","name":"Laurent Pinchart","email":"laurent.pinchart@ideasonboard.com"},"content":"Hi Stefan,\n\nThank you for the patch.\n\nOn Mon, Sep 08, 2025 at 04:07:44PM +0200, Stefan Klug wrote:\n> Add the doxygen-awesome files to the libcamera repository to improve\n> the styling of the doxygen documentation. These are from commmit\n> 9760c3001413 (\"[readme] Add example website DuMux doc (#178)\") of\n> https://github.com/jothepro/doxygen-awesome-css .\n\nI would have picked a tag, but I suppose it doesn't matter much.\n\n> Signed-off-by: Stefan Klug \n> ---\n> .../doxygen-awesome-darkmode-toggle.js | 157 +\n> .../doxygen-awesome-fragment-copy-button.js | 85 +\n> .../doxygen-awesome-interactive-toc.js | 91 +\n> .../doxygen-awesome-paragraph-link.js | 51 +\n> ...n-awesome-sidebar-only-darkmode-toggle.css | 40 +\n> .../doxygen-awesome-sidebar-only.css | 116 +\n> .../doxygen-awesome-tabs.js | 90 +\n> .../doxygen-awesome-css/doxygen-awesome.css | 2683 +++++++++++++++++\n> 8 files changed, 3313 insertions(+)\n> create mode 100644 Documentation/doxygen-awesome-css/doxygen-awesome-darkmode-toggle.js\n> create mode 100644 Documentation/doxygen-awesome-css/doxygen-awesome-fragment-copy-button.js\n> create mode 100644 Documentation/doxygen-awesome-css/doxygen-awesome-interactive-toc.js\n> create mode 100644 Documentation/doxygen-awesome-css/doxygen-awesome-paragraph-link.js\n> create mode 100644 Documentation/doxygen-awesome-css/doxygen-awesome-sidebar-only-darkmode-toggle.css\n> create mode 100644 Documentation/doxygen-awesome-css/doxygen-awesome-sidebar-only.css\n> create mode 100644 Documentation/doxygen-awesome-css/doxygen-awesome-tabs.js\n> create mode 100644 Documentation/doxygen-awesome-css/doxygen-awesome.css\n> \n> diff --git a/Documentation/doxygen-awesome-css/doxygen-awesome-darkmode-toggle.js b/Documentation/doxygen-awesome-css/doxygen-awesome-darkmode-toggle.js\n> new file mode 100644\n> index 000000000000..40fe2d38e090\n> --- /dev/null\n> +++ b/Documentation/doxygen-awesome-css/doxygen-awesome-darkmode-toggle.js\n> @@ -0,0 +1,157 @@\n> +/**\n\nWe want machine-parseable license information for all files. The\nrecommended method is SPDX, with .reuse/dep5 as a fallback (especially\nfor binary files).\n\nCould you please add a commit on top of this one to switch to SPDX ? I\nwould personally drop the \"MIT License\" line as well as the license text\nafter the copyright line, and try to submit the change upstream.\n\n> +\n> +Doxygen Awesome\n> +https://github.com/jothepro/doxygen-awesome-css\n> +\n> +MIT License\n> +\n> +Copyright (c) 2021 - 2023 jothepro\n> +\n> +Permission is hereby granted, free of charge, to any person obtaining a copy\n> +of this software and associated documentation files (the \"Software\"), to deal\n> +in the Software without restriction, including without limitation the rights\n> +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n> +copies of the Software, and to permit persons to whom the Software is\n> +furnished to do so, subject to the following conditions:\n> +\n> +The above copyright notice and this permission notice shall be included in all\n> +copies or substantial portions of the Software.\n> +\n> +THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n> +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n> +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n> +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n> +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n> +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n> +SOFTWARE.\n> +\n> +*/\n\n[snip]","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 CEA72C324E\n\tfor ;\n\tMon, 8 Sep 2025 16:27:03 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 0B37369353;\n\tMon, 8 Sep 2025 18:27:03 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 7935C6934E\n\tfor ;\n\tMon, 8 Sep 2025 18:27:01 +0200 (CEST)","from pendragon.ideasonboard.com (85-76-99-126-nat.elisa-mobile.fi\n\t[85.76.99.126])\n\tby perceval.ideasonboard.com (Postfix) with UTF8SMTPSA id 817F9725;\n\tMon, 8 Sep 2025 18:25:48 +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=\"rMwCA7FG\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1757348749;\n\tbh=7JdNd4Gz9Xm5KWSyXPX/xnSFzMeaYLKVWQ7j/FKIBrI=;\n\th=Date:From:To:Cc:Subject:References:In-Reply-To:From;\n\tb=rMwCA7FGb79Q2DNinRgsltXwFPrH67Om0LOUEcpJ4uhLpLO2vzQxlXNn6QT2yJrTA\n\tNRMIH0f7uU5dCQDrOVrxY7HHg+rdBoygd7fADned75CGcUnW2sRyoAeu8lI9BNPRuL\n\tRmso73fhtN0t10tq3jjRKaGX2GI/4ATuVJAFsINg=","Date":"Mon, 8 Sep 2025 18:26:39 +0200","From":"Laurent Pinchart ","To":"Stefan Klug ","Cc":"libcamera-devel@lists.libcamera.org","Subject":"Re: [PATCH 1/6] documentation: Add doxygen-awesome-css","Message-ID":"<20250908162639.GA18349@pendragon.ideasonboard.com>","References":"<20250908140803.123272-1-stefan.klug@ideasonboard.com>\n\t<20250908140803.123272-2-stefan.klug@ideasonboard.com>","MIME-Version":"1.0","Content-Type":"text/plain; charset=utf-8","Content-Disposition":"inline","In-Reply-To":"<20250908140803.123272-2-stefan.klug@ideasonboard.com>","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\" "}}]