From ceeb3848e43f708e76e13d6d6089e59d665f2558 Mon Sep 17 00:00:00 2001 From: Leah Neukirchen Date: Wed, 17 May 2017 14:05:18 +0200 Subject: [PATCH] man: fix rendering with groff Closes #32. --- man/magrep.1 | 4 ++-- man/mblaze-profile.5 | 4 ++-- man/mmsg.7 | 14 +++++++------- man/mpick.1 | 6 +++--- man/mscan.1 | 26 +++++++++++++------------- man/msed.1 | 18 +++++++++--------- 6 files changed, 36 insertions(+), 36 deletions(-) diff --git a/man/magrep.1 b/man/magrep.1 index 265d791..f4fc1f9 100644 --- a/man/magrep.1 +++ b/man/magrep.1 @@ -10,7 +10,7 @@ .Op Fl v .Op Fl i .Op Fl a | Fl d -.Ar header Ns Cm ":" Ns Ar regex +.Ar header Ns Cm \&: Ns Ar regex .Op Ar msgs\ ... .Sh DESCRIPTION .Nm @@ -30,7 +30,7 @@ will instead match against the Maildir flags of the messages. If .Ar header is -.Sq Li "/" , +.Sq Cm \&/ , .Nm will instead search the plain text parts of the .Em body diff --git a/man/mblaze-profile.5 b/man/mblaze-profile.5 index 6e5b46f..373b3de 100644 --- a/man/mblaze-profile.5 +++ b/man/mblaze-profile.5 @@ -17,10 +17,10 @@ which usually resides in if set.) .Pp This file consists of a RFC 2822 style header message with lines like -.Dl Ar key Ns ":" Ar value +.Dl Ar key Ns \&: Ar value .Pp You can use a key -.Sq Li "#" +.Sq Cm \&# for comments: .Dl Li "#:" Ar comment .Pp diff --git a/man/mmsg.7 b/man/mmsg.7 index 9344936..40c89f8 100644 --- a/man/mmsg.7 +++ b/man/mmsg.7 @@ -32,7 +32,7 @@ to all messages in the directory. .Pp Sequences have the format -.Sq Ar start Ns Cm ":" Ns Ar stop , +.Sq Ar start Ns Cm \&: Ns Ar stop , where .Ar start and @@ -50,24 +50,24 @@ is the empty string, .Li \&-1 will be used instead. Thus, -.Sq Cm ":" +.Sq Cm \&: represents the whole sequence. If the sequence does not contain a -.Sq Cm ":" , +.Sq Cm \&: , it is considered to be a single message, equivalent to the range -.Sq Ar start Ns Cm ":" Ns Ar start +.Sq Ar start Ns Cm \&: Ns Ar start of size one. .Pp If the sequence is threaded, the following syntax may be used: -.Sq Ar msg Ns Cm "=" +.Sq Ar msg Ns Cm \&= refers to the whole thread that contains .Ar msg . -.Sq Ar msg Ns Cm "^" +.Sq Ar msg Ns Cm \&^ refers to the parent of the message .Ar msg and may be repeated to refer to grand-parents. -.Sq Ar msg Ns Cm "_" +.Sq Ar msg Ns Cm \&_ refers to the subthread headed by .Ar msg (i.e. all messages below with more indentation). diff --git a/man/mpick.1 b/man/mpick.1 index d11f0eb..724146a 100644 --- a/man/mpick.1 +++ b/man/mpick.1 @@ -42,7 +42,7 @@ and can include: .It Ar n Message number .Ar n . -.It Ar n Ns Cm ":" Ns Ar m , Ar n Ns Cm "-" Ns Ar m +.It Ar n Ns Cm \&: Ns Ar m , Ar n Ns Cm \&- Ns Ar m An inclusive range of message numbers between .Ar n and @@ -50,11 +50,11 @@ and .It Ar address All messages from .Ar address . -.It Cm "/" Ns Ar string +.It Cm \&/ Ns Ar string All messages with .Ar string in the subject line (case ignored). -.It Cm ":" Ns Ar c +.It Cm \&: Ns Ar c All message of type .Ar c , where diff --git a/man/mscan.1 b/man/mscan.1 index f902d2e..d241d82 100644 --- a/man/mscan.1 +++ b/man/mscan.1 @@ -56,18 +56,18 @@ The following formatting codes can be used .Ar ( wd overrides the default width): .Bl -tag -width Ds -.It Cm "\\n" +.It Cm \en Newline -.It Cm "\\t" +.It Cm \et Tab -.It Cm "%%" +.It Cm \&%% A plain -.Sq Li "%" . +.Sq Li \&% . .It Cm "%" Ns Oo Ar wd Oc Ns Cm "b" Human-readable size of the message (in kilobytes). .It Cm "%c" A -.Sq Li ">" +.Sq Li \& on the current message, else a blank. .It Cm "%" Ns Oo Ar wd Oc Ns Cm "d" Adaptive date of the message. @@ -103,9 +103,9 @@ The raw Maildir flags of the message. The number of the message in the current sequence. .It Cm "%r" A -.Sq Li "-" +.Sq Li \&- on a replied-to message, or a -.Sq Li ":" +.Sq Li \&: on a forwarded message, or a blank. .It Cm "%" Ns Oo Ar wd Oc Ns Cm "R" The filename of the message. @@ -119,25 +119,25 @@ with leading etc. stripped. .It Cm "%t" A -.Sq Li ">" +.Sq Li \&> if you are in .Sq Li "To:" , a -.Sq Li "+" +.Sq Li \&+ if you are in .Sq Li "Cc:" , a -.Sq Li ":" +.Sq Li \&: if you are in .Sq Li "Resent-To:" , or a blank else. .It Cm "%u" A -.Sq Li "*" +.Sq Li \&* on a flagged message, or a -.Sq Li "." +.Sq Li \&. on an unseen message, or a -.Sq Li "x" +.Sq Li x on a trashed message, or a blank. .El .El diff --git a/man/msed.1 b/man/msed.1 index cdffcd1..093b2ec 100644 --- a/man/msed.1 +++ b/man/msed.1 @@ -42,25 +42,25 @@ The separators the command letter may be subsituted with an arbitrary symbol, just as in .Xr sed 1 . Multiple commands can be separated by -.Sq Cm ";" . +.Sq Cm \&; . .Bl -tag -width Ds -.It Cm "/" Ns Ar header Ns Cm "/" Ns Ic a Ns Cm "/" Ns Ar value Ns Cm "/" +.It Cm \&/ Ns Ar header Ns Cm \&/ Ns Ic a Ns Cm \&/ Ns Ar value Ns Cm \&/ If the header -.Sq Ar header Ns Cm ":" +.Sq Ar header Ns Cm \&: is not set in the message, add it with given .Ar value . -.It Cm "/" Ns Ar headers Ns Cm "/" Ns Ic c Ns Cm "/" Ns Ar value Ns Cm "/" +.It Cm \&/ Ns Ar headers Ns Cm \&/ Ns Ic c Ns Cm \&/ Ns Ar value Ns Cm \&/ Change colon-separated headers matching the regular expression .Ar headers , with implicit anchoring to the header name, to the value given in .Ar value . -.It Cm "/" Ns Ar headers Ns Cm "/" Ns Ic d +.It Cm \&/ Ns Ar headers Ns Cm \&/ Ns Ic d Delete colon-separated headers matching the regular expression .Ar headers , with implicit anchoring to the header name. Use explicit -.Sq Li ".*" +.Sq Li \&.* to match arbitrary strings at the beginning or end of the headers. .Pp For example, @@ -75,7 +75,7 @@ will delete the headers .Sq Li "To:" , and .Sq Li "Cc:" . -.It Oo Cm "/" Ns Ar headers Ns Cm "/" Oc Ns Ic s Ns Cm "/" Ns Ar regex Ns Cm "/" Ns Ar replacement Ns Cm "/" Ns Op Ar flags +.It Oo Cm \&/ Ns Ar headers Ns Cm \&/ Oc Ns Ic s Ns Cm \&/ Ns Ar regex Ns Cm \&/ Ns Ar replacement Ns Cm \&/ Ns Op Ar flags Substitute matches of the POSIX Basic Regular Expression .Ar regex in headers matching the POSIX Basic Regular Expression @@ -85,10 +85,10 @@ with implicit anchoring to the header name with the string .Ar replacement , expanding -.Sq Li "&" +.Sq Cm \&& to the matched string, and -.Sq Li "\\" Ns Ar N +.Sq Cm \e Ns Ar N to the .Ar N Ns th