From nobody Thu May 21 07:09:58 2026 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4gLfgH6jhkz6fZDc for ; Thu, 21 May 2026 07:10:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R13" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gLfgH65spz3G68 for ; Thu, 21 May 2026 07:10:03 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1779347403; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=dzVA4y+hgFPVLz+N2zt74oz4cuJnG3S82YcHKc2jkJ8=; b=oA6+WUTaz39bmSVamMSReMskRQIesEsP07QQi1MGbObu0BuwXiay0H03x6Ck9+yOUngK2c ChXQs0klbtbFG2FWOI3Ah0C5Kz0wHPwU64iL0H+OOeF3vBZu+jfVgoniIS0XLLRrZy04fr S08eoTc1CPYkQElV3kibV6/998C3z6umQtCVekwWEnnUzzdrnbj4k0i1K3CSD7rJ856tAI kSw5p/CUKu7goBKkpOeyrcigr4I0LJ/aMHxqBod1kRvvUU+HtzEtPtRY8FEizE+X7DGWXy /gBqArtVZNzORKLfF20ZsWqF9xwO9oqDZbjrLXeJB9aR7Ns7qVVcjiqZQ7ACaw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1779347403; a=rsa-sha256; cv=none; b=kKF8yR6iJ3djax6qEVeQHNbH/da/DCOSB/IA9fAk9lJRkR7k63EnGWfcRFNZQLB1FcgeTN P77Ez8qi1go230fme9DnSUuk8Q6Op7EgUa7dSuhsEc8LMKFtT5Ww9td8QfEI4g9Qv+9yZn WSCfbWUF7uvH35CLSQ7c6879gGqyeL1lx53x2RAp0QIFc5kp/IbL5uRam79NN0dI52WD8K 1dweD3GuBBp/L2FPwQbgzuoS4tnFLy5C9qI2YZglKQSh2u21wjUogEoio5PLFGTa8T8FJJ 0cRm/0txzcrA68Gy+jSdtDZTC9ULRlI3bT0aZkiWfjRwu1zoou8KhkxJcfM1nw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1779347403; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=dzVA4y+hgFPVLz+N2zt74oz4cuJnG3S82YcHKc2jkJ8=; b=SWqNBLKiC3ReE9jRtsiAVU49XA8Be3JSF1dyYqKHKpCPIhf/m3eLSXp5caoaOrW2AfbGUR drDh33KoDYrElo9/oP0uXLPB9VrNjWao9TNc+S00FAElc4y/b7w/38gpOQUrUxE4CND8HQ W8TAOLUWjndIo268KgXR0OoWiCcVw9Ypq9plGhj9BMwC52RGJXroBuu8DIdNgExAVcCiog OsVSpp+of0sd2JV8Tv8LXAlkx/paQBv1R4NkD3cYwYhE7L2YG09ifJQ9fa7A6UZoRrJsT8 AghSBc+8M55wgZlleKdurP5+/+3skDYl98zg0/WwfJodsf/2JYVvNSyNzSWSfg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gLfgH5D77z64B for ; Thu, 21 May 2026 07:10:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 3a329 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 21 May 2026 07:09:58 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Vladlen Popolitov Subject: git: 040006ae08 - main - website: improve hardware-notes-processor.rb List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: vladlen X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 040006ae086d3edd3e57cf21477323a6ef6a2365 Auto-Submitted: auto-generated Date: Thu, 21 May 2026 07:09:58 +0000 Message-Id: <6a0eafc6.3a329.17fbcc02@gitrepo.freebsd.org> The branch main has been updated by vladlen: URL: https://cgit.FreeBSD.org/doc/commit/?id=040006ae086d3edd3e57cf21477323a6ef6a2365 commit 040006ae086d3edd3e57cf21477323a6ef6a2365 Author: Vladlen Popolitov AuthorDate: 2026-05-21 07:09:49 +0000 Commit: Vladlen Popolitov CommitDate: 2026-05-21 07:09:49 +0000 website: improve hardware-notes-processor.rb fixes mandoc generation of left bracket adds messages, when HARDWARE section is absent or empty remains hwlist macro in hardware.adoc for next cycles hwlist macro has warning message text in the same line Reviewed by: carlavilla Approved by: carlavilla Differential Revision: https://reviews.freebsd.org/D57133 --- website/tools/hardware-notes-processor.rb | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/website/tools/hardware-notes-processor.rb b/website/tools/hardware-notes-processor.rb index 9532b54180..1974bf2aea 100644 --- a/website/tools/hardware-notes-processor.rb +++ b/website/tools/hardware-notes-processor.rb @@ -23,14 +23,16 @@ hardwareNotesContent = "" File.foreach(hardwareNotesPath).with_index do |line| if (line[/&hwlist.\b/]) - manualPage = line.gsub("&hwlist.", "").gsub(";", "").gsub("\n", "") + macro = line.match(/&hwlist\.[^\s;]+;?/)[0] + manualPage = macro.gsub("&hwlist.", "").gsub(";", "").gsub("\n", "") if(File.exist?("tmp/share/man/man4/" + manualPage + ".4")) cmd = "mandoc -Tmarkdown tmp/share/man/man4/" + manualPage + ".4 | sed -n '/^# HARDWARE/,/^# /{ /^# /d; p; }'" mandocOut, err, s = Open3::capture3(cmd) if s.success? - #replace \_ to _ in drivers name and description + #replace \_ to _ and \[ to [ in drivers name and description mandocOut.gsub!(/\\_/, '_') + mandocOut.gsub!(/\\\[/, '[') # extract Nm (real driver name) nm_cmd = "grep -m1 '^\\.Nm' tmp/share/man/man4/#{manualPage}.4" @@ -56,10 +58,20 @@ File.foreach(hardwareNotesPath).with_index do |line| end end + if mandocOut.strip.empty? + puts "WARNING: No HARDWARE section content for manual page #{manualPage}" + hardwareNotesContent << "#{macro} WARNING: No HARDWARE section content for manual page #{manualPage}\n" + next + end + hardwareNotesContent << mandocOut + else + puts "WARNING: The manual page " + manualPage + " without HARDWARE exists or malformed" + hardwareNotesContent << "#{macro} WARNING: The manual page " + manualPage + " without HARDWARE exists or malformed\n" end else puts "WARNING: The manual page " + manualPage + " does not exists" + hardwareNotesContent << "#{macro} WARNING: The manual page " + manualPage + " does not exists\n" end else hardwareNotesContent << line