From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.1 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id C4622C433ED for ; Wed, 19 May 2021 22:51:00 +0000 (UTC) Received: from desiato.infradead.org (desiato.infradead.org [90.155.92.199]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 8AE3F6135C for ; Wed, 19 May 2021 22:51:00 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 8AE3F6135C Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=linux.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=desiato.20200630; h=Sender:Content-Transfer-Encoding :Content-Type:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:In-Reply-To:MIME-Version:References:Message-ID: Subject:Cc:To:From:Date:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=H2JqB2sA5DrEK4ToT+YptqGG6IrU1XQoCJKZBT8ZZW0=; b=fJIHsrY65caWhCRi0XQw04wZF s9rP63PQ38AHjkbawjBIFSBXo6h6+UWaRjf+9Zjei2ENdGxZZvnB6dajS5jlZDdkLdgydBr1Pe+NY E2AO/Gnl0niWR7iiNI+cvj/fwaBAu540vuVOZ/wK5DKzWrevR+RSGDijfMn0qPvEHs19XBiNmBDYx 0stVBiLNUScFrpFTL4Ds7sFEDDuazJohfC64V+wX04UAvEiWqANU5z2ZNPA81DtNB1nmqEbzhWZSt GExi1oL3mRfvBbWTZuy7KPfz5Y3JEX5iBuE7uSfqY/H9s+KaEAt422DjqH7w+0IU7NebDGo9o33U/ Eyhd9W+9w==; Received: from localhost ([::1] helo=desiato.infradead.org) by desiato.infradead.org with esmtp (Exim 4.94 #2 (Red Hat Linux)) id 1ljV0B-005Hig-Mq; Wed, 19 May 2021 22:49:21 +0000 Received: from bombadil.infradead.org ([2607:7c80:54:e::133]) by desiato.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1ljV08-005HiQ-7X for linux-arm-kernel@desiato.infradead.org; Wed, 19 May 2021 22:49:17 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=In-Reply-To:Content-Type:MIME-Version :References:Message-ID:Subject:Cc:To:From:Date:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description; bh=0CaTOf83E6W/vr9C4g97RwC3pF79Es1qTa32MdRuStU=; b=4REuNa0mZBS/vcRqRPHS7boJia gLxuRBUNkRsOANJAFZ+AjhaQrYWaJP/GuTxi6FtFtLmzxTxAROV715rclFbMdmgICD1FGiefIDvLy eA72yur0d3cqilP9mXhzYewu+Xo9Vq0unT3P5Z7qTc/NBgmU/YUV+Yh//Q6gsZjcZmZyRXqR1azC+ UeFHUHKpuDRCUkDee9yQyGiew4WU6YBSFiFR4VyIgYAQwrnv15yFuPoblK4EPKWkrD3b6Urm5cuZr xb+XXuIIRJEiZED6XkVrbFqVfOQjWitt0UvyhZM6g2aF2IqTI4r8/oW4JQM37lHmP9vaRkd8YQxM4 4Y7hUQKQ==; Received: from mail-wm1-f50.google.com ([209.85.128.50]) by bombadil.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1ljV04-00FpPd-7t for linux-arm-kernel@lists.infradead.org; Wed, 19 May 2021 22:49:14 +0000 Received: by mail-wm1-f50.google.com with SMTP id z19-20020a7bc7d30000b029017521c1fb75so4291861wmk.0 for ; Wed, 19 May 2021 15:49:11 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=0CaTOf83E6W/vr9C4g97RwC3pF79Es1qTa32MdRuStU=; b=AjGJO93a/k0ev8YkOAXXOMpkWBJYiT1770BjuJazO1Wi3jVVaXYS47MRqlRRYowCHL gR5vE9v0qRYcRJ63EJmoZHWYYqqZJNxbsk+92LMYw81wpU0fm8+sy/tJECuFCOazT37S BlNQvX209khSZUu93DxhysUhY42T0cyOexsSTWst860HWRbnlEfqfZgfvq/BMJnnTI+j uQ2tpEGGbzow6piz6PkMFVHqcin69DC1O1E3Qo/2/rZXxzy/Rhq5R6kh2redTvuTfzaT /O3+lAgEiimC6nebaOqf0jIC+J14T3pz/144Ts3W1l6b9CqFraqVbxGkB6k9utLpn7Q7 okFg== X-Gm-Message-State: AOAM5301vyOf2LqgvEtoaFidpXulc9aCXyVyw/N/WmK9mfhVHoC180/x 6pwDWV/u87R2KIIWUV4S9LY= X-Google-Smtp-Source: ABdhPJyaKtqHMsyyydxX5QGXFWs6pOh3vu3JdJ3ws0X10kgDQ/p7egAXlEfaz9h2vdL0hTuOnSFuAg== X-Received: by 2002:a1c:b6d5:: with SMTP id g204mr1269426wmf.106.1621464550755; Wed, 19 May 2021 15:49:10 -0700 (PDT) Received: from rocinante.localdomain ([95.155.85.46]) by smtp.gmail.com with ESMTPSA id f20sm780379wmh.41.2021.05.19.15.49.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 19 May 2021 15:49:10 -0700 (PDT) Date: Thu, 20 May 2021 00:49:08 +0200 From: Krzysztof =?utf-8?Q?Wilczy=C5=84ski?= To: Randy Dunlap Cc: Ray Jui , Bjorn Helgaas , Lorenzo Pieralisi , Rob Herring , Scott Branden , bcm-kernel-feedback-list@broadcom.com, linux-pci@vger.kernel.org, linux-arm-kernel@lists.infradead.org Subject: Re: [PATCH v2] PCI: iproc: Fix a non-compliant kernel-doc Message-ID: <20210519224908.GA616654@rocinante.localdomain> References: <20210519183829.165982-1-kw@linux.com> <3623373c-b95c-344f-63c3-3eeeda623e90@infradead.org> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <3623373c-b95c-344f-63c3-3eeeda623e90@infradead.org> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210519_154912_307825_791D2EBE X-CRM114-Status: GOOD ( 13.39 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Hi, > This is a really good cleanup, but there is still one kernel-doc > warning remaining after this patch is applied. Please see below. [...] > > - * iProc PCIe inbound mapping type > > + * enum iproc_pcie_ib_map_type - iProc PCIe inbound mapping type. [...] > > The above gives me this: > > pcie-iproc.c:151: warning: Enum value 'IPROC_PCIE_IB_MAP_MEM' not described in enum 'iproc_pcie_ib_map_type' > pcie-iproc.c:151: warning: Enum value 'IPROC_PCIE_IB_MAP_IO' not described in enum 'iproc_pcie_ib_map_type' > pcie-iproc.c:151: warning: Enum value 'IPROC_PCIE_IB_MAP_INVALID' not described in enum 'iproc_pcie_ib_map_type' > > > If you could fix that, it would be Nice. :) > > Even if not, it's a good cleanup. Thanks. Doh! Apologies! This is my bad - correcting the format of the kernel-doc made the parser go and check for the fields to be properly documented, thus this new warning. I need to also take care about this too, a very good point! Thank you for catching this! I will update everything accordingly. Krzysztof _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel