From nobody Tue Feb 10 01:31:39 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=1768442745; cv=none; d=zohomail.com; s=zohoarc; b=EyLASkI5zIZj4bdYHD97Z69c40hWN3GKp2/USkbLytkK+bWHdCVJR/xwVMg81f3bQPjX+nS5q0TIGPuYOlPJ34tDviFD4DxfUi/Dp6h+7BnAH140oCsXrMGZT60MMYeHelVmBi5rAa11F/vRrj1XtxAPaYUmqwR20YN/tZU8T5g= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1768442745; 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=pVf4Nq5yyOaiSh5/d48eFUOJ2zNDs9ZI9Zq2WaZY3k0=; b=jW7ZMHQssGr1h1ooHdHGFmWfk75HYv9uE5/x+hRCLSa6RTaD1j+PF7m5BfAoKkQW+tFd02FEldEhIgBU72tOVwv1qm2UBGJsEQas8TOTEYQCGGTxCOOW7NibOOBLckAdB08L1e1/khnFMiasEUbbE65P8sMPOgS3DKTsS5I3QKw= 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 1768442745651459.1939255564894; Wed, 14 Jan 2026 18:05:45 -0800 (PST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1vgCj1-00018w-FA; Wed, 14 Jan 2026 21:04:39 -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 1vgCiz-00017w-6d for qemu-devel@nongnu.org; Wed, 14 Jan 2026 21:04:37 -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 1vgCiw-0001iR-Gs for qemu-devel@nongnu.org; Wed, 14 Jan 2026 21:04:36 -0500 Received: from localhost ([127.0.0.1] helo=dalek) by mx.treblig.org with esmtp (Exim 4.98.2) (envelope-from ) id 1vgCiu-0000000Eq8W-16bK; Thu, 15 Jan 2026 02:04:32 +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=pVf4Nq5yyOaiSh5/d48eFUOJ2zNDs9ZI9Zq2WaZY3k0=; b=eGmluPZOfSr2roMY DzCNXFes9AHpJly7PAYePIihsYP1DpQWOw6qxsh/YQqOZ8wdTuCBFT3g/KDDVuVI0REnL9xOqijOg gk9zkaIuvISQVdM16dnRdOCcHX19KShuPIGNS1LYXa62O1seCJCsxbOqPx6AaSrmzZ/tFHjUMN9Vz 53JS4fmsS06bDtfCNy1gO8orI8g8pi7rVUwuoLqWLV6A/6OpydtxxPpiHyy7mXmZvz9fNhW4lv5Ja Vpf8aA9JdjY5oAd8s9ZY9BBGg6UrCSBSj7dbsUNVCLT22hZGx1VGizDMRB50SwaRUuHsrCZib2iQD 7iCXP8mXVYVzm+wAsQ==; From: dave@treblig.org To: dave@treblig.org, armbru@redhat.com, berrange@redhat.com Cc: qemu-devel@nongnu.org Subject: [PATCH 4/4] hxtool: Error on missing docs Date: Thu, 15 Jan 2026 02:04:23 +0000 Message-ID: <20260115020423.722069-5-dave@treblig.org> X-Mailer: git-send-email 2.52.0 In-Reply-To: <20260115020423.722069-1-dave@treblig.org> References: <20260115020423.722069-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: 1768442747911158500 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 --- scripts/hxtool | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/scripts/hxtool b/scripts/hxtool index ea2accef98..f310071daa 100755 --- a/scripts/hxtool +++ b/scripts/hxtool @@ -1,8 +1,14 @@ #!/bin/sh =20 +printifnotrst() +{ + test $outsiderst -eq 1 && printf "%s\n" "$str" +} hxtoh() { outsiderst=3D1 + # .name for HMP + seenname=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 + seenname=3D0 outsiderst=3D0 ;; ERST*) @@ -23,8 +31,18 @@ hxtoh() fi outsiderst=3D1 ;; + # Note the space at the start - we need to exclude something.n= ame + .name*) + if [ $seenname -eq 1 ] + then + echo "Error: Seen another .name, maybe missing docs?" >&2 + exit 1 + fi + seenname=3D1 + printifnotrst + ;; *) - test $outsiderst -eq 1 && printf "%s\n" "$str" + printifnotrst ;; esac done --=20 2.52.0