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 2AD4CA054A; Tue, 25 Oct 2022 18:00:22 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 1E1AE42C1F; Tue, 25 Oct 2022 18:00:22 +0200 (CEST) Received: from mail-pf1-f181.google.com (mail-pf1-f181.google.com [209.85.210.181]) by mails.dpdk.org (Postfix) with ESMTP id EBC1342C1D for ; Tue, 25 Oct 2022 18:00:20 +0200 (CEST) Received: by mail-pf1-f181.google.com with SMTP id i3so12205231pfc.11 for ; Tue, 25 Oct 2022 09:00:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20210112.gappssmtp.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:subject:cc:to:from:date:from:to:cc:subject:date :message-id:reply-to; bh=CdUAE6rQWX14rARTEEYfUeE0gDFdNDysN+N5hHF5Bpw=; b=jkWuFEQ11g9nw4ehKg/6K7KqMTGQgAxSeQ7nnTp7MbRpgf0fOa91ACDQ7q5kpZ8Gfc xWTbpG3vrTCckRURLGmi4VSnwS60ogtdSNddPihOl+2mflSk7ZBIpOoZpjuUChytv1zI DSDEsxTg6PYHse1F0zNbVS/33nR5ksDI+cVFf+tvCpbaW434UhoPZfG6/4V377Yanje/ gFMhY/aughfYMo7lw6ZnH/LR67cglU2QAFHizsdzdGkOg6fOswHTygt8JY4bMFxqV5Lp IGSLUF3VKq3vEiN56Iilqu9jDb9aQuMJPoYho8/92x1tym8t46q3xQqNc3BfZGcmY3lG WEwA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:subject:cc:to:from:date:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=CdUAE6rQWX14rARTEEYfUeE0gDFdNDysN+N5hHF5Bpw=; b=1CowQEO6JLYlQUBvUu2958cokZQtQnvkCiyGTIFooY+PhwyhDO450L0785ar2dp/bL 7k+GVxUdXSxmR7MFgqlypR7pzar3abatv9z8pGax7Yyn9yrfnx+cSNZq7myeE2BqG1zT 283/yr58mr00D7RbL2vrHni2lphOL9usmus6XMeHXTXpymJ0LrO1zDd1e65RHLKsTPYR EPldl8Wdr4n6NsG1NsqV219EBgpnwEfP7eFtxv47THRnFdxkPt3SIdU7PSJuH4QzSi1u RAWN2n29HKIoDkC6u6UKptuZ74XsN6BNWMZKgLXm7GwJVsq6LQ2XJ237XmxeCt0pJ7ui QrAQ== X-Gm-Message-State: ACrzQf2VN/MXFcaFqtVh1D8UJnW0W5roimMqpslF3q2qilNpTJL3wDpx 88wdOhqkzlQJ+mmhXN5NRMqOIQ== X-Google-Smtp-Source: AMsMyM5590+oP+3Fm8YuF/Pztr2blMFaT9oA4eMrCpwlB7sY9oWTjok7tXlckQmLK/8SjSnOqvdSCg== X-Received: by 2002:a63:f47:0:b0:46a:e00c:24c7 with SMTP id 7-20020a630f47000000b0046ae00c24c7mr33787589pgp.239.1666713620019; Tue, 25 Oct 2022 09:00:20 -0700 (PDT) Received: from hermes.local (204-195-120-218.wavecable.com. [204.195.120.218]) by smtp.gmail.com with ESMTPSA id 132-20020a62168a000000b00565c8634e55sm1537018pfw.135.2022.10.25.09.00.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 25 Oct 2022 09:00:19 -0700 (PDT) Date: Tue, 25 Oct 2022 09:00:18 -0700 From: Stephen Hemminger To: Ali Alnubani Cc: Subject: Re: [PATCH v2] lib: remove empty return types from doxygen comments Message-ID: <20221025090018.67a4b405@hermes.local> In-Reply-To: <20221025133238.3211967-1-alialnu@nvidia.com> References: <20221025132220.3209578-1-alialnu@nvidia.com> <20221025133238.3211967-1-alialnu@nvidia.com> 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 Tue, 25 Oct 2022 16:32:38 +0300 Ali Alnubani wrote: > Recent versions of doxygen (1.9.4 and newer) complain about > documented return types for functions that don't return anything. > > This patch removes these return types to fix build errors similar > to this one: > [..] > Generating doc/api/doxygen with a custom command > FAILED: doc/api/html > /usr/bin/python3 /path/to/doc/api/generate_doxygen.py doc/api/html > /usr/bin/doxygen doc/api/doxy-api.conf > /root/dpdk/lib/eal/include/rte_bitmap.h:324: error: found documented > return type for rte_bitmap_prefetch0 that does not return anything > (warning treated as error, aborting now) > [..] > > Tested with doxygen versions: 1.8.13, 1.8.17, 1.9.1, and 1.9.4. > > Signed-off-by: Ali Alnubani Acked-by: Stephen Hemminger