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=-9.6 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=unavailable 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 77D82C32750 for ; Mon, 12 Aug 2019 16:08:04 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 4D38220665 for ; Mon, 12 Aug 2019 16:08:04 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=gmx.net header.i=@gmx.net header.b="a0Q7VXbY" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726770AbfHLQH7 (ORCPT ); Mon, 12 Aug 2019 12:07:59 -0400 Received: from mout.gmx.net ([212.227.17.20]:56593 "EHLO mout.gmx.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725843AbfHLQH7 (ORCPT ); Mon, 12 Aug 2019 12:07:59 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1565626054; bh=x7tRP3TUDgUF+IKb4TvatQotKrueobFDeaa3admljZw=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=a0Q7VXbYNp3W+/Ei587ZUwIEgJhelIsUA+4wVX4pWFGA0hEamcXv0uz1hPIJOfnNC /ROv+Y466tpf+uY7RitJLB9SkWwHAM60Y1ZgmGRyuZlKhRRgxV1wU2MRE4+7AaPgTn 2L2f0q5XJSdZhkeyuOIIXlwsRWXt+y5em8Xccel0= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Received: from longitude ([78.34.97.158]) by mail.gmx.com (mrgmx103 [212.227.17.168]) with ESMTPSA (Nemesis) id 0McUnM-1hffyH2C0W-00HfT8; Mon, 12 Aug 2019 18:07:34 +0200 From: =?UTF-8?q?Jonathan=20Neusch=C3=A4fer?= To: linux-doc@vger.kernel.org Cc: =?UTF-8?q?Jonathan=20Neusch=C3=A4fer?= , Jonathan Corbet , Alexei Starovoitov , Daniel Borkmann , "David S. Miller" , Jakub Kicinski , Jesper Dangaard Brouer , John Fastabend , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, netdev@vger.kernel.org, xdp-newbies@vger.kernel.org, bpf@vger.kernel.org Subject: [PATCH v2 2/2] Documentation: sphinx: Don't parse socket() as identifier reference Date: Mon, 12 Aug 2019 18:07:05 +0200 Message-Id: <20190812160708.32172-2-j.neuschaefer@gmx.net> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20190812160708.32172-1-j.neuschaefer@gmx.net> References: <20190812160708.32172-1-j.neuschaefer@gmx.net> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Provags-ID: V03:K1:YIa4yoGa5k1pGA+d7OBh3A+7OXq84EhShBQ46Qu+a2q+YkaL/P1 kPZybaGZw6dvvKRAcQtyZRduiFmRE3Edt5WyEK6kKMX5B1WNKC2U7F6KPsKj2oZ8l2U4r98 QktXu2o627d+wTSTI52UwxF/STzMSqZrL3m919Sg6CEigkiARRBnLf/NR+v7ifMCz4jpg8Y XexE38mtQM2zm8OTrceEA== X-UI-Out-Filterresults: notjunk:1;V03:K0:0Ri/pCH+kAs=:n9wc26zEgmVw/wT6M6uL0y TBWFVv0FXVbthr4k+9RWqHS4wRlLTdo1Vu8cQfPlUnysLCuOYpQ1ES0d03mbPIZ6XN9JSuBBQ UcdT5ifhXONfOfkXtAVu6gA+jj1s3hfz6G5aSLFBykoRCLdmddckyAvegB0SGYc6U8FhL6W9j PsPvu9Pv4Q7l41UatOht4B1pqWg6tCRggyH0gGBYYzHZQpenF1Mb81r1GbL2fBFZlaflO3eOx M5N3+EPkAqgxBgzu2z0ZGtF8frK2ilKRRwtElxSNvribd66HMeTz9FqqEMwANeUhV9OA+jzO5 nqSMhN6a9BLans4+vmV/fQmLEKTwBLtuRtzunecfaXUZNIBN0M9byHmsKJHrufYz0jRmfXzpk fD6fi5KGcOBhE0fWCuqEYxF+pDKdRED1XTAvppwA0X5p84lUKIsbAUUVR8WeAF817gYstjZy6 RP0sxG01yGV0oTtosmLYtkijRJGheJtoR3napY3lKzS2VbE63tRGYX21mwILpawZdOcrY5jIy 6E14P1GJujwATdmnp9Tb5eqgLq5+5Tlf3Ujh8Mu4toV3Kmn7/oHln2a7uNAYzbtwRJIDXip58 RAFWQVndyF4JJ6U8md034hS0gYAc8hrSJEe5Ecb3pajPVyaEfnXMauJodymNjL1xk2uGhT8aA R2d+GEJClxjZOjsl3ONM7Spmqhk1uQh8CchJFZu61SxIu60OjCaQshO1A67abXaevMtYAKBy/ AobQSwXmabuEpt4ZDqeQnZzBgaX3l5evYP/eR7a17ZMLEg45cZU2bp2KUaQ+KGqK4T5/N1SPD D7HOD/fJABoc/pPvrd5N6eoBjIG5oUPxYdcEDP6sScP8pNPMOYPlJP8hR+cYMO9WcxFhYH2Z1 YqdqFNiE6fALEssBOgnd9ZkkOLDBRkzLOQNZ5aQTpIo15SKCD7qIr9xyTciokKr5S36GilBki tXh5OGf3qmFnzPApT9fBggMHJ7BZIc9a9/2MNSP6u7iFJwPfmODiBszhEDv6f5HIqrpkO9LTq yVPBv/iWDFnnQe8F14D3TiYldrSiTaArlM5hA8BSyUtJIiLhOoSGLkVwvdpZaK5l/MsdqXPKS oLscBqV/cWReQ4WmxHIUxPsJ5AK6aUGb467ATEligOpYbwR7p4LtfbUjSxKkHL3wrh5BdSEbm fVaTk= Sender: bpf-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: bpf@vger.kernel.org With the introduction of Documentation/sphinx/automarkup.py, socket() is parsed as a reference to the in-kernel definition of socket. Sphinx then decides that struct socket is a good match, which is usually not intended, when the syscall is meant instead. This was observed in Documentation/networking/af_xdp.rst. Prevent socket() from being misinterpreted by adding it to the Skipfuncs list in automarkup.py. Signed-off-by: Jonathan Neusch=C3=A4fer =2D-- v2: - block socket() in Documentation/sphinx/automarkup.py, as suggested by Jonathan Corbet v1: - https://lore.kernel.org/lkml/20190810121738.19587-1-j.neuschaefer@gmx.ne= t/ =2D-- Documentation/sphinx/automarkup.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/sphinx/automarkup.py b/Documentation/sphinx/aut= omarkup.py index a8798369e8f7..5b6119ff69f4 100644 =2D-- a/Documentation/sphinx/automarkup.py +++ b/Documentation/sphinx/automarkup.py @@ -26,7 +26,8 @@ RE_function =3D re.compile(r'([\w_][\w\d_]+\(\))') # just don't even try with these names. # Skipfuncs =3D [ 'open', 'close', 'read', 'write', 'fcntl', 'mmap', - 'select', 'poll', 'fork', 'execve', 'clone', 'ioctl'] + 'select', 'poll', 'fork', 'execve', 'clone', 'ioctl', + 'socket' ] # # Find all occurrences of function() and try to replace them with =2D- 2.20.1