From 2dc56719955816b16d7e7065bc044e35b6925e2f Mon Sep 17 00:00:00 2001 From: Sylwester Lachiewicz Date: Mon, 10 Aug 2026 02:43:59 +0200 Subject: [PATCH] Keep the FAQ quotation marks straight MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The FML page rendered straight quotation marks, being XML. In Markdown flexmark's smart-punctuation rewrites a bare " into a typographic pair, so the converted page changed what the reader sees: "gpg: signing failed: No pinentry" -> “gpg: signing failed: No pinentry” That matters here because both quoted strings are things a reader copies: one is the literal error message people search for, the other a mode name. Writing " in the source keeps them straight, which is the convention the already-converted pages in maven-site-plugin use. Verified by rebuilding the site and comparing against the FML rendering: the quotation marks match the original again, and no anchor changed. Generated-by: Claude Opus 5 (1M context) --- src/site/markdown/faq.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/site/markdown/faq.md b/src/site/markdown/faq.md index 25dd33f..e22913f 100644 --- a/src/site/markdown/faq.md +++ b/src/site/markdown/faq.md @@ -27,7 +27,7 @@ under the License. 1. [What is GnuPG?](#question1) 2. [Why is the site descriptor not signed?](#site-descriptor) -3. [Why am I getting "gpg: signing failed: No pinentry" while releasing?](#no-pinentry) +3. [Why am I getting "gpg: signing failed: No pinentry" while releasing?](#no-pinentry) @@ -46,10 +46,10 @@ Maven Site Plugin 2.1.1+ which contains the required fix (see also -### Why am I getting "gpg: signing failed: No pinentry" while releasing? +### Why am I getting "gpg: signing failed: No pinentry" while releasing? When plugin used in combination with [Maven Release Plugin](https://maven.apache.org/maven-release/maven-release-plugin/) the GPG signing will -happen in "batch mode". This implies that you must either use GPG passphrase passed in via environment +happen in "batch mode". This implies that you must either use GPG passphrase passed in via environment variable (preferred on systems like CI systems are), or, if on Workstation, using primed gpg-agent is needed. Read more here about [GPG Agent priming](passphrase.html#Retrieve_passphrase_via_gpg-agent).