Received: by 2002:a05:6358:9144:b0:117:f937:c515 with SMTP id r4csp6155116rwr; Tue, 9 May 2023 11:00:19 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ43kBjhGT3jicbTM5HKNo8pU/91M0QBqddnItoxiVh4ktt5yJiGv30WwwELT2U7H97p9jhI X-Received: by 2002:a17:902:d50c:b0:1ab:f74:a118 with SMTP id b12-20020a170902d50c00b001ab0f74a118mr18605820plg.19.1683655219041; Tue, 09 May 2023 11:00:19 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1683655219; cv=none; d=google.com; s=arc-20160816; b=KzWBlRdzTN/Gk13OrywqgDDxMhZfBEtN+i7VZrA33v/7YQ03snjC7UREyj3kD5PHL6 AH6I97gG+3ATQEJ8ITqfuOpoVmJUah1y9Pc2RyqGe9LHnZYtWlnz4GBzhw2HKNsql2lM bhZYaIXhVvEGyIVPzA+Vt3g6huGWlAcuOJvMg0DeDW3r9dsMZwZOM2C7sRZ+gg5n2Hxc gqGJ2PkSifoNdWuGrXIhXhrRNiQjUQGxTWO2G8KzUgMUSP8BN4GIQuxBluWznvUZdwOK GwA6YAg3FlrbwQbBjI+OvTBSBT4uvUuZedlKr3XvhLhJf0xpg296qixOhnkHX1zFHhCw LDiA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:sender:dkim-signature; bh=H0s1EjZuxhXngjZYqwpGITBPMAphxWLlgrAxCrBbyGo=; b=TTb4+y5nlgy5sfXPO/LIXWsWYB11FnBfJ5MQUGp1eSFsasFeb5iaq1rRFQLws9Xb+B k/BrhsyY0Y0395p+WygeXkJFp0EppTbj4bbe/WMTju4do2C+BNbG5UltuK1vBHCNuLQR Wi4gsc5Enh8ge1WUttBbYNqIXdp9Z3qXrl6VEWsusS1L9p9IZkKzDpBX374yy6UZU6Wz pX4Ctx2yT/CwlEM9XpOYT6rE0rtOLmCkWQA4hZHMBwTvz1bgvm7OjYvpNraalYNZfpW9 Ofom72hxGS8SK8gXItlUsBhpg+kzD+k3RTy4NB2NQvabbw5nzWE++uX3OFu+ws6y58fm UFOg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@equiv.tech header.s=mx header.b=JJpzwpot; 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; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=equiv.tech Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id u18-20020a170902e81200b001a51368b098si2150064plg.209.2023.05.09.11.00.03; Tue, 09 May 2023 11:00:19 -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=@equiv.tech header.s=mx header.b=JJpzwpot; 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; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=equiv.tech Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229491AbjEIR5e (ORCPT + 99 others); Tue, 9 May 2023 13:57:34 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56886 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229543AbjEIR5c (ORCPT ); Tue, 9 May 2023 13:57:32 -0400 Received: from m228-4.mailgun.net (m228-4.mailgun.net [159.135.228.4]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 70E5A40F4 for ; Tue, 9 May 2023 10:57:31 -0700 (PDT) DKIM-Signature: a=rsa-sha256; v=1; c=relaxed/relaxed; d=equiv.tech; q=dns/txt; s=mx; t=1683655050; x=1683662250; h=Content-Transfer-Encoding: MIME-Version: Message-Id: Date: Subject: Subject: Cc: To: To: From: From: Sender: Sender; bh=H0s1EjZuxhXngjZYqwpGITBPMAphxWLlgrAxCrBbyGo=; b=JJpzwpotyqD7HAot+RB44YbnoPidp4bgCUdzqMT+O4mf5OGzmE6L5eAUSAuckB40VUHwWKXp2Tc31aTQT7EOhkTSLgil4P0IlaIB3Db06Hq/QstEB6MMLbdTOKQf+Q3EvgW1iOaqlsM9KqHKBuQaClFbASUD/RkvFWfkTXarUF9EhnMZWM4RblErpTwVDVfW8/+GRfl9nfHWPUx3SYJ4Rr2skw3nZrhPkPuH8pUJcuLp22s6YzOIHrgu8et6Nn99SAVhxWIgeCCVem2Hv0NBc8YaVUUu1R3g+YrOps+EavPAywiBtHd4Xbxd4d0rEJjwTa/N3/4SBc060OYLOWqg8w== X-Mailgun-Sending-Ip: 159.135.228.4 X-Mailgun-Sid: WyI4ZWI3MiIsImxpbnV4LWtlcm5lbEB2Z2VyLmtlcm5lbC5vcmciLCI5M2Q1YWIiXQ== Received: from mail.equiv.tech (equiv.tech [142.93.28.83]) by 6da7de3861f4 with SMTP id 645a898a2eb1ecdcf6398bdb (version=TLS1.2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256); Tue, 09 May 2023 17:57:30 GMT Sender: james@equiv.tech From: James Seo To: Jonathan Corbet , Greg Kroah-Hartman , Andrew Morton Cc: James Seo , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 0/3] Generate documentation for error pointer functions Date: Tue, 9 May 2023 10:55:41 -0700 Message-Id: <20230509175543.2065835-1-james@equiv.tech> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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 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(+) -- 2.34.1