From patchwork Mon Jul 25 13:13:08 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: =?utf-8?q?Martin_Li=C5=A1ka?= X-Patchwork-Id: 5 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:6a10:b5d6:b0:2b9:3548:2db5 with SMTP id v22csp1645574pxt; Mon, 25 Jul 2022 06:17:42 -0700 (PDT) X-Google-Smtp-Source: AGRyM1sYLYPTWxCyBB8t9rY0gAWr/QNjh+G+IX3ZuR7GtXU3M1Dx9+KBT4G67RSewkTR2qFix6mb X-Received: by 2002:a05:6402:4028:b0:43a:8d67:faeb with SMTP id d40-20020a056402402800b0043a8d67faebmr13372268eda.90.1658755061927; Mon, 25 Jul 2022 06:17:41 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1658755061; cv=none; d=google.com; s=arc-20160816; b=YH97/K9cb2NkR/IlyyzSdp79sy48jEF+j8qCO9Iwk7aWnSG/0AKsaeXgcoLmSn4qWo GXPu4FX5l+MWYABqXGUm6bQbVgrdHah+LmFL0l7EyuhG91Yad3pEclte+vNKTrVh9Jjr UMt1X7OUfv35K2ty/t1AWFj1wsiTBjUcC5vkYmFhhbx48sRvb6tEntHeOgq1HcrF6lPD p5Jtstt25hz78kES8KNChoKSL0e/CGU7Lqd2k/QnyTygy4vdugjmfnzT+Brf9N5T7TTp H474HT6iep0HUDldUZxEriMAfp7y3wpm0CTLrZlE0EHFWxyGdTit0FFJoS3x/ekuQzCy GF+g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:to:subject:date:from:message-id :resent-message-id:resent-date:resent-cc:resent-to:resent-from :dkim-signature:dkim-signature:dmarc-filter:delivered-to; bh=Lbalap21C+dT/Ko3o23eJUVuiI9gXuF8GzCN5knjzYc=; b=0r3BDsYe200+SnMsMKDo4KMkemN5Q7e+aJi5WcUv9BZE+cdWvOGYcNXjgdYvFrvMkY Iqlo4zj0BwlVU1we68nJYjsWjyrB+Zq/+Lu4itjxYOf0NRd731fquBPADoe6ruDiXwHa RIYeWxiQPJHFg7J3M8rTCmdSZ3aKFrs8FST+W+Pwu7M6W8OvLsTDoT00BUN5P1nTwfyd eC5/bsJobHDa0RPlBpPSTNQaVnOv8OPzDWxovihFoU54PLyPczrEWJ2c1ULXqs1olyHT L+ZEmzPjCsGmlr/zrGRW6kUOHAHp/lODxeCALhZreTW3ELvL+M5q5BSr6K0+wDKpA9pr VYzA== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@suse.cz header.s=susede2_rsa header.b=FEPx1SeA; dkim=neutral (no key) header.i=@gcc.gnu.org; spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org" Received: from sourceware.org (ip-8-43-85-97.sourceware.org. [8.43.85.97]) by mx.google.com with ESMTPS id mp33-20020a1709071b2100b0072a6d845d91si14201734ejc.159.2022.07.25.06.17.41 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 25 Jul 2022 06:17:41 -0700 (PDT) Received-SPF: pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) client-ip=8.43.85.97; Authentication-Results: mx.google.com; dkim=fail header.i=@suse.cz header.s=susede2_rsa header.b=FEPx1SeA; dkim=neutral (no key) header.i=@gcc.gnu.org; spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org" Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 5293238316E6 for ; Mon, 25 Jul 2022 13:15:43 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from smtp-out2.suse.de (smtp-out2.suse.de [IPv6:2001:67c:2178:6::1d]) by sourceware.org (Postfix) with ESMTPS id 966803838206 for ; Mon, 25 Jul 2022 13:15:19 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 966803838206 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=suse.cz Authentication-Results: sourceware.org; spf=fail smtp.mailfrom=suse.cz Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by smtp-out2.suse.de (Postfix) with ESMTPS id D748B1FD38; Mon, 25 Jul 2022 13:15:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1658754918; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: resent-to:resent-cc:resent-from:resent-message-id; bh=Lbalap21C+dT/Ko3o23eJUVuiI9gXuF8GzCN5knjzYc=; b=FEPx1SeAyHEtt3oVugpFNYHDGFQJC3Lx/lKPwmhvQglKpHI01LNZabbIuP5zeEPFaPKhqM MDVKN6CqQlzAsaqdVwQp6KhHVrjZD8i/1gtOD7GNJvfd7Q2D7yjV5KI8/H8TmIpxBQxlQ7 MAtsAuuybV5J5CScQV4Vwr8BxTUGe48= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1658754918; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: resent-to:resent-cc:resent-from:resent-message-id; bh=Lbalap21C+dT/Ko3o23eJUVuiI9gXuF8GzCN5knjzYc=; b=ppPRQR6zU7mwc83y+syEYMRud5L0vKgqcQ92GgrAE9w7l45ZRhGY6+jAghcuRHdZoldraX pj6b26oc/FuejQCA== Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by imap2.suse-dmz.suse.de (Postfix) with ESMTPS id BD6D313B12; Mon, 25 Jul 2022 13:15:18 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id tJT4LGaX3mIPdgAAMHmgww (envelope-from ); Mon, 25 Jul 2022 13:15:18 +0000 Resent-From: =?utf-8?q?Martin_Li=C5=A1ka?= Resent-To: GCC Patches Resent-Cc: David Malcolm Resent-Date: Mon, 25 Jul 2022 15:15:18 +0200 Resent-Message-ID: Message-Id: From: Martin Liska Date: Mon, 25 Jul 2022 15:13:08 +0200 Subject: [PATCH 0/7] jit,docs: remove warnings and modernize the docs To: gcc-patches@gcc.gnu.org X-Spam-Status: No, score=-5.6 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, SPF_HELO_NONE, SPF_SOFTFAIL, TXREP autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org Sender: "Gcc-patches" X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-LABELS: =?utf-8?b?IlxcSW1wb3J0YW50Ig==?= X-GMAIL-THRID: =?utf-8?q?1739330747795757790?= X-GMAIL-MSGID: =?utf-8?q?1739330747795757790?= The patch set modernizes the documentation and removes most of the reported Sphinx warnings. Ready for master? Thanks, Martin Martin Liska (7): jit,docs: use enum directive for enumeral types jit,docs: replace c:type:`int_type` with :expr:`int_type` jit,docs: various fixes jit,docs: compact function declarations jit,docs: use list-table instead of fixed table jit,docs: use :expr:`type *` for pointers to a type jit,docs: remove :ref:`modindex` gcc/jit/docs/conf.py | 3 + gcc/jit/docs/cp/intro/tutorial02.rst | 6 +- gcc/jit/docs/cp/intro/tutorial04.rst | 73 +++++++++----- gcc/jit/docs/cp/topics/asm.rst | 2 +- gcc/jit/docs/cp/topics/contexts.rst | 8 +- gcc/jit/docs/cp/topics/expressions.rst | 52 ++++------ gcc/jit/docs/cp/topics/functions.rst | 48 +++++----- gcc/jit/docs/cp/topics/objects.rst | 2 +- gcc/jit/docs/cp/topics/types.rst | 2 +- gcc/jit/docs/examples/tut04-toyvm/toyvm.c | 1 + gcc/jit/docs/index.rst | 8 -- gcc/jit/docs/intro/tutorial02.rst | 16 ++-- gcc/jit/docs/intro/tutorial03.rst | 28 +++--- gcc/jit/docs/intro/tutorial04.rst | 77 ++++++++++----- gcc/jit/docs/intro/tutorial05.rst | 41 +++++--- gcc/jit/docs/topics/compilation.rst | 38 ++++---- gcc/jit/docs/topics/contexts.rst | 12 +-- gcc/jit/docs/topics/expressions.rst | 111 ++++++++++++++-------- gcc/jit/docs/topics/function-pointers.rst | 2 +- gcc/jit/docs/topics/functions.rst | 2 +- gcc/jit/docs/topics/objects.rst | 6 +- gcc/jit/docs/topics/types.rst | 111 ++++++++++++++-------- 22 files changed, 379 insertions(+), 270 deletions(-)