From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id BCCAA43750; Thu, 21 Dec 2023 12:48:52 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id A79BC4027D; Thu, 21 Dec 2023 12:48:52 +0100 (CET) Received: from out2-smtp.messagingengine.com (out2-smtp.messagingengine.com [66.111.4.26]) by mails.dpdk.org (Postfix) with ESMTP id 35190400D6 for ; Thu, 21 Dec 2023 12:48:52 +0100 (CET) Received: from compute7.internal (compute7.nyi.internal [10.202.2.48]) by mailout.nyi.internal (Postfix) with ESMTP id CC1F35C0239; Thu, 21 Dec 2023 06:48:51 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute7.internal (MEProxy); Thu, 21 Dec 2023 06:48:51 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= cc:cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm2; t=1703159331; x=1703245731; bh=t0sKL1GMlUxtuMOdjua/h6zAH9sQP7YgzmG+9hiTW8c=; b= CXsB6+4+HK5d7B/W4UmwGXn01dx30q+Zl/9VBmSePA4pWx1afMwWDE2UmvMXhycY dzqm0ktQ/CUJoGLigJoQRv5QQ1wn60K+RqZe9H2mPkTvrPJYiBi19YK2cG13Yhjr SRLzl+dJvRPA+VArGtlrS8mOH7lAHgWyZCC5bIY1FusjVxIhTlflGAmRHqKLepf5 UExRlENqsGgyWegjiU0YJBN/++6PHEUv6FI+/JaNwHD3PNbBQY/ipOqPyH4ctt7F T56iBZY9BZbLB7TzN2YKmFsfVYAwNpLhEd/mqu6RJ8GM/A+1ZFcq6qPG9nkgSarC gOglQG5ISZG5gyLZKwVwcA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; t=1703159331; x= 1703245731; bh=t0sKL1GMlUxtuMOdjua/h6zAH9sQP7YgzmG+9hiTW8c=; b=2 fBxJQtkxqBIu+WjsmFgWKySLNmMWlDeif+v7i5v5jGCkEF2Zv8VOv/7YgfIMYzoI O7+q7dSRY1m5Zu+bwFH9iemqfaYNMHXnCHhnUlEnhFc307hrFPd3LY74UoS2IbWd CNpha6D43C+BhkR6pXdyDZzCBSORwA9FSc79zkhOAj4oBE64RsXiQBd1EJcbZURy GA++e9fl916cOPlzvjvLfnuQs+kxHBpfF78wYlRLieBSGNY04Ot8cn7ZKx0YzHsF mvq47rLTqQB33vRK2279etKiuDGyhdiuT+Px2x8oFcd1zNh18/2nJotAMjfk2pQR 1Vm5kz7GY5QBm9RWAdHVQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvkedrvdduhedgtdekucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvvefufffkjghfggfgtgesthhqredttddtjeenucfhrhhomhepvfhhohhm rghsucfoohhnjhgrlhhonhcuoehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenuc ggtffrrghtthgvrhhnpeegtddtleejjeegffekkeektdejvedtheevtdekiedvueeuvdei uddvleevjeeujeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfh hrohhmpehthhhomhgrshesmhhonhhjrghlohhnrdhnvght X-ME-Proxy: Feedback-ID: i47234305:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 21 Dec 2023 06:48:50 -0500 (EST) From: Thomas Monjalon To: Juraj =?utf-8?B?TGlua2XFoQ==?= Cc: Honnappa.Nagarahalli@arm.com, jspewock@iol.unh.edu, probb@iol.unh.edu, paul.szczepanek@arm.com, yoan.picchi@foss.arm.com, Luca.Vizzarro@arm.com, dev@dpdk.org Subject: Re: [PATCH v9 00/21] dts: docstrings update Date: Thu, 21 Dec 2023 12:48:48 +0100 Message-ID: <6572185.29KlJPOoH8@thomas> In-Reply-To: <20231204102429.106709-1-juraj.linkes@pantheon.tech> References: <20231123151344.162812-1-juraj.linkes@pantheon.tech> <20231204102429.106709-1-juraj.linkes@pantheon.tech> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="UTF-8" X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org 04/12/2023 11:24, Juraj Linke=C5=A1: > The first commit makes changes to the code. These code changes mainly > change the structure of the code so that the actual API docs generation > works. There are also some code changes which get reflected in the > documentation, such as making functions/methods/attributes private or > public. >=20 > The rest of the commits deal with the actual docstring documentation > (from which the API docs are generated). The format of the docstrings > is the Google format [0] with PEP257 [1] and some guidelines captured > in the last commit of this group covering what the Google format > doesn't. > The docstring updates are split into many commits to make review > possible. When accepted, they may be squashed. > The docstrings have been composed in anticipation of [2], adhering to > maximum line length of 100. We don't have a tool for automatic docstring > formatting, hence the usage of 100 right away to save time. Applied and squashed with few minor improvements. As discussed with Juraj privately, the copyright date bumps are removed, because unnecessary.