[{"id":35770,"web_url":"https://patchwork.libcamera.org/comment/35770/","msgid":"<20250910172710.GI20904@pendragon.ideasonboard.com>","date":"2025-09-10T17:27:10","subject":"Re: [PATCH 5/6] documentation: mainpage: Make it easier to\n\tdistinguish Public and Internal API","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:48PM +0200, Stefan Klug wrote:\n> It might be confusion to customers to see very similar looking doxygen\n> documentation with different content. Improve that by clearly stating\n> 'Public-API' or 'Internal-API' on the main page.\n> \n> Signed-off-by: Stefan Klug \n> ---\n> Documentation/mainpage.dox | 6 +++++-\n> 1 file changed, 5 insertions(+), 1 deletion(-)\n> \n> diff --git a/Documentation/mainpage.dox b/Documentation/mainpage.dox\n> index cbee9bab12ec..3f9fa24c1e14 100644\n> --- a/Documentation/mainpage.dox\n> +++ b/Documentation/mainpage.dox\n> @@ -1,5 +1,9 @@\n> /**\n> -\\mainpage libcamera API reference\n> +\\if internal\n> +\\mainpage libcamera Internal-API reference\n\ns/-API/ API/\n\n> +\\else\n> +\\mainpage libcamera Public-API reference\n\nDitto.\n\nReviewed-by: Laurent Pinchart \n\n> +\\endif\n> \n> Welcome to the API reference for libcamera,\n> a complex camera support library for Linux, Android and ChromeOS. These pages","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 6556BBDB13\n\tfor ;\n\tWed, 10 Sep 2025 17:27:35 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 0969869370;\n\tWed, 10 Sep 2025 19:27:35 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 3281A69357\n\tfor ;\n\tWed, 10 Sep 2025 19:27:33 +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 3310D8BF;\n\tWed, 10 Sep 2025 19:26:19 +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=\"BfPWzK18\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1757525179;\n\tbh=Rrs3PN5jwKh+P9nM6c16jUX9Binw9q61kQllGvqHdi8=;\n\th=Date:From:To:Cc:Subject:References:In-Reply-To:From;\n\tb=BfPWzK189D2JsOAqGNrGP/s4cy4Bv8xXwwb2Fif8102ZQFrDTVMXA8wcxFJWaJ2SJ\n\tfI0qhxFlyJj3+scsIgsHlycgNYJ7oiPE6cjBQQ4DGMvFIJdXYDu3wqvE++IV9OyRzI\n\tA6wau5+vot3vHUAS6BP4zinxOuNHyXjbo/Tsw754=","Date":"Wed, 10 Sep 2025 20:27:10 +0300","From":"Laurent Pinchart ","To":"Stefan Klug ","Cc":"libcamera-devel@lists.libcamera.org","Subject":"Re: [PATCH 5/6] documentation: mainpage: Make it easier to\n\tdistinguish Public and Internal API","Message-ID":"<20250910172710.GI20904@pendragon.ideasonboard.com>","References":"<20250908140803.123272-1-stefan.klug@ideasonboard.com>\n\t<20250908140803.123272-6-stefan.klug@ideasonboard.com>","MIME-Version":"1.0","Content-Type":"text/plain; charset=utf-8","Content-Disposition":"inline","In-Reply-To":"<20250908140803.123272-6-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\" "}}]