Package: par
Version: 1.52-3+b2
Severity: minor
Tags: patch

Dear Maintainer,

  Let macro "LP" come before macro "RS"

  Change ".BI" to ".B" for one argument

  Request ".ps" does not accept any scale indicator

  Change "." to ".\&" when the period does not end a sentence
  
  Change "!" to "!\&" when the exclamation mark does not end a sentence

  Delete a repeated word "a".

***

More explicit explanations:

Input file is par.1

mandoc: par.1:73:2: WARNING: skipping paragraph macro: LP empty
mandoc: par.1:1053:2: WARNING: skipping paragraph macro: LP empty
mandoc: par.1:1091:2: WARNING: skipping paragraph macro: LP empty

#######

Test nr. 2:

Enable and fix warnings from 'test-groff'.

<par.1>:1148 (macro BI): only 1 argument, but more are expected
<par.1>:1153 (macro BI): only 1 argument, but more are expected
<par.1>:1160: backtrace: macro 'VS'
troff: <par.1>:1184: warning: only 'z' and 'u' scale indicators valid in this 
context

chk_manuals: Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z 


#####

Test nr. 15:

Change the name of a macro for two fonts (e.g., BR and IR) to one
letter, if there is only one argument.
Add the second argument if needed.  It is sometimes part of the first
one.

1148:.BI E
1153:.BI E

#####

Test nr. 23:

Move a full stop (period) and a comma outside of a quoted text, if it is
at the end of the quote and does not end a quoted sentence.

1756:        amc> Par should not mistake "." for a suffix.
1770:        amc> should not mistake "." for a suffix.

#####

Test nr. 26:

Find a repeated word

! 301 --> a

#####

Test nr. 28:

Wrong distance between sentences or protect the indicator.

1) Separate the sentences and subordinate clauses; each begins on a new
line.  See man-pages(7) and "info groff".

Or

2) Adjust space between sentences (two spaces),

3) or protect the indicator by adding "\&" after it.

The "indicator" is an "end-of-sentence character" (.!?).

1236:features of an editor, such as the ! commands of
1260:\*Q\fB**\fP\*U (star star). If you need to supply

Test nr. 30:

Surround a block of comments with the macros ".ig" and "..".
The .\" (\#) at the beginning of each line is then not needed.
Makes it easier to add and remove text and adjust length of lines.

NO PATCH

1:.\"*********************
2:.\"* par.1             *
3:.\"* for Par 1.52      *
4:.\"* Copyright 2001 by *
5:.\"* Adam M. Costello  *
6:.\"*********************
7:.\"
8:.\" This is nroff -man (or troff -man) code.
9:.\"

#####

  The patch:

--- par.1       2007-08-27 06:10:44.000000000 +0000
+++ par.1.new   2018-04-17 22:09:19.000000000 +0000
@@ -69,8 +69,8 @@ section).
 .LP
 Each output paragraph is generated from the
 corresponding input paragraph as follows:
-.RS
 .LP
+.RS
 .IT 1) An optional prefix and/or suffix
 is removed from each input line.
 .IT 2) The remainder is divided into
@@ -298,7 +298,7 @@ bodiless for some
 .IP "order \fIk\fP bodiless line"
 There is no such thing as an order 0 bodiless line.  Suppose
 .I S
-is a a contiguous subsequence of a segment (see below)
+is a contiguous subsequence of a segment (see below)
 containing at least two lines, containing no order
 .IR k \-1
 bodiless lines, bounded above and below by order
@@ -1049,8 +1049,8 @@ be the fallback suflen of the IP.  The
 characters which are prepended to the
 .IR i th
 line are chosen as follows:
-.RS
 .LP
+.RS
 .IT 1) If
 .I i
 <=
@@ -1087,8 +1087,8 @@ Then to each line is appended
 characters.  The characters which are appended to the
 .IR i th
 line are chosen as follows:
-.RS
 .LP
+.RS
 .IT 1) If
 .I i
 <=
@@ -1145,19 +1145,19 @@ or environment variable syntax are accom
 the same usage message that the help option produces.
 .LP
 Unless the option
-.BI E
+.B E
 is set, trying to print an error message would be
 futile if an error resulted from an output function, so
 .B par
 doesn't bother doing any error checking on output functions if
-.BI E
+.B E
 is 0.
 .SH EXAMPLES
 .de VS
 .RS -.5i
 .LP
 .nf
-.ps -1p
+.ps -1
 .vs -2p
 .ft CW
 ..
@@ -1233,7 +1233,7 @@ are clearly more eye-pleasing.
 .LP
 .B par
 is most useful in conjunction with the text-filtering
-features of an editor, such as the ! commands of
+features of an editor, such as the !\& commands of
 .BR vi .
 You may wish to add the following lines to your
 .B .exrc
@@ -1257,7 +1257,7 @@ following the ctrl-V, plus one at the en
 To reformat a simple paragraph delimited by blank lines in
 .BR vi ,
 you can put the cursor anywhere in it and type
-\*Q\fB**\fP\*U (star star). If you need to supply
+\*Q\fB**\fP\*U (star star).  If you need to supply
 arguments to par, you can type \*Q\fB*\ \fP\*U
 (star space) instead, then type the arguments.
 .LP
@@ -1753,7 +1753,7 @@ Before:
         amc>
         amc> Par still pays attention to body characters.
         amc> Par should not mistake "Par" for part of the prefix.
-        amc> Par should not mistake "." for a suffix.
+        amc> Par should not mistake ".\&" for a suffix.
 .VE
 .LP
 After
@@ -1767,7 +1767,7 @@ After
         amc> Par still pays attention to body
         amc> characters.  Par should not mistake
         amc> "Par" for part of the prefix.  Par
-        amc> should not mistake "." for a suffix.
+        amc> should not mistake ".\&" for a suffix.
 .VE
 .SH SEE ALSO
 .LP
x

-- System Information:
Debian Release: buster/sid
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 
'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 4.9.82-1u3 (SMP w/2 CPU cores)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), 
LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages par depends on:
ii  libc6  2.27-3

par recommends no packages.

par suggests no packages.

-- no debconf information

-- 
Bjarni I. Gislason

Reply via email to