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 BC9A1439C5; Thu, 25 Jan 2024 20:57:56 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id AA94C402AB; Thu, 25 Jan 2024 20:57:56 +0100 (CET) Received: from inbox.dpdk.org (inbox.dpdk.org [95.142.172.178]) by mails.dpdk.org (Postfix) with ESMTP id 2C29F4029B for ; Thu, 25 Jan 2024 20:57:56 +0100 (CET) Received: by inbox.dpdk.org (Postfix, from userid 33) id 24ADE439C7; Thu, 25 Jan 2024 20:57:56 +0100 (CET) From: bugzilla@dpdk.org To: dev@dpdk.org Subject: [DPDK Bug 1373] Make docstrings less verbose, or reduce repeats Date: Thu, 25 Jan 2024 19:57:56 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: DPDK X-Bugzilla-Component: dts X-Bugzilla-Version: unspecified X-Bugzilla-Keywords: X-Bugzilla-Severity: normal X-Bugzilla-Who: probb@iol.unh.edu X-Bugzilla-Status: UNCONFIRMED X-Bugzilla-Resolution: X-Bugzilla-Priority: Normal X-Bugzilla-Assigned-To: dev@dpdk.org X-Bugzilla-Target-Milestone: --- X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter cc target_milestone Message-ID: Content-Type: multipart/alternative; boundary=17062126760.1Ef2.1516685 Content-Transfer-Encoding: 7bit X-Bugzilla-URL: http://bugs.dpdk.org/ Auto-Submitted: auto-generated X-Auto-Response-Suppress: All MIME-Version: 1.0 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 --17062126760.1Ef2.1516685 Date: Thu, 25 Jan 2024 20:57:56 +0100 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: http://bugs.dpdk.org/ Auto-Submitted: auto-generated X-Auto-Response-Suppress: All https://bugs.dpdk.org/show_bug.cgi?id=3D1373 Bug ID: 1373 Summary: Make docstrings less verbose, or reduce repeats Product: DPDK Version: unspecified Hardware: All OS: All Status: UNCONFIRMED Severity: normal Priority: Normal Component: dts Assignee: dev@dpdk.org Reporter: probb@iol.unh.edu CC: juraj.linkes@pantheon.tech, probb@iol.unh.edu Target Milestone: --- Thomas mentions that testsuites files should have as few lines as possible.= Of course, we will be adding some functions which simplify the actual code, wh= ich will aleviate this issue, but we can also look at reducing the amount of docstring lines in DTS. He mentions if a superclass has a docstring for a function and that function is overridden by the subclass, the docstring may= not need to be repeated in the subclass. --=20 You are receiving this mail because: You are the assignee for the bug.= --17062126760.1Ef2.1516685 Date: Thu, 25 Jan 2024 20:57:56 +0100 MIME-Version: 1.0 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: http://bugs.dpdk.org/ Auto-Submitted: auto-generated X-Auto-Response-Suppress: All

Bug ID	1373
Summary	Make docstrings less verbose, or reduce repeats
Product	DPDK
Version	unspecified
Hardware	All
OS	All
Status	UNCONFIRMED
Severity	normal
Priority	Normal
Component	dts
Assignee	dev@dpdk.org
Reporter	probb@iol.unh.edu
CC	juraj.linkes@pantheon.tech, probb@iol.unh.edu
Target Milestone	---

Thomas mentions that testsuites fi=
les should have as few lines as possible. Of
course, we will be adding some functions which simplify the actual code, wh=
ich
will aleviate this issue, but we can also look at reducing the amount of
docstring lines in DTS. He mentions if a superclass has a docstring for a
function and that function is overridden by the subclass, the docstring may=
 not
need to be repeated in the subclass.

You are receiving this mail because:

You are the assignee for the bug.

=20=20=20=20=20=20=20=20=20=20

= --17062126760.1Ef2.1516685--