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 59DB2A034C; Wed, 22 Jun 2022 22:54:50 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 47B474069C; Wed, 22 Jun 2022 22:54:50 +0200 (CEST) Received: from mail-pf1-f179.google.com (mail-pf1-f179.google.com [209.85.210.179]) by mails.dpdk.org (Postfix) with ESMTP id 632C5400D6 for ; Wed, 22 Jun 2022 22:54:49 +0200 (CEST) Received: by mail-pf1-f179.google.com with SMTP id d17so8183159pfq.9 for ; Wed, 22 Jun 2022 13:54:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20210112.gappssmtp.com; s=20210112; h=date:from:to:cc:subject:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=L1jdJJqn6d7JkKRzAGSKUTw/6zHsLyfdNLxTOSmZXw4=; b=4yS3dcUOWqIfUwWg875jbmDQ/iG8ItjUS5ay0CCd/1jEvalT1unWAME46HMv49s882 22ra+za0uve233RaxxMHgg5UeJEDUB2RyXdi/sov06N7XItgTxqXMowPd2A7G5z0gRiC sOLzjOENXWsV4FccPRczwnFtlHThMoQLzO01XPGwCHavk/SeP4EqSNU0WbaW9TLLsDVN e2dp00ygAdx5uc+6p2ZaFrk6aamns8rzcsQh+8QE622qiaud7vNyjq3DLU91Ko3nhvC+ eckv7WiiUFdPMLDlDg18qPSRgjnjmu0//EchVEHNIpYY7umPxdSfmqmWgWfMuPzJca5J 4sqg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:date:from:to:cc:subject:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=L1jdJJqn6d7JkKRzAGSKUTw/6zHsLyfdNLxTOSmZXw4=; b=L/ELBjsx+3w3w26FYPKlG7wJxsr5eoBTgcg/tJsd321zDP5wH+jiJqmQ1ncvoPTkqM E5vC/9saYKgWjzrmzShrQ1TcwSae/SHt84Du8mvC9hVuzzQwbxS0gr8dAF/NR4b2aHZR Usg0UtMICFyMafRDKGG/iPjcpa13rRDRXJQDLD9b2tcRmViz2Z8kURCuSv5jeNkL+IAr KbhGH5+IMtoSWomYMhE+2F8u6ROLqWaRR4XsUSk7U8gjwhycFLE5G+24mS4IHU71Uc8Z DZDfmNobSrJnd1dBUVivl2g8suvaSjzt1KbOCyhuZnuKyQskubrqM1I9DhaPsD1n+AVi IqzA== X-Gm-Message-State: AJIora/WFwU5BZctTEw6S6D0HRtiIua7aR++bTfJUpdGZLOdXySzsqOL GBvLmzkS3PT5MkP0QJ5eP/r42A== X-Google-Smtp-Source: AGRyM1sfdFajcRb6wBMRHpr2NMrVeRKsMqM8Tuk3A8ySqHGFWUCNCyXzz6VkcGMrRN+LQap3mCSX8w== X-Received: by 2002:a63:6e44:0:b0:40c:73a7:b6c9 with SMTP id j65-20020a636e44000000b0040c73a7b6c9mr4402847pgc.285.1655931288649; Wed, 22 Jun 2022 13:54:48 -0700 (PDT) Received: from hermes.local (204-195-112-199.wavecable.com. [204.195.112.199]) by smtp.gmail.com with ESMTPSA id e6-20020a17090301c600b0015eab1b097dsm13171060plh.22.2022.06.22.13.54.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 22 Jun 2022 13:54:48 -0700 (PDT) Date: Wed, 22 Jun 2022 13:54:46 -0700 From: Stephen Hemminger To: Tyler Retzlaff Cc: dev@dpdk.org Subject: Re: [PATCH 0/2] remove unnecessary words in function documention Message-ID: <20220622135446.0aa0e006@hermes.local> In-Reply-To: <20220622203712.GC20387@linuxonhyperv3.guj3yctzbm1etfxqx2vob5hsef.xx.internal.cloudapp.net> References: <20220622202738.401690-1-stephen@networkplumber.org> <20220622203712.GC20387@linuxonhyperv3.guj3yctzbm1etfxqx2vob5hsef.xx.internal.cloudapp.net> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit 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 On Wed, 22 Jun 2022 13:37:12 -0700 Tyler Retzlaff wrote: > On Wed, Jun 22, 2022 at 01:27:36PM -0700, Stephen Hemminger wrote: > > The phrase "This API is used to" is unnecessary and changes the > > documentation into passive voice. > > > > Stephen Hemminger (2): > > rawdev, dmadev: remove passive voice in function doc > > eal: remove passive voice from interrupt function documentation > > > > drivers/raw/ioat/rte_ioat_rawdev.h | 2 +- > > lib/dmadev/rte_dmadev.h | 2 +- > > lib/eal/include/rte_interrupts.h | 23 +++++++++++------------ > > 3 files changed, 13 insertions(+), 14 deletions(-) > > > > -- > > the re-wording has shortened some of the lines, i'm not sure what > takes precedence (minimum diff vs line length convention). > Doxygen repacks line during documentation generation