Received: by 2002:a05:6358:3188:b0:123:57c1:9b43 with SMTP id q8csp2655251rwd; Fri, 19 May 2023 08:29:04 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ7LhAidFb2V4cDStaStxYywKYNygohX1RaljA3slYpwvpipFS8ku8DjmKX6drB+HWrANY5I X-Received: by 2002:a17:90a:ce07:b0:253:8c39:642 with SMTP id f7-20020a17090ace0700b002538c390642mr1551984pju.5.1684510144707; Fri, 19 May 2023 08:29:04 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1684510144; cv=none; d=google.com; s=arc-20160816; b=qKnLrobAZYkq9reu4aMTLcaAD7+uaZnjKygmLOqUB06RFtF6LRPv4pMAc9vyfGeRm2 incf+svEd3evS6t7T8XZnILs34MTxqqZOx/25zheClaTeEuFl+xRnq53CrB8LSLenknU 8Ahl6Nw+wuaKMLX7AEp7KGcyVLLY370qcFio5oRo+jbxcehhuWskkQHeLLE8rYLg86Kh 8cWEnw/ZRg2594oeXgCMhOrCinp2o9pTyWzYOmu4o2RArvoAYyvdwMxOjOJXR/9nUYEo 4mwhPsuF6wvkqQLY+7HCARNXsQF4sIPyWxv8T099T9O31qFObj1l+TA8KMbnFzNol0Yw zj5g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:dkim-signature:dkim-filter; bh=9y+CNJUJ/q53O04APVAqsBIL53iBrmcTq7YLBNX8bkU=; b=WTO9I773gQE3uNuQW39fhmq9Oab1ECuxqYoMsbbhbVC5vqQtDmiIdjV5ch77xeuJs9 ZgJ59oQDD+mSC00EFK9ThHP0Bpvwdjtuksg9o4eYBnRA2c2Qjy1A1Ty/Fbzb/AW/yZKV afGWci8fGE6QivLOEqFOJCr8JFPpPmYVD7SluqBDjP8l9oTsj60NxWoz/H0D9hg89w+z 1gPdToezc9hYH4AfIV1WYHvht3IakcOgAEhfo7kVVmXOhFDj2VSH6ciZDPvlORqE9jTo G2oT00+6aqrykNUJsolgd5IL4286Gobihk6GR1iAEtxC1iYeWs2tUg+fQaRtZeUFuXMc NK7Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b="eHU//7R8"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id mg16-20020a17090b371000b002535d0a89f8si1707715pjb.186.2023.05.19.08.28.52; Fri, 19 May 2023 08:29:04 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b="eHU//7R8"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232258AbjESPNo (ORCPT + 99 others); Fri, 19 May 2023 11:13:44 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47140 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232231AbjESPNn (ORCPT ); Fri, 19 May 2023 11:13:43 -0400 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7756B1AD; Fri, 19 May 2023 08:13:36 -0700 (PDT) Received: from localhost (unknown [IPv6:2601:281:8300:73::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 0EAF37C0; Fri, 19 May 2023 15:13:36 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 0EAF37C0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1684509216; bh=9y+CNJUJ/q53O04APVAqsBIL53iBrmcTq7YLBNX8bkU=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=eHU//7R89icFJlQhKcfphBAKpEZT2kWF0ZDwLEhvsxrVXuqnaHON78v7aoBlrvGiV bTr2i3kNU0jFFgiFLngJDmN5HXbSsWXHuVsyWSiZMhui9MbYagzLBI7ZMtxZjtJck1 mH/df7gu6X1SyIHolXJ/DGiRGxRTJcRx39LEkeeU1v6+o7zgfsudxxhCiJvi7u5bvs PH7qEFIqKHZit3vLoYit3wLU4Lkt696E4oi3Y4BvGM/Zi8Vl5lEHAfNhEYlT3eWPy9 UAaV4RfPYOhiKBMdFpTuIGoch3VU58nrxzJDOPSKYwx+twEuZuyb16RRVmPKmmIs6c y/YOR4pKyCsqw== From: Jonathan Corbet To: James Seo , Greg Kroah-Hartman , Andrew Morton Cc: James Seo , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH 0/3] Generate documentation for error pointer functions In-Reply-To: <20230509175543.2065835-1-james@equiv.tech> References: <20230509175543.2065835-1-james@equiv.tech> Date: Fri, 19 May 2023 09:13:35 -0600 Message-ID: <877ct4nylc.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org James Seo writes: > The error pointer functions are collectively mentioned hundreds of times > in existing documentation (e.g. "Return: an ERR_PTR() on failure.", > "If IS_ERR() is true, the function failed and PTR_ERR() gives you the > error code.") > > This series adds kerneldocs for them and brings them into the docs build, > immediately turning most such mentions into automatic cross-references. > > James Seo (3): > Documentation: conf.py: Add __force to c_id_attributes > err.h: Add missing kerneldocs for error pointer functions > Documentation: core-api: Add error pointer functions to kernel-api > > Documentation/conf.py | 1 + > Documentation/core-api/kernel-api.rst | 6 ++++ > include/linux/err.h | 48 +++++++++++++++++++++++++++ > 3 files changed, 55 insertions(+) Series applied, thanks. jon