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 B425DA054F for ; Tue, 20 Dec 2022 18:18:43 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id B154240698; Tue, 20 Dec 2022 18:18:43 +0100 (CET) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mails.dpdk.org (Postfix) with ESMTP id E36B240395 for ; Tue, 20 Dec 2022 18:18:42 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1671556722; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=Iz7wc41rPPqmL2sq0E+ryzqu42ekp4iVHoEaZq+otG0=; b=ASWyKZayOsFLGgoVOY4WTp2EkHkXzzTeqLUbJ12j8/bL9gTBdc2Gx6XLG8waJQURo36tOr gDB4V02YaDOA+BzxsGrjhcXiR13LzdFY+dDiaHlRuPWFLir3DO2Z+pf4q5sGPWX1Ccpw5p iSz3d3v1/ZwdMLtBk/H11faNuEEgKYQ= Received: from mail-wr1-f70.google.com (mail-wr1-f70.google.com [209.85.221.70]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_128_GCM_SHA256) id us-mta-122-PSVqFX24OQ6WkOQRUtN5Fg-1; Tue, 20 Dec 2022 12:18:30 -0500 X-MC-Unique: PSVqFX24OQ6WkOQRUtN5Fg-1 Received: by mail-wr1-f70.google.com with SMTP id u9-20020adfa189000000b00242121eebe2so1087469wru.3 for ; Tue, 20 Dec 2022 09:18:29 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=Iz7wc41rPPqmL2sq0E+ryzqu42ekp4iVHoEaZq+otG0=; b=i+eaZ33eml1vNkUA5G533blPOVPYJkbzfMiCcpiPBcpwrN5fTCW5Znsuu5kXQPv5/D gDiGDP3a6focT6XOGIeQhL9XbR1IMBVD0pvJvXV4FjJv459EcgwGMp3BZPgGXd8xQgA9 r54mrysX/ykuHWRpq8TImSQvqlhf8Q5tVnNHx3lmqWNNpvJ5yN+pawUGX2iWcIYttSw0 FlVxbT20QANqLSi24N/T1q4phEUDh8mCIM10D3I3/u1HTbxpXXVOQYrIR/NUsAApnhyR Txmn7Us1A08TCpD/E+i77FwZSPALOe48TwpGALQsgiY8fa/VOZ7UyEEd7+h/DrtObyNI bjQA== X-Gm-Message-State: ANoB5pkrqOxOMM9X139DHt6ZGIadb2UJjANRJtXlezdlMNhU5JYjhw6N 5eONu7D0qLebnHB588EdwaPfsmuwPpxcgt+heOztaiTz2kAACQoQsb3N3+x1+QNItCxc22agXgV 9J90a07b091cfLVrouIHT8o46JSjJXsp+pzB1XyPuOIyGxEc3uPSmZN2CH/w= X-Received: by 2002:a05:600c:687:b0:3d2:3376:6f38 with SMTP id a7-20020a05600c068700b003d233766f38mr21409412wmn.20.1671556707026; Tue, 20 Dec 2022 09:18:27 -0800 (PST) X-Google-Smtp-Source: AA0mqf5TXmZcQExTL5CUjAdu1lCG7lZaps4VIWJMYpCNGAEBdh1tflq2f09y6x8i0F9OhrbXCUsqqg== X-Received: by 2002:a05:600c:687:b0:3d2:3376:6f38 with SMTP id a7-20020a05600c068700b003d233766f38mr21409395wmn.20.1671556706822; Tue, 20 Dec 2022 09:18:26 -0800 (PST) Received: from [192.168.0.36] ([78.17.251.111]) by smtp.gmail.com with ESMTPSA id k187-20020a1ca1c4000000b003d22528decesm23852158wme.43.2022.12.20.09.18.25 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 20 Dec 2022 09:18:26 -0800 (PST) Message-ID: <3c650869-1aaf-27ca-7526-45a3b0d856b0@redhat.com> Date: Tue, 20 Dec 2022 17:18:25 +0000 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.5.1 Subject: Re: [PATCH 21.11] vhost: fix doxygen warnings To: stable@dpdk.org Cc: alialnu@nvidia.com, david.marchand@redhat.com, Maxime Coquelin , Chenbo Xia References: <20221220123712.239728-1-ktraynor@redhat.com> From: Kevin Traynor In-Reply-To: <20221220123712.239728-1-ktraynor@redhat.com> X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Language: en-US Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-bounces@dpdk.org On 20/12/2022 12:37, Kevin Traynor wrote: > Doxygen 1.9.5 gives a false positive warnings [1] > for @params on function pointer params. > > This is fixed in doxygen 1.9.6 but Fedora 37 uses > 1.9.5 at present. > > Remove the @param but keep the comments for info in > the header file as a workaround until 1.9.6 is more > widely deployed. > > [1] > /lib/vhost/rte_vhost_async.h:48: warning: > rte_vhost_async_channel_ops::transfer_data > has @param documentation sections but no arguments > /lib/vhost/rte_vhost_async.h:68: warning: > rte_vhost_async_channel_ops::check_completed_copies > has @param documentation sections but no arguments > > Signed-off-by: Kevin Traynor > --- Pushed to 21.11 branch for 21.11.3. Thanks.