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.