From patchwork Fri May 12 15:34:18 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Maydell X-Patchwork-Id: 681191 Delivered-To: patch@linaro.org Received: by 2002:a5d:4a41:0:0:0:0:0 with SMTP id v1csp4021854wrs; Fri, 12 May 2023 08:35:42 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ5DOui6wsjrDB/QexH9qbYYpiOrcFoiTRUImLrPLmQj7dyZFxrS+HLYI0NbeXSB3VnhJ/7i X-Received: by 2002:a05:6102:e4e:b0:436:1126:c99f with SMTP id p14-20020a0561020e4e00b004361126c99fmr6288306vst.17.1683905741910; Fri, 12 May 2023 08:35:41 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1683905741; cv=none; d=google.com; s=arc-20160816; b=MxPMzNB5xDZmA1NjCYU5LT97puHqJ9eVSrDXgobTc2MfvUObgUP/VeqGKgjrnd5qeo dzkvGLUcrpG7PeBmEudakIdYMmZ1kVFYKFTaGTdsEJf+6aPh/6VTacHhInpCe3stInvp 2+q1VYjXenA0XowSWCAiXnTfQJ4U5DrUEA0C/bK7QUzEOvSgBEfGBbkfAq6MKi7ClIh5 SvP74Z8E7lxoA4FWYTW5fQgLF/CxLBsX5qmWXoiz99UaymJQtw0g9lzw8p029aFFdrLp 7r8DLojP43PDkjOiTs66VnUGdABwfdJhdnY9UGV17HMJiR6NzBT0R514iA89W6PBqb+4 8eJw== 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:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:to:from :dkim-signature; bh=TwjdV0u7g7SQc0AXDs6qHHfGv0SY+yIqn/gwE95FkUs=; b=YvW6jJYUNlg+ygqV3+YRvYUfvcfXYk2/mrKxz0Tk7f5Tz1cW9tUBYlJpc+8b3JEM+E aUVBbAoumRxWaQx/rPVLS11yjNMlzL9T1tWPJ/QV8iqbvuYLXlrzH+Z/qtvJeL0ubaOQ xzCoeX9w3b0Re3UM3gbjg+UTnPd6IPb0nODbtr++kAZUewJZ/Y4TdQ7buo49LMPA8SwO pYkCPAa2tg+YbhLiZAguu9HqEa33UcXPPT+7Gt/B53oGeFhMI5fO/va865lCMf3diVzH g/jlFKCcd6lcuApheyODdlH+czBaGZIkoH5ZoHOtO5ghpDOIUN1phDylLsNvkn5x25a4 WpWA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=OZte7KFP; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from lists.gnu.org (lists.gnu.org. [209.51.188.17]) by mx.google.com with ESMTPS id v10-20020ae9e30a000000b007467e5a4190si2316791qkf.105.2023.05.12.08.35.41 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Fri, 12 May 2023 08:35:41 -0700 (PDT) Received-SPF: pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=OZte7KFP; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pxUmz-0003Jh-47; Fri, 12 May 2023 11:34:37 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pxUmw-0003IC-Op for qemu-devel@nongnu.org; Fri, 12 May 2023 11:34:34 -0400 Received: from mail-wm1-x334.google.com ([2a00:1450:4864:20::334]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pxUms-000607-4V for qemu-devel@nongnu.org; Fri, 12 May 2023 11:34:33 -0400 Received: by mail-wm1-x334.google.com with SMTP id 5b1f17b1804b1-3f315735514so326652955e9.1 for ; Fri, 12 May 2023 08:34:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1683905669; x=1686497669; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=TwjdV0u7g7SQc0AXDs6qHHfGv0SY+yIqn/gwE95FkUs=; b=OZte7KFPN8AM2OsbImCZjVxCd8WI5nuvf3OGQXpgkykpMQnoMEbTNjRiTwWsigt1DJ usPrmHufP4wMTdZj03zVESbq8/oiSsnyt6k9r9NA1g1Mjt6WLnwQZFLbEF99GswBBDnM T8bZBjRbBrMhJG6abGO1gwbuoEh/1X2k/AUm/wkdUkrBWLsmrudtCpESDqdRGlM39TOm 9mAs1wqiyvTtQjXP5wYQ24mPIIOlPWyETk5fPzhInVTDO77JOl3nsiSsxoTxPx/qjvf3 fvpINskbSzMyW/dTTdI5W4TFUGcP1l1IQsnAZeyRhIfWsQACtmN+tg2ImK1LZL+rXgKB otTw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1683905669; x=1686497669; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=TwjdV0u7g7SQc0AXDs6qHHfGv0SY+yIqn/gwE95FkUs=; b=WuvsrkL3WbGOblpnmAFUg3CKWHslB1EItvmtnZhwgKlzaaay3BwM8LIhOtf7MIFTG4 IhB7bmxSSc35MEJQBDwTqPKR2goSVy4uMCnD9Yc0SuFl8zKkyaxWdteUpcFBfn5aWP4x NhD1ADLyrUtuhqQVjMrX78HCzkLZLYjg1g8V/Xc7vDeznPeQDl4+m8zqumRwEr7bXRpm b/1FxZctK5b7SkZLsQJfWZdvY3a0W4NO+ojb3J3JiNQLfCqXDgO7X8W0oS/ft+wTgcAM qEMi5DbiWiwVEDTSRjjf3X8YmiECO6ktsPghxqTEQ8J5jovhbPAtXaHYOohQ3goZFfTD biyA== X-Gm-Message-State: AC+VfDyUccRsSvIiNkmYqhk5/EfRlx2cNKPapUN+etz49kFs31EmxhUr 424ZNUniYLbErTahn2uXUP4HdqKk81zVaaHQ/sU= X-Received: by 2002:adf:dfc7:0:b0:307:c0c4:1094 with SMTP id q7-20020adfdfc7000000b00307c0c41094mr6145760wrn.34.1683905669313; Fri, 12 May 2023 08:34:29 -0700 (PDT) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [2001:8b0:1d0::2]) by smtp.gmail.com with ESMTPSA id b6-20020adfee86000000b002feea065cc9sm11721297wro.111.2023.05.12.08.34.29 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 May 2023 08:34:29 -0700 (PDT) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [PULL 07/12] docs: Remove unused weirdly-named cross-reference targets Date: Fri, 12 May 2023 16:34:18 +0100 Message-Id: <20230512153423.3704893-8-peter.maydell@linaro.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230512153423.3704893-1-peter.maydell@linaro.org> References: <20230512153423.3704893-1-peter.maydell@linaro.org> MIME-Version: 1.0 Received-SPF: pass client-ip=2a00:1450:4864:20::334; envelope-from=peter.maydell@linaro.org; helo=mail-wm1-x334.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+patch=linaro.org@nongnu.org Sender: qemu-devel-bounces+patch=linaro.org@nongnu.org In the doc sources, we have a few cross-reference targets with odd names "pcsys_005fxyz". These are the legacy of the semi-automated conversion of the old info docs to rST (the '005f' is because ASCII 0x5f is '_' and the old info link names had underscores in them). Remove the targets which nothing links to, and rename the two targets which are used to something a bit more descriptive. Signed-off-by: Peter Maydell Message-id: 20230421163642.1151904-1-peter.maydell@linaro.org Reviewed-by: Markus Armbruster --- docs/system/devices/igb.rst | 2 +- docs/system/devices/ivshmem.rst | 2 -- docs/system/devices/net.rst | 2 +- docs/system/devices/usb.rst | 2 -- docs/system/keys.rst | 2 +- docs/system/linuxboot.rst | 2 +- docs/system/target-i386.rst | 4 ---- 7 files changed, 4 insertions(+), 12 deletions(-) diff --git a/docs/system/devices/igb.rst b/docs/system/devices/igb.rst index 70edadd5743..0bcdd857473 100644 --- a/docs/system/devices/igb.rst +++ b/docs/system/devices/igb.rst @@ -29,7 +29,7 @@ Using igb ========= Using igb should be nothing different from using another network device. See -:ref:`pcsys_005fnetwork` in general. +:ref:`Network_emulation` in general. However, you may also need to perform additional steps to activate SR-IOV feature on your guest. For Linux, refer to [4]_. diff --git a/docs/system/devices/ivshmem.rst b/docs/system/devices/ivshmem.rst index b03a48afa3a..e7aaf34c200 100644 --- a/docs/system/devices/ivshmem.rst +++ b/docs/system/devices/ivshmem.rst @@ -1,5 +1,3 @@ -.. _pcsys_005fivshmem: - Inter-VM Shared Memory device ----------------------------- diff --git a/docs/system/devices/net.rst b/docs/system/devices/net.rst index 4b2640c448e..2ab516d4b09 100644 --- a/docs/system/devices/net.rst +++ b/docs/system/devices/net.rst @@ -1,4 +1,4 @@ -.. _pcsys_005fnetwork: +.. _Network_Emulation: Network emulation ----------------- diff --git a/docs/system/devices/usb.rst b/docs/system/devices/usb.rst index 37cb9b33aea..74166810731 100644 --- a/docs/system/devices/usb.rst +++ b/docs/system/devices/usb.rst @@ -1,5 +1,3 @@ -.. _pcsys_005fusb: - USB emulation ------------- diff --git a/docs/system/keys.rst b/docs/system/keys.rst index e596ae6c4e7..0fc17b994d3 100644 --- a/docs/system/keys.rst +++ b/docs/system/keys.rst @@ -1,4 +1,4 @@ -.. _pcsys_005fkeys: +.. _GUI_keys: Keys in the graphical frontends ------------------------------- diff --git a/docs/system/linuxboot.rst b/docs/system/linuxboot.rst index 228650abc5e..5db2e560dc5 100644 --- a/docs/system/linuxboot.rst +++ b/docs/system/linuxboot.rst @@ -27,4 +27,4 @@ virtual serial port and the QEMU monitor to the console with the -append "root=/dev/hda console=ttyS0" -nographic Use Ctrl-a c to switch between the serial console and the monitor (see -:ref:`pcsys_005fkeys`). +:ref:`GUI_keys`). diff --git a/docs/system/target-i386.rst b/docs/system/target-i386.rst index 77c2f3b9799..1b8a1f248ab 100644 --- a/docs/system/target-i386.rst +++ b/docs/system/target-i386.rst @@ -3,8 +3,6 @@ x86 System emulator ------------------- -.. _pcsys_005fdevices: - Board-specific documentation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -32,8 +30,6 @@ Architectural features i386/sgx i386/amd-memory-encryption -.. _pcsys_005freq: - OS requirements ~~~~~~~~~~~~~~~