Fix various lint warnings in manuals

Fix "new sentence, new line" warnings throughout so that formatters
can produce correct spacing between sentences.

join.1
  Remove unnecessary Ns macros. These are not necessary for delimeters,
  which get special treatment.

xinstall.1
  Fix date in manual. The contents were last modified on 2016-12-03,
  so use that instead of the invalid date.

grep.1
  Fix escape sequence for `\<` and `\>`.

ed.1
  Remove spurious `\\n` escape for the null-command.
This commit is contained in:
Michael Forney
2020-03-01 14:37:31 -08:00
parent dbbac61fc4
commit 22921a859f
44 changed files with 381 additions and 270 deletions

73
sed.1
View File

@@ -56,46 +56,57 @@ Editing commands take the form
.Ss Addresses
Addresses are either blank, a positive decimal integer denoting a line
number, the character '$' denoting the last line of input, or a regular
expression. A command with no addresses matches every line, one address
matches individual lines, and two addresses matches a range of lines
from the first to the second address inclusive.
expression.
A command with no addresses matches every line, one address matches
individual lines, and two addresses matches a range of lines from the
first to the second address inclusive.
.Ss Functions
.Bl -tag -width Ds
.It Ar a Op Ar text
Append text to output after end of current cycle.
.It Ar b Op Ar label
Branch to label. If no label is provided branch to end of script.
Branch to label.
If no label is provided branch to end of script.
.It Ar c Op Ar text
Change. Delete addressed range and output text after end of current cycle.
Change.
Delete addressed range and output text after end of current cycle.
.It Ar d
Delete pattern space and begin next cycle.
.It Ar D
Delete pattern space up to and including first newline and begin new
cycle without reading input. If there is no newline, behave like d.
cycle without reading input.
If there is no newline, behave like d.
.It Ar g
Get. Replace the pattern space with the hold space.
Get.
Replace the pattern space with the hold space.
.It Ar G
Get. Append a newline and the hold space to the pattern space.
Get.
Append a newline and the hold space to the pattern space.
.It Ar h
Hold. Replace the hold space with the pattern space.
Hold.
Replace the hold space with the pattern space.
.It Ar H
Hold. Append a newline and the pattern space to the hold space.
Hold.
Append a newline and the pattern space to the hold space.
.It Ar i Op Ar text
Insert text in output.
.It Ar l
List? Write the pattern space replacing known non printing characters with
backslash escaped versions (\\\\, \\a, \\b, \\f, \\r, \\t, \\v). Print
bad UTF-8 sequences as \\ooo where ooo is a three digit octal number. Mark
end of lines with '$'.
backslash escaped versions (\\\\, \\a, \\b, \\f, \\r, \\t, \\v).
Print bad UTF-8 sequences as \\ooo where ooo is a three digit octal
number.
Mark end of lines with '$'.
.It Ar n
Next. Write pattern space (unless
Next.
Write pattern space (unless
.Fl n ) ,
read next line into pattern space, and continue current cycle. If there
is no next line, quit.
read next line into pattern space, and continue current cycle.
If there is no next line, quit.
.It Ar N
Next. Read next line, append newline and next line to pattern space,
and continue cycle. If there is no next line, quit without printing
current pattern space.
Next.
Read next line, append newline and next line to pattern space, and
continue cycle.
If there is no next line, quit without printing current pattern space.
.It Ar p
Print current pattern space.
.It Ar P
@@ -105,12 +116,14 @@ Quit.
.It Ar r file
Read file and write contents to output.
.It Ar s/re/text/flags
Find occurences of regular expression re in the pattern space and replace
with text. A '&' in text is replaced with the entire match. A \\d where
d is a decimal digit 1-9 is replaced with the corresponding match group
from the regular expression. \\n represents a newline in both the regular
expression and replacement text. A literal newline in the replacement
text must be preceded by a \\.
Find occurences of regular expression re in the pattern space and
replace with text.
A '&' in text is replaced with the entire match.
A \\d where d is a decimal digit 1-9 is replaced with the corresponding
match group from the regular expression.
\\n represents a newline in both the regular expression and replacement
text.
A literal newline in the replacement text must be preceded by a \\.
.Pp
Flags are
.Bl -tag -width Ds
@@ -118,16 +131,18 @@ Flags are
A positive decimal number denoting which match in the pattern space
to replace.
.It Ar g
Global. Replace all matches in the pattern space.
Global.
Replace all matches in the pattern space.
.It Ar p
Print the pattern if a replacement was made.
.It Ar w file
Write the pattern space to file if a replacement was made.
.El
.It Ar t Op Ar label
Test. Branch to corresponding labelif a substitution has been made since
the last line was read or last t command was executed. If no label is
provided branch to end of script.
Test.
Branch to corresponding label if a substitution has been made since the
last line was read or last t command was executed.
If no label is provided branch to end of script.
.It Ar w file
Write pattern space to file.
.It Ar x