From 9364d25af7d8f8d00e077a29310b047b8c4b4336 Mon Sep 17 00:00:00 2001 From: Jeremy Sowden Date: Sun, 9 Mar 2025 21:25:55 +0000 Subject: [PATCH 1/2] man: fix some single-quoted strings Commit 721aadc140f2 ("man: change quoting style") replaced single-quoted strings of the form: 'lorem ipsum' with: `lorem ipsum' to prevent the possibility of single quotes appearing at the beginning of lines, because these will be misinterpreted by troff. However, changes to the man-page sources in 1.12.9 reintroduced some of these, including one which does appear at the beginning of a line in mu-query(7): '"', '*', '(' and ')'. The details are shell-specific. In case of doubt, the which results in the following warning: troff::25: warning: macro '"',' not defined and the omission of that line from the rendered paragraph: NOTE: if you use queries on the command-line (say, for mu find), you need to quote any characters that would otherwise be interpreted by the shell, such as *--analyze option can be useful. Use back-ticks for the opening quotes. Fixes: 5e2b7d52b24d ("mu-query.7: update documentation") Signed-off-by: Jeremy Sowden --- man/mu-query.7.org | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/man/mu-query.7.org b/man/mu-query.7.org index 694a56ebd..d9c380ebe 100644 --- a/man/mu-query.7.org +++ b/man/mu-query.7.org @@ -23,7 +23,7 @@ See the *ANALYZING QUERIES* section for further details. *NOTE:* if you use queries on the command-line (say, for *mu find*), you need to quote any characters that would otherwise be interpreted by the shell, such as -'"', '*', '(' and ')'. The details are shell-specific. In case of doubt, the +`"', `*', `(' and `)'. The details are shell-specific. In case of doubt, the *--analyze* option can be useful. * TERMS @@ -136,7 +136,7 @@ $ mu find "hello*" #+end_example Quoting the "hello*" is recommended; some shells (but not all) would otherwise -expand the '*' to all files in the current directory. +expand the `*' to all files in the current directory. * REGULAR EXPRESSIONS @@ -165,7 +165,7 @@ whitespace, so the search for a message with subject "hello world", you can writ #+begin_example mu find 'subject:/hello\\040world/' #+end_example -(with the \040 specifying a space in the regular expression, and and extra '\' +(with the \040 specifying a space in the regular expression, and and extra `\' to escape it). In many cases, #+begin_example mu find 'subject:/hello.world/' From 3dd922ff6ca10dcc9ff2cd12f57b1134f89c4ff3 Mon Sep 17 00:00:00 2001 From: Jeremy Sowden Date: Mon, 10 Mar 2025 21:42:06 +0000 Subject: [PATCH 2/2] man: escape a couple of back-slashes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Otherwise: (with the \040 specifying a space in the regular expression, and and extra '\' to escape it) is rendered as: (with the $ 40 specifying a space in the regular expression, and and extra `$ยด to escape it) Fixes: 5e2b7d52b24d ("mu-query.7: update documentation") Signed-off-by: Jeremy Sowden --- man/mu-query.7.org | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/man/mu-query.7.org b/man/mu-query.7.org index d9c380ebe..a561793d3 100644 --- a/man/mu-query.7.org +++ b/man/mu-query.7.org @@ -165,7 +165,7 @@ whitespace, so the search for a message with subject "hello world", you can writ #+begin_example mu find 'subject:/hello\\040world/' #+end_example -(with the \040 specifying a space in the regular expression, and and extra `\' +(with the \\040 specifying a space in the regular expression, and and extra `\\' to escape it). In many cases, #+begin_example mu find 'subject:/hello.world/'