fix some single-quoted strings in man-page
authorJeremy Sowden <jeremy@azazel.net>
Mon, 10 Mar 2025 22:07:50 +0000 (22:07 +0000)
committerJeremy Sowden <azazel@debian.org>
Mon, 10 Mar 2025 22:07:50 +0000 (22:07 +0000)
commit1e3537f670028a7c06e920b5833ca86d5a83522b
tree81b788d796d9308b39795e23faa35bd79ba83e7e
parentec910543518418b68f5b69841348487f5fa3d9c8
fix some single-quoted strings in man-page

Last-Update: 2025-03-10
Forwarded: https://github.com/djcb/mu/pull/2828

The upstream 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:<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.

Gbp-Pq: Name fix-single-quotes-in-man-pages.patch
man/mu-query.7.org