From patchwork Mon Sep 4 16:17:03 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Peter Maydell X-Patchwork-Id: 719994 Delivered-To: patch@linaro.org Received: by 2002:adf:d08b:0:b0:31d:da82:a3b4 with SMTP id y11csp1687791wrh; Mon, 4 Sep 2023 09:17:20 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFSrx6if80quCQiA8arvof78uiwqF8rPVJaFrl/RzUN8aqkfzaMPnRqelszPJ0G3rIiYUYQ X-Received: by 2002:a05:620a:bd6:b0:76d:a9c3:b160 with SMTP id s22-20020a05620a0bd600b0076da9c3b160mr11778280qki.7.1693844240243; Mon, 04 Sep 2023 09:17:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1693844240; cv=none; d=google.com; s=arc-20160816; b=GeSIqe219TyilC360g1a21VY+2Y1uJpM/iFpmGB/NdyOISAtZDs1eIMsKf9CEVdSd8 yLlz0xmb5xV74tHg05J3zijBdHoAXnSIKxc6PJAOv0YLz4kR8/9ed+xxSMjqmsjX+uK5 PDUb3hLwSIQqgHOEn6WPWle++jKX/4XdJrEeLYyDMGZdVyX8BNtjN3Tq3mX4SsGOrpRv N83vbvzBu8MjBXePeABqD+JLNhxarWMjF1/DLKX66fG/Fs+p2pCl67O1br1xCBp60gQ/ L9Jj5GMnVSwCHVayDHIvb+1dPTyv7cXlRU2IxG8z1YNz991OGSgp4ZZBw+tej/+QvqQh /Weg== 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:message-id:date:subject:to:from:dkim-signature; bh=VjDY4c8F9rfD2zVHTmHxX9NTugubDyKQYFuZQKiivIc=; fh=PnYt+qEB9tAfMKoqBm2xjKOFpYyFFGPudh5cVIoieJM=; b=P+0HmF83ZAmPwLhZ0wggvsWvaBWhQ1UanczYWDEutO6hIs3MBX8I7CUN/+rjKyx/4s mGyNJqCd5kpQ7PPeKazd4zetKfcUho0z8uyCxJAUFfco3jibzX9F1xLN/csfaO5sHog/ KIzZRrTS0/HFTOfFH/sgiV0Mfs/TuGC/ZAgMm9cz10QY0Rtw7FINXh5tuOnV1nD86Yy9 wTOdWYemYv1rDTU6Sz9369Gmua1N6Dv7pgvdozi+vLLEOXt2sQXA1fYNTfr7gVOpd51s xe721gbx9w/rSOuK6HsAu7+oH0jMM6SCm/fTLHm7adjxKJvWcxmdZz4kuk9mQ/cx8IP+ lC+g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=sxhyFC5N; 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 h6-20020a05620a400600b0076da43af035si7235849qko.733.2023.09.04.09.17.20 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Mon, 04 Sep 2023 09:17:20 -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=sxhyFC5N; 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 1qdCGE-0002MU-IE; Mon, 04 Sep 2023 12:17:10 -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 1qdCGC-000258-Sj for qemu-devel@nongnu.org; Mon, 04 Sep 2023 12:17:08 -0400 Received: from mail-wr1-x435.google.com ([2a00:1450:4864:20::435]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qdCGA-0008Nv-AX for qemu-devel@nongnu.org; Mon, 04 Sep 2023 12:17:08 -0400 Received: by mail-wr1-x435.google.com with SMTP id ffacd0b85a97d-307d58b3efbso1244883f8f.0 for ; Mon, 04 Sep 2023 09:17:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1693844224; x=1694449024; darn=nongnu.org; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:from:to:cc:subject:date:message-id:reply-to; bh=VjDY4c8F9rfD2zVHTmHxX9NTugubDyKQYFuZQKiivIc=; b=sxhyFC5NySMRT0YUcoPAOoAJL7PQzm79ahQKRuXiyWmQ1wERSr7XMp2FkwRRMvVjyT shF8t8PFXsZ4abFQa01WrcKkqMHCUjtt23dwkmzswuGvDrL4RpxvBYSsuSELPWmgXrcf qaW4NRGUIi22vsw58z2Z526sjU2IFwJ2HKWVXm0lY/ArUZVx1ZMg0aIUVyCWFfBwaCjK M+305ax7W1B+1AbLjBm9X07QvabzhGEhYACRIHboEs/wtww75DAAZa8wGcxW5AUZxnn2 36QDmK7PaiAZdzO6xPAZ2jLwMTIjWR+r+f8P2FHphMpzEbI1DLQuAg3J8O0g4VQiHSiF JVJw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1693844224; x=1694449024; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=VjDY4c8F9rfD2zVHTmHxX9NTugubDyKQYFuZQKiivIc=; b=AmCepfCZbl5lQI7OmwVmR4uKuUY56K3/TDcFXmFeJFxixcer9RASx1RnKWIRD9xXcu Lio9+YSEIC09PXA3gDF8pFeANKJjTBAUuePkM1OAAo1kKawL/7mKri87LMOr37FdI4BB mMblNGNfZ1doSfqJa4aJ+MjZSv7lxKSNVGQWynAIgqPbQnfu1MzEMWGNLiu034s2dzmT 8biKmcQ4OXjRv0iHnFVB0vAqzB9G2ctsF2xMMzi81+n6CCcCjPwoktzcoYkgg5g9YB0r gWrVurNRgwnignRcyJM3IojRORNBqQnq72resROUBpTo1Abbuz6Q3MEhvAAiIjjqgAxo hswg== X-Gm-Message-State: AOJu0YxhGe9hWLcrlvtkjN2pfc6dWjO19tzlDUwAVpADwu6yxI3YRBLU m25bveIp+9qDF+QICqLpBEmK/tOIOWRCDHGovY8= X-Received: by 2002:adf:ebcd:0:b0:313:eaf5:515 with SMTP id v13-20020adfebcd000000b00313eaf50515mr7184092wrn.6.1693844224240; Mon, 04 Sep 2023 09:17:04 -0700 (PDT) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [2001:8b0:1d0::2]) by smtp.gmail.com with ESMTPSA id y13-20020adffa4d000000b00317df42e91dsm15022776wrr.4.2023.09.04.09.17.03 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 04 Sep 2023 09:17:04 -0700 (PDT) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [PATCH] docs/devel/loads-stores: Fix git grep regexes Date: Mon, 4 Sep 2023 17:17:03 +0100 Message-Id: <20230904161703.3996734-1-peter.maydell@linaro.org> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Received-SPF: pass client-ip=2a00:1450:4864:20::435; envelope-from=peter.maydell@linaro.org; helo=mail-wr1-x435.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 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 The loads-and-stores documentation includes git grep regexes to find occurrences of the various functions. Some of these regexes have errors, typically failing to escape the '?', '(' and ')' when they should be metacharacters (since these are POSIX basic REs). We also weren't consistent about whether to have a ':' on the end of the line introducing the list of regexes in each section. Fix the errors. The following shell rune will complain about any REs in the file which don't have any matches in the codebase: for re in $(sed -ne 's/ - ``\(\\<.*\)``/\1/p' docs/devel/loads-stores.rst); do git grep -q "$re" || echo "no matches for re $re"; done Signed-off-by: Peter Maydell Reviewed-by: Philippe Mathieu-Daudé --- docs/devel/loads-stores.rst | 40 ++++++++++++++++++------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/devel/loads-stores.rst b/docs/devel/loads-stores.rst index dab6dfa0acc..ec627aa9c06 100644 --- a/docs/devel/loads-stores.rst +++ b/docs/devel/loads-stores.rst @@ -63,12 +63,12 @@ which stores ``val`` to ``ptr`` as an ``{endian}`` order value of size ``sz`` bytes. -Regexes for git grep +Regexes for git grep: - ``\`` - ``\`` - ``\`` - - ``\`` - - ``\`` + - ``\`` + - ``\`` ``cpu_{ld,st}*_mmu`` ~~~~~~~~~~~~~~~~~~~~ @@ -121,8 +121,8 @@ store: ``cpu_st{size}{end}_mmu(env, ptr, val, oi, retaddr)`` - ``_le`` : little endian Regexes for git grep: - - ``\`` - - ``\`` + - ``\`` + - ``\`` ``cpu_{ld,st}*_mmuidx_ra`` @@ -155,8 +155,8 @@ store: ``cpu_st{size}{end}_mmuidx_ra(env, ptr, val, mmuidx, retaddr)`` - ``_le`` : little endian Regexes for git grep: - - ``\`` - - ``\`` + - ``\`` + - ``\`` ``cpu_{ld,st}*_data_ra`` ~~~~~~~~~~~~~~~~~~~~~~~~ @@ -193,8 +193,8 @@ store: ``cpu_st{size}{end}_data_ra(env, ptr, val, ra)`` - ``_le`` : little endian Regexes for git grep: - - ``\`` - - ``\`` + - ``\`` + - ``\`` ``cpu_{ld,st}*_data`` ~~~~~~~~~~~~~~~~~~~~~ @@ -231,9 +231,9 @@ store: ``cpu_st{size}{end}_data(env, ptr, val)`` - ``_be`` : big endian - ``_le`` : little endian -Regexes for git grep - - ``\`` - - ``\`` +Regexes for git grep: + - ``\`` + - ``\`` ``cpu_ld*_code`` ~~~~~~~~~~~~~~~~ @@ -296,7 +296,7 @@ swap: ``translator_ld{sign}{size}_swap(env, ptr, swap)`` - ``l`` : 32 bits - ``q`` : 64 bits -Regexes for git grep +Regexes for git grep: - ``\`` ``helper_{ld,st}*_mmu`` @@ -325,7 +325,7 @@ store: ``helper_{size}_mmu(env, addr, val, opindex, retaddr)`` - ``l`` : 32 bits - ``q`` : 64 bits -Regexes for git grep +Regexes for git grep: - ``\`` - ``\`` @@ -382,7 +382,7 @@ succeeded using a MemTxResult return code. The ``_{endian}`` suffix is omitted for byte accesses. -Regexes for git grep +Regexes for git grep: - ``\`` - ``\`` - ``\`` @@ -400,7 +400,7 @@ Note that portions of the write which attempt to write data to a device will be silently ignored -- only real RAM and ROM will be written to. -Regexes for git grep +Regexes for git grep: - ``address_space_write_rom`` ``{ld,st}*_phys`` @@ -438,7 +438,7 @@ device doing the access has no way to report such an error. The ``_{endian}_`` infix is omitted for byte accesses. -Regexes for git grep +Regexes for git grep: - ``\`` - ``\`` @@ -462,7 +462,7 @@ For new code they are better avoided: ``cpu_physical_memory_rw`` -Regexes for git grep +Regexes for git grep: - ``\`` ``cpu_memory_rw_debug`` @@ -497,7 +497,7 @@ make sure our existing code is doing things correctly. ``dma_memory_rw`` -Regexes for git grep +Regexes for git grep: - ``\`` - ``\`` - ``\`` @@ -538,7 +538,7 @@ correct address space for that device. The ``_{endian}_`` infix is omitted for byte accesses. -Regexes for git grep +Regexes for git grep: - ``\`` - ``\`` - ``\``