From nobody Mon Feb 9 02:15:12 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=treblig.org ARC-Seal: i=1; a=rsa-sha256; t=1768524740; cv=none; d=zohomail.com; s=zohoarc; b=Rf8QNRYtV3/QvLpCaEhM6Xs05EBC6zMR2k/6aW29kyqlbdDNxRVm8XGECKZlWR+0bo4GkxI9jiMHwaWVhkwVaeg4EOaYk8M7hsUrihcQGLMlZTBU+O2jbVcG4PrSBMKGifE6gk6p/X/1FekTOxdOaC8aMGMP1EGMunk6XGSzuGw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1768524740; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=E2mXrTWQiOztBEj6wySA6rn8mt3kagBW5G9HJyHhrOU=; b=JYRb0p4/XVX+iYom3qcdxEpnKBZPMzktd/YVf5qlu/yIh43YzxGzxc4sE2Nl+2SgPhFELVHmaqkgXVAKRNDlHJR1j7JDvAvt1lj9htn/18El8/wLr+DFSDOcWMvM7ktdOSSu6Be8N7t5xDaXxzwWqT0sMsjYXXzqlzoyrmKhslQ= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1768524740738110.40105736864075; Thu, 15 Jan 2026 16:52:20 -0800 (PST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1vgY47-00063k-2r; Thu, 15 Jan 2026 19:51:51 -0500 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 1vgY3z-0005wL-7l for qemu-devel@nongnu.org; Thu, 15 Jan 2026 19:51:44 -0500 Received: from mx.treblig.org ([2a00:1098:5b::1]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1vgY3u-0000qn-S2 for qemu-devel@nongnu.org; Thu, 15 Jan 2026 19:51:41 -0500 Received: from localhost ([127.0.0.1] helo=dalek) by mx.treblig.org with esmtp (Exim 4.98.2) (envelope-from ) id 1vgY3t-0000000F7wG-13Zw; Fri, 16 Jan 2026 00:51:37 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=treblig.org ; s=bytemarkmx; h=MIME-Version:Message-ID:Date:Subject:From:Content-Type:From :Subject; bh=E2mXrTWQiOztBEj6wySA6rn8mt3kagBW5G9HJyHhrOU=; b=cbfTYx79baCyMNgx +LmhZNfFSrg9PeqSHZi7EhkAiYdx8AYNMrIKtFvBUcbN79W8KtmU2qWxxQuRUrbyr81L/MFqznk1O W2pB01AfzmMPsYpDKG35elqsmbdqxWNpE/JG6p+1peqgwfQPitB142d5pHKQxDbZutISJhU4fxNfZ 77xsrWuaIu+jT0t6O1Iz0jL33tcF0wcxvjeE/fGTmsGRM9KuvLPoid4Ha2LG3WPHu7R85Q18QiUhv qg279PeZOUotnjMWRLUg/BMiad4rMTgL7mKhMh9Q1gwmvrOOt5+NixlPKe73ljXkaKtGrQVgemwGR TwH2zPrCew76+6LN7A==; From: dave@treblig.org To: dave@treblig.org, armbru@redhat.com, berrange@redhat.com, marcandre.lureau@redhat.com Cc: qemu-devel@nongnu.org Subject: [PATCH v2 4/4] hxtool: Error on missing docs Date: Fri, 16 Jan 2026 00:50:48 +0000 Message-ID: <20260116005050.376616-5-dave@treblig.org> X-Mailer: git-send-email 2.52.0 In-Reply-To: <20260116005050.376616-1-dave@treblig.org> References: <20260116005050.376616-1-dave@treblig.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1098:5b::1; envelope-from=dave@treblig.org; helo=mx.treblig.org 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, 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: qemu development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @treblig.org) X-ZM-MESSAGEID: 1768524741231158500 Content-Type: text/plain; charset="utf-8" From: "Dr. David Alan Gilbert" Error if a '.name' is seen after another '.name' without an intervening SRST, this normally indicates missing or misplaced docs. We can't check DEF (as used in command line options) because those often have multiple DEF per doc. Signed-off-by: Dr. David Alan Gilbert Reviewed-by: Markus Armbruster --- scripts/hxtool | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/scripts/hxtool b/scripts/hxtool index 51dc841479..ee98fb9c09 100755 --- a/scripts/hxtool +++ b/scripts/hxtool @@ -1,8 +1,14 @@ #!/bin/sh =20 +print_if_not_rst() +{ + test $in_rst -eq 0 && printf "%s\n" "$str" +} hxtoh() { in_rst=3D0 + # .name for HMP + seen_name=3D0 while read -r str; do case $str in HXCOMM*) @@ -13,6 +19,8 @@ hxtoh() echo "Error: SRST inside another RST" >&2 exit 1 fi + # consume the name + seen_name=3D0 in_rst=3D1 ;; ERST*) @@ -23,6 +31,16 @@ hxtoh() fi in_rst=3D0 ;; + # Note the space at the start - we need to exclude something.n= ame + ( .name*) + if [ $seen_name -eq 1 ] + then + echo "Error: Seen another .name, maybe missing docs?" >&2 + exit 1 + fi + seen_name=3D1 + print_if_not_rst + ;; *) test $in_rst -eq 0 && printf "%s\n" "$str" ;; --=20 2.52.0