Package: mg
Version: 20171014-1
Severity: minor
Tags: patch

Dear Maintainer,

Input file is mg.1

Test nr. 2:
Enable and fix warnings from 'test-groff'.
Input file is /tmp/mg.1

git/groff/build/tmac/doc.tmac:705: backtrace
git/groff/build/tmac/doc.tmac:77: backtrace: macro 'doc-parse-args'
git/groff/build/tmac/doc.tmac:705: backtrace: macro 'doc-enclose-string'
git/groff/build/tmac/doc.tmac:646: backtrace: macro 'Dq'
troff: <standard input>:1066: warning: escape character ignored before ';'
git/groff/build/tmac/doc.tmac:705: backtrace
git/groff/build/tmac/doc.tmac:79: backtrace: macro 'doc-parse-args'
git/groff/build/tmac/doc.tmac:705: backtrace: macro 'doc-enclose-string'
git/groff/build/tmac/doc.tmac:646: backtrace: macro 'Dq'
troff: <standard input>:1066: warning: escape character ignored before ';'
git/groff/build/tmac/doc.tmac:705: backtrace: string 'doc-arg1'
git/groff/build/tmac/doc.tmac:1112: backtrace: macro 'doc-get-arg-type*'
git/groff/build/tmac/doc.tmac:84: backtrace: macro 'doc-parse-args'
git/groff/build/tmac/doc.tmac:705: backtrace: macro 'doc-enclose-string'
git/groff/build/tmac/doc.tmac:646: backtrace: macro 'Dq'
troff: <standard input>:1066: warning: escape character ignored before ';'
git/groff/build/tmac/doc.tmac:705: backtrace: string 'doc-arg1'
git/groff/build/tmac/doc.tmac:1118: backtrace: macro 'doc-get-arg-type*'
git/groff/build/tmac/doc.tmac:84: backtrace: macro 'doc-parse-args'
git/groff/build/tmac/doc.tmac:705: backtrace: macro 'doc-enclose-string'
git/groff/build/tmac/doc.tmac:646: backtrace: macro 'Dq'
troff: <standard input>:1066: warning: escape character ignored before ';'
git/groff/build/tmac/doc.tmac:705: backtrace: string 'doc-arg1'
git/groff/build/tmac/doc.tmac:731: backtrace: while loop
git/groff/build/tmac/doc.tmac:736: backtrace: macro 'doc-enclose-string'
git/groff/build/tmac/doc.tmac:646: backtrace: macro 'Dq'
troff: <standard input>:1066: warning: escape character ignored before ';'
git/groff/build/tmac/doc.tmac:705: backtrace: string 'doc-arg1'
git/groff/build/tmac/doc.tmac:733: backtrace: while loop
git/groff/build/tmac/doc.tmac:736: backtrace: macro 'doc-enclose-string'
git/groff/build/tmac/doc.tmac:646: backtrace: macro 'Dq'
troff: <standard input>:1066: warning: escape character ignored before ';'
git/groff/build/tmac/doc.tmac:705: backtrace: string 'doc-str-dpr'
git/groff/build/tmac/doc.tmac:252: backtrace: macro 'doc-do-2'
git/groff/build/tmac/doc.tmac:761: backtrace: macro 'doc-enclose-string'
git/groff/build/tmac/doc.tmac:646: backtrace: macro 'Dq'
troff: <standard input>:1066: warning: escape character ignored before ';'

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

####


#####

Test nr. 8:
Protect a full stop (.) with "\&", if it has a blank (white-space) in front
of or (ignoring transparent characters to the full stop) after it, and it does
not mean an end of a sentence.

35:backwards from the end of the file i.e. +-1 will be the last
64:throwaway; i.e. the user will not be prompted to save changes when
425:words; i.e. convert the first character of the word to
593:Unbind a key from the global (fundamental) key map; i.e. set it to 'rescan'.
756:Insert the next character verbatim into the current buffer; i.e. ignore
1043:represents the name of the terminal type; e.g. if the terminal type

#####

Test nr. 17:
Change - to \- if it means a minus sign.

35:backwards from the end of the file i.e. +-1 will be the last
36:line of the file, +-2 will be second last, and so on.

#####

Test nr. 28:

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

  The space between sentences in "roff" is two spaces.
Better is to begin each sentence on a new line
to avoid different writers' conventions.
Begin each subordinate clause on a new line for the benefits of
patches.

  References:

  1) man-pages(7) from package "man-pages" or
"www.kernel.org/doc/man-pages" section 7 or
"man7.org/linux/man-pages/man7/man-pages.7.html":

"New sentences should be started on new lines.
This makes it easier to see the effect of patches,
which often operate at the level of individual sentences."

  2) groff_diff(7) in package "groff":

"In GNU troff, as in UNIX troff, you should always follow a sentence
with either a newline or two spaces."

  3) "info groff":

  Search for the word "sentence" in the output to get more hints about input
conventions.

35:backwards from the end of the file i.e. +-1 will be the last
64:throwaway; i.e. the user will not be prompted to save changes when
425:words; i.e. convert the first character of the word to
550:Invoke an extended command; i.e. M-x.
593:Unbind a key from the global (fundamental) key map; i.e. set it to 'rescan'.
756:Insert the next character verbatim into the current buffer; i.e. ignore
1043:represents the name of the terminal type; e.g. if the terminal type

#####

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 lenght of lines.

NO PATCH

1:.\"   $OpenBSD: mg.1,v 1.105 2016/07/28 21:37:45 tedu Exp $
2:.\" This file is in the public domain.
3:.\"
362:.\"
707:.\" .It no-tab-mode
708:.\" Toggle notab mode.
709:.\" In this mode, spaces are inserted rather than tabs.

#####

  The patch is in the attachment.

-- 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.80-2 (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 mg depends on:
ii  libbsd0    0.8.7-1
ii  libc6      2.27-1
ii  libtinfo5  6.1-1

mg recommends no packages.

mg suggests no packages.

-- no debconf information

-- 
Bjarni I. Gislason
--- mg.1        2018-03-09 22:55:03.000000000 +0000
+++ mg.1.new    2018-03-09 22:55:26.000000000 +0000
@@ -32,8 +32,8 @@ a space between the
 .Sq +
 sign and the number).
 If a negative number is specified, the line number counts
-backwards from the end of the file i.e. +-1 will be the last
-line of the file, +-2 will be second last, and so on.
+backwards from the end of the file i.e., +\-1 will be the last
+line of the file, +\-2 will be second last, and so on.
 .It Fl f Ar mode
 Run the mode command for all buffers created from
 arguments on the command line, including the
@@ -61,7 +61,7 @@ prompts if the change should go ahead (y
 should be reverted (r) to the latest file on disk.
 .Pp
 If a buffer name begins and ends with an asterisk, the buffer is considered
-throwaway; i.e. the user will not be prompted to save changes when
+throwaway; i.e., the user will not be prompted to save changes when
 the buffer is killed.
 .Sh POINT AND MARK
 The current cursor location in
@@ -422,7 +422,7 @@ Invoke the keyboard macro.
 .It capitalize-word
 Capitalize
 .Va n
-words; i.e. convert the first character of the word to
+words; i.e., convert the first character of the word to
 upper case, and subsequent letters to lower case.
 .It cd
 Change the global working directory.
@@ -547,7 +547,7 @@ startup files.
 Swap the values of "dot" and "mark" in the current window.
 Return an error if no mark is set.
 .It execute-extended-command
-Invoke an extended command; i.e. M-x.
+Invoke an extended command; i.e.\& M-x.
 Call the message line routine to read in the command name and apply
 autocompletion to it.
 When it comes back, look the name up in the symbol table and run the
@@ -590,7 +590,7 @@ Move the cursor forward by the specified
 .It global-set-key
 Bind a key in the global (fundamental) key map.
 .It global-unset-key
-Unbind a key from the global (fundamental) key map; i.e. set it to 'rescan'.
+Unbind a key from the global (fundamental) key map; i.e., set it to 'rescan'.
 .It global-wd-mode
 Toggle global working-directory mode.
 When enabled,
@@ -753,7 +753,7 @@ Replace strings selectively.
 Does a search and replace operation using regular
 expressions for both patterns.
 .It quoted-insert
-Insert the next character verbatim into the current buffer; i.e. ignore
+Insert the next character verbatim into the current buffer; i.e., ignore
 any function bound to that key.
 .It re-search-again
 Perform a regular expression search again, using the same search
@@ -1040,7 +1040,7 @@ and
 .Pa .mg-TERM .
 Here,
 .Ev TERM
-represents the name of the terminal type; e.g. if the terminal type
+represents the name of the terminal type; e.g., if the terminal type
 is set to
 .Dq vt100 ,
 .Nm
@@ -1063,7 +1063,9 @@ auto-execute *.c c-mode
 .Ed
 .Pp
 Comments can be added to the startup files by placing
-.Dq \;
+.\" if ".Dq \;" then "groff -ww" issues a warning about an escaped character
+.\" if ".Dq ;" then the result is '"";'
+.Dq \&;
 or
 .Dq #
 as the first character of a line.

Reply via email to