alx/mu4e
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

man: fix some single-quoted strings

Browse Source 
Commit 721aadc140 ("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:<standard input>: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: 5e2b7d52b2 ("mu-query.7: update documentation")
Signed-off-by: Jeremy Sowden <jeremy@azazel.net>
This commit is contained in:
Jeremy Sowden
2025-03-09 21:25:55 +00:00
parent a8fac834d3
commit 9364d25af7
1 changed files with 3 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
man/mu-query.7.org
View File

@ -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 *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 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. *--analyze* option can be useful.
* TERMS * TERMS
@ -136,7 +136,7 @@ $ mu find "hello*"
#+end_example #+end_example
Quoting the "hello*" is recommended; some shells (but not all) would otherwise 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 * REGULAR EXPRESSIONS
@ -165,7 +165,7 @@ whitespace, so the search for a message with subject "hello world", you can writ
#+begin_example #+begin_example
mu find 'subject:/hello\\040world/' mu find 'subject:/hello\\040world/'
#+end_example #+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, to escape it). In many cases,
#+begin_example #+begin_example
mu find 'subject:/hello.world/' mu find 'subject:/hello.world/'