[Pkg-gmagick-im-team] Bug#1099582: composite-im7.q16.1: Some remarks and a patch with editorial changes for this man page

Bjarni Ingi Gislason bjarniig at simnet.is
Wed Mar 5 11:31:55 GMT 2025


Package: imagemagick-7.q16
Version: 8:7.1.1.43+dfsg1-1
Severity: minor
Tags: patch

   * What led up to the situation?

     Checking for defects with a new version

test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z < "man page"

  [Use "groff -e ' $' -e '\\~$' <file>" to find obvious trailing spaces.]

  ["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).

  [The fate of "test-nroff" was decided in groff bug #55941.]

   * What was the outcome of this action?

Output from "test-groff  -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z ":

an.tmac:<stdin>:13: style: 2 leading space(s) on input line
[...]
an.tmac:<stdin>:14: style: 2 leading space(s) on input line
an.tmac:<stdin>:15: style: 24 leading space(s) on input line
[...]
troff:<stdin>:83: warning: trailing space in the line

[...]
an.tmac:<stdin>:108: style: 2 leading space(s) on input line


   * What outcome did you expect instead?

     No output (no warnings).

-.-

  General remarks and further material, if a diff-file exist, are in the
attachments.


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

Kernel: Linux 6.12.12-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages imagemagick-7.q16 depends on:
ii  hicolor-icon-theme      0.18-2
ii  libc6                   2.40-7
ii  libmagickcore-7.q16-10  8:7.1.1.43+dfsg1-1
ii  libmagickwand-7.q16-10  8:7.1.1.43+dfsg1-1

Versions of packages imagemagick-7.q16 recommends:
ii  ghostscript                   10.04.0~dfsg-2+b1
pn  libmagickcore-7.q16-10-extra  <none>
ii  netpbm                        2:11.09.02-2

Versions of packages imagemagick-7.q16 suggests:
pn  autotrace                            <none>
pn  cups-bsd | lpr | lprng               <none>
ii  curl                                 8.12.1-3
pn  enscript                             <none>
pn  ffmpeg                               <none>
pn  gimp                                 <none>
pn  gnuplot                              <none>
pn  grads                                <none>
pn  graphviz                             <none>
ii  groff-base                           1.23.0-7
pn  hp2xx                                <none>
pn  html2ps                              <none>
pn  imagemagick-7-doc                    <none>
pn  libraw-bin                           <none>
pn  libwmf-bin                           <none>
pn  mplayer                              <none>
pn  povray                               <none>
pn  radiance                             <none>
pn  sane-utils                           <none>
ii  texlive-binaries [texlive-base-bin]  2024.20240313.70630+ds-5+b1
pn  transfig                             <none>
ii  xdg-utils                            1.2.1-2

-- no debconf information
-------------- next part --------------
Input file is composite-im7.q16.1

Output from "mandoc -T lint  composite-im7.q16.1": (shortened list)

      1 input text line longer than 80 bytes: By default, the imag...
      1 input text line longer than 80 bytes: For more information...
      1 input text line longer than 80 bytes: The \fBcomposite-im7...
      1 whitespace at end of input line

Remove trailing space with: sed -e 's/  *$//'

-.-.

Output from "test-nroff -mandoc -t -ww -z composite-im7.q16.1": (shortened list)

      1 trailing space in the line

Remove trailing space with: sed -e 's/  *$//'

-.-.

Remove space characters (whitespace) at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".

Number of lines affected is

1

-.-.

Remove space in the first column, if not indented.
Use ".in +<number>n" and ".in" to end it; ".nf" and ".fi" to end
it, for an extra indention.

composite-im7.q16.1:13:  \-affine matrix       affine transform matrix
[...]
composite-im7.q16.1:108:  \-version             print version information

-.-.

Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-),
if it
is in front of a name for an option,
is a symbol for standard input,
is a single character used to indicate an option,
or is in the NAME section (man-pages(7)).
N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen
(0x2010, groff \[u2010] or \[hy]) in the output.

110:By default, the image format of `file' is determined by its magic number.  To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for standard input or output.

-.-.

Strings longer than 3/4 of a standard line length (80)
Use "\:" to split the string at the end of an output line, for example a
long URL (web address)

10 For more information about the composite command, point your browser to file:///usr/share/doc/imagemagick-7-common/html/www/composite.html or https://imagemagick.org/script/composite.php.
116 \fBCopyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/share/doc/imagemagick-7-common/html/www/license.html or https://imagemagick.org/script/license.php\fP

-.-.

Add a "\&" (or a comma (Oxford comma)) after "e.g." and "i.e.",
or use English words
(man-pages(7)).
Abbreviation points should be marked as such and protected against being
interpreted as an end of sentence, if they are not, and that independent
of the current place on the line.

110:By default, the image format of `file' is determined by its magic number.  To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for standard input or output.

-.-.

Wrong distance between sentences in the input file.

  Separate the sentences and subordinate clauses; each begins on a new
line.  See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").

  The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.

Remember coding: Only one command ("sentence") on each (logical) line.

E-mail: Easier to quote exactly the relevant lines.

Generally: Easier to edit the sentence.

Patches: Less unaffected text.

Search for two adjacent words is easier, when they belong to the same line,
and the same phrase.

  The amount of space between sentences in the output can then be
controlled with the ".ss" request.

Mark a final abbreviation point as such by suffixing it with "\&".

Some sentences (etc.) do not begin on a new line.

Split (sometimes) lines after a punctuation mark; before a conjunction.

  Lines with only one (or two) space(s) between sentences could be split,
so latter sentences begin on a new line.

Use

#!/usr/bin/sh

sed -e '/^\./n' \
-e 's/\([[:alpha:]]\)\.  */\1.\n/g' $1

to split lines after a sentence period.
Check result with the difference between the formatted outputs.
See also the attachment "general.bugs"

6:\fBmagick-im7.q16 composite\fP \fB[\fP \fIoptions\fP \fB... ]\fP \fIchange-file base-file\fP \fB[\fP \fImask-file\fP \fB]\fP \fIoutput-image\fP
8:The \fBcomposite-im7.q16\fP program is a member of the ImageMagick-ims7.q16(1) suite of tools.  Use it to overlap one image over another.
110:By default, the image format of `file' is determined by its magic number.  To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for standard input or output.
116:\fBCopyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/share/doc/imagemagick-7-common/html/www/license.html or https://imagemagick.org/script/license.php\fP

-.-.

Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
Add "\:" to split the string for the output, "\<newline>" in the source.  

Line 6, length 143

\fBmagick-im7.q16 composite\fP \fB[\fP \fIoptions\fP \fB... ]\fP \fIchange-file base-file\fP \fB[\fP \fImask-file\fP \fB]\fP \fIoutput-image\fP

Line 8, length 137

The \fBcomposite-im7.q16\fP program is a member of the ImageMagick-ims7.q16(1) suite of tools.  Use it to overlap one image over another.

Line 10, length 187

For more information about the composite command, point your browser to file:///usr/share/doc/imagemagick-7-common/html/www/composite.html or https://imagemagick.org/script/composite.php.

Line 110, length 306

By default, the image format of `file' is determined by its magic number.  To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for standard input or output.

Line 116, length 222

\fBCopyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/share/doc/imagemagick-7-common/html/www/license.html or https://imagemagick.org/script/license.php\fP

-.-.

Name of a manual is set in bold, the section in roman.
See man-pages(7).

112:ImageMagick-im7.q16(1)

-.-.

point size: the typographical term is 'type size'.  There exist
several point sizes, like 'Didot point', 'big point' (PostScript point),
and 'pica point' (printer's point, English, USA).

45:  \-pointsize value     font point size

-.-.

Put a parenthetical sentence, phrase on a separate line,
if not part of a code.
See man-pages(7), item "semantic newline".

composite-im7.q16.1:110:By default, the image format of `file' is determined by its magic number.  To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for standard input or output.

-.-.

Space after an end of sentence.

composite-im7.q16.1:6:\fBmagick-im7.q16 composite\fP \fB[\fP \fIoptions\fP \fB... ]\fP \fIchange-file base-file\fP \fB[\fP \fImask-file\fP \fB]\fP \fIoutput-image\fP
composite-im7.q16.1:8:The \fBcomposite-im7.q16\fP program is a member of the ImageMagick-ims7.q16(1) suite of tools.  Use it to overlap one image over another.
composite-im7.q16.1:110:By default, the image format of `file' is determined by its magic number.  To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for standard input or output.
composite-im7.q16.1:116:\fBCopyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/share/doc/imagemagick-7-common/html/www/license.html or https://imagemagick.org/script/license.php\fP

-.-.

Put a subordinate sentence (after a comma) on a new line.

composite-im7.q16.1:10:For more information about the composite command, point your browser to file:///usr/share/doc/imagemagick-7-common/html/www/composite.html or https://imagemagick.org/script/composite.php.
composite-im7.q16.1:110:By default, the image format of `file' is determined by its magic number.  To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for standard input or output.
composite-im7.q16.1:116:\fBCopyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/share/doc/imagemagick-7-common/html/www/license.html or https://imagemagick.org/script/license.php\fP

-.-.

Remove quotes when there is a printable
but no space character between them
and the quotes are not for emphasis (markup),
for example as an argument to a macro.

composite-im7.q16.1:1:.TH composite-im7.q16 1 "Date: 2009/01/10 01:00:00" "ImageMagick"

-.-.

Output from "test-groff  -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z ":

an.tmac:<stdin>:13: style: 2 leading space(s) on input line
[...]
an.tmac:<stdin>:24: style: 23 leading space(s) on input line

[...]
an.tmac:<stdin>:25: style: 2 leading space(s) on input line
troff:<stdin>:83: warning: trailing space in the line
an.tmac:<stdin>:84: style: 2 leading space(s) on input line
[...]

-.-.

Additionally:

Use .TS/.TE macros for a table.

Use \% to avoid hyphenating web addresses.

-.-

Generally:

Split (sometimes) lines after a punctuation mark; before a conjunction.
-------------- next part --------------
--- composite-im7.q16.1	2025-03-05 10:27:10.490050895 +0000
+++ composite-im7.q16.1.new	2025-03-05 11:21:05.584265587 +0000
@@ -1,116 +1,155 @@
-.TH composite-im7.q16 1 "Date: 2009/01/10 01:00:00" "ImageMagick"
+.TH composite-im7.q16 1 "Date: 2009/01/10 01:00:00" ImageMagick
 .SH NAME
 composite \-  overlaps one image over another.
 .SH SYNOPSIS
 .TP
-\fBmagick-im7.q16 composite\fP \fB[\fP \fIoptions\fP \fB... ]\fP \fIchange-file base-file\fP \fB[\fP \fImask-file\fP \fB]\fP \fIoutput-image\fP
+\fBmagick-im7.q16 composite\fP \fB[\fP \fIoptions\fP \fB... ]\fP \
+\fIchange-file base-file\fP \fB[\fP \fImask-file\fP \fB]\fP \
+\fIoutput-image\fP
 .SH OVERVIEW
-The \fBcomposite-im7.q16\fP program is a member of the ImageMagick-ims7.q16(1) suite of tools.  Use it to overlap one image over another.
-
-For more information about the composite command, point your browser to file:///usr/share/doc/imagemagick-7-common/html/www/composite.html or https://imagemagick.org/script/composite.php.
+The \fBcomposite-im7.q16\fP program is a member of the
+.BR ImageMagick-ims7.q16 (1)
+suite of tools.
+Use it to overlap one image over another.
+
+For more information about the composite command, point your browser to
+\%file:///usr/share/doc/imagemagick\-7\-common/html/www/composite.html or
+\%https://imagemagick.org/script/composite.php.
 .SH DESCRIPTION
-Image Settings:
-  \-affine matrix       affine transform matrix
-  \-alpha option        on, activate, off, deactivate, set, opaque, copy
-                        transparent, extract, background, or shape
-  \-authenticate value  decrypt image with this password
-  \-blue-primary point  chromaticity blue primary point
-  \-colorspace type     alternate image colorspace
-  \-comment string      annotate image with comment
-  \-compose operator    composite operator
-  \-compress type       type of pixel compression when writing the image
-  \-decipher filename   convert cipher pixels to plain pixels
-  \-define format:option
-                       define one or more image format options
-  \-depth value         image depth
-  \-density geometry    horizontal and vertical density of the image
-  \-display server      get image or font from this X server
-  \-dispose method      layer disposal method
-  \-dither method       apply error diffusion to image
-  \-encipher filename   convert plain pixels to cipher pixels
-  \-encoding type       text encoding type
-  \-endian type         endianness (MSB or LSB) of the image
-  \-filter type         use this filter when resizing an image
-  \-font name           render text with this font
-  \-format "string"     output formatted image characteristics
-  \-gravity type        which direction to gravitate towards
-  \-green-primary point chromaticity green primary point
-  \-interlace type      type of image interlacing scheme
-  \-interpolate method  pixel color interpolation method
-  \-label string        assign a label to an image
-  \-limit type value    pixel cache resource limit
-  \-matte               store matte channel if the image has one
-  \-monitor             monitor progress
-  \-page geometry       size and location of an image canvas (setting)
-  \-pointsize value     font point size
-  \-quality value       JPEG/MIFF/PNG compression level
-  \-quiet               suppress all warning messages
-  \-red-primary point   chromaticity red primary point
-  \-regard-warnings     pay attention to warning messages
-  \-repage geometry     size and location of an image canvas (operator)
-  \-respect-parentheses settings remain in effect until parenthesis boundary
-  \-sampling-factor geometry
-                       horizontal and vertical sampling factor
-  \-scene value         image scene number
-  \-seed value          seed a new sequence of pseudo-random numbers
-  \-size geometry       width and height of image
-  \-support factor      resize support: > 1.0 is blurry, < 1.0 is sharp
-  \-synchronize         synchronize image to storage device
-  \-taint               declare the image as modified
-  \-transparent-color color
-                       transparent color
-  \-treedepth value     color tree depth
-  \-tile                repeat composite operation across and down image
-  \-units type          the units of image resolution
-  \-verbose             print detailed information about the image
-  \-virtual-pixel method
-                       virtual pixel access method
-  \-white-point point   chromaticity white point
-
-Image Operators:
-  \-blend geometry      blend images
-  \-border geometry     surround image with a border of color
-  \-bordercolor color   border color
-  \-channel mask        set the image channel mask
-  \-colors value        preferred number of colors in the image
-  \-displace geometry   shift image pixels defined by a displacement map
-  \-dissolve value      dissolve the two images a given percent
-  \-distort geometry    shift lookup according to a absolute distortion map
-  \-extract geometry    extract area from image
-  \-geometry geometry   location of the composite image
-  \-identify            identify the format and characteristics of the image
-  \-monochrome          transform image to black and white
-  \-negate              replace each pixel with its complementary color 
-  \-profile filename    add ICM or IPTC information profile to image
-  \-quantize colorspace reduce colors in this colorspace
-  \-rotate degrees      apply Paeth rotation to the image
-  \-resize geometry     resize the image
-  \-sharpen geometry    sharpen the image
-  \-shave geometry      shave pixels from the image edges
-  \-stegano offset      hide watermark within an image
-  \-stereo              combine two image to create a stereo anaglyph
-  \-strip               strip image of all profiles and comments
-  \-thumbnail geometry  create a thumbnail of the image
-  \-transform           affine transform image
-  \-type type           image type
-  \-unsharp geometry    sharpen the image
-  \-watermark geometry  percent brightness and saturation of a watermark
-  \-write filename      write images to this file
-
-Image Stack Operators:
-  \-swap indexes        swap two images in the image sequence
-
-Miscellaneous Options:
-  \-debug events        display copious debugging information
-  \-help                print program options
-  \-log format          format of debugging information
-  \-list type           print a list of supported option arguments
-  \-version             print version information
-
-By default, the image format of `file' is determined by its magic number.  To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps).  Specify 'file' as '-' for standard input or output.
+.TS
+l l.
+Image Settings:	\&
+\-affine matrix	affine transform matrix
+\-alpha option	T{
+on, activate, off, deactivate, set, opaque, copy transparent, extract,
+background, or shape
+T}
+\-authenticate value	decrypt image with this password
+\-blue-primary point	chromaticity blue primary point
+\-colorspace type	alternate image colorspace
+\-comment string	annotate image with comment
+\-compose operator	composite operator
+\-compress type	T{
+type of pixel compression when writing the \%image
+T}
+\-decipher filename	convert cipher pixels to plain pixels
+\-define format:option	define one or more image format options
+\-depth value	image depth
+\-density geometry	T{
+horizontal and vertical density of the image
+T}
+\-display server	get image or font from this X server
+\-dispose method	layer disposal method
+\-dither method	apply error diffusion to image
+\-encipher filename	convert plain pixels to cipher pixels
+\-encoding type	text encoding type
+\-endian type	endianness (MSB or LSB) of the image
+\-filter type	use this filter when resizing an image
+\-font name	render text with this font
+\-format "string"	output formatted image characteristics
+\-gravity type	which direction to gravitate towards
+\-green-primary point	chromaticity green primary point
+\-interlace type	type of image interlacing scheme
+\-interpolate method	pixel color interpolation method
+\-label string	assign a label to an image
+\-limit type value	pixel cache resource limit
+\-matte	store matte channel if the image has one
+\-monitor	monitor progress
+\-page geometry	T{
+size and location of an image canvas (setting)
+T}
+\-pointsize value	font type size
+\-quality value	JPEG/MIFF/PNG compression level
+\-quiet	suppress all warning messages
+\-red-primary point	chromaticity red primary point
+\-regard-warnings	pay attention to warning messages
+\-repage geometry	T{
+size and location of an image canvas (operator)
+T}
+\-respect-parentheses	T{
+settings remain in effect until parenthesis boundary
+T}
+\-sampling-factor geometry	horizontal and vertical sampling factor
+\-scene value	image scene number
+\-seed value	seed a new sequence of pseudo-random numbers
+\-size geometry	width and height of image
+\-support factor	T{
+resize support: > 1.0 is blurry, < 1.0 is sharp
+T}
+\-synchronize	synchronize image to storage device
+\-taint	declare the image as modified
+\-transparent-color color	transparent color
+\-treedepth value	color tree depth
+\-tile	T{
+repeat composite operation across and down \%image
+T}
+\-units type	the units of image resolution
+\-verbose	print detailed information about the image
+\-virtual-pixel method	virtual pixel access method
+\-white-point point	chromaticity white point
+
+Image Operators:	\&
+\-blend geometry	blend images
+\-border geometry	surround image with a border of color
+\-bordercolor color	border color
+\-channel mask	set the image channel mask
+\-colors value	preferred number of colors in the image
+\-displace geometry	T{
+shift image pixels defined by a displacement map
+T}
+\-dissolve value	dissolve the two images a given percent
+\-distort geometry	T{
+shift lookup according to a absolute distortion map
+T}
+\-extract geometry	extract area from image
+\-geometry geometry	location of the composite \%image
+\-identify	T{
+identify the format and characteristics of the image
+T}
+\-monochrome	transform image to black and white
+\-negate	replace each pixel with its complementary color
+\-profile filename	add ICM or IPTC information profile to image
+\-quantize colorspace	reduce colors in this colorspace
+\-rotate degrees	apply Paeth rotation to the image
+\-resize geometry	resize the image
+\-sharpen geometry	sharpen the image
+\-shave geometry	shave pixels from the image edges
+\-stegano offset	hide watermark within an image
+\-stereo	combine two image to create a stereo anaglyph
+\-strip	strip image of all profiles and comments
+\-thumbnail geometry	create a thumbnail of the image
+\-transform	affine transform image
+\-type type	image type
+\-unsharp geometry	sharpen the image
+\-watermark geometry	T{
+percent brightness and saturation of a watermark
+T}
+\-write filename	write images to this file
+
+Image Stack Operators:	\&
+\-swap indexes	swap two images in the image sequence
+
+Miscellaneous Options:	\&
+\-debug events	display copious debugging information
+\-help	print program options
+\-log format	format of debugging information
+\-list type	print a list of supported option arguments
+\-version	print version information
+.TE
+
+By default, the image format of `file' is determined by its magic number.
+To specify a particular image format,
+precede the filename with an image format name and a colon
+(i.e.\& ps:image)
+or specify the image type as the filename suffix (i.e.\& image.ps).
+Specify 'file' as '\-' for standard input or output.
 .SH SEE ALSO
-ImageMagick-im7.q16(1)
+.BR ImageMagick-im7.q16 (1)
 
 .SH COPYRIGHT
 
-\fBCopyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/share/doc/imagemagick-7-common/html/www/license.html or https://imagemagick.org/script/license.php\fP
+\fBCopyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and
+licenses apply to this software, see
+file:///usr/share/doc/imagemagick\-7\-common/html/www/license.html or
+\%https://imagemagick.org/script/license.php\fP
+
-------------- next part --------------
  Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)

[gn]roff -mandoc -t -ww -b -z -K utf8 <man page>

  The same goes for man pages that are used as an input.

  For a style guide use

  mandoc -T lint

-.-

  Any "autogenerator" should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.

  It should also check its input files for too long (> 80) lines.

  This is just a simple quality control measure.

  The "autogenerator" may have to be corrected to get a better man page,
the source file may, and any additional file may.

  Common defects:

  Not removing trailing spaces (in in- and output).
  The reason for these trailing spaces should be found and eliminated.

  "git" has a "tool" to point out whitespace,
see for example "git-apply(1)" and git-config(1)")

  Not beginning each input sentence on a new line.
Line length and patch size should thus be reduced.

  The script "reportbug" uses 'quoted-printable' encoding when a line is
longer than 1024 characters in an 'ascii' file.

  See man-pages(7), item "semantic newline".

-.-

The difference between the formatted output of the original and patched file
can be seen with:

  nroff -mandoc <file1> > <out1>
  nroff -mandoc <file2> > <out2>
  diff -d -u <out1> <out2>

and for groff, using

\"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - \"

instead of 'nroff -mandoc'

  Add the option '-t', if the file contains a table.

  Read the output from 'diff -d -u ...' with 'less -R' or similar.

-.-.

  If 'man' (man-db) is used to check the manual for warnings,
the following must be set:

  The option \"-warnings=w\"

  The environmental variable:

export MAN_KEEP_STDERR=yes (or any non-empty value)

  or

  (produce only warnings):

export MANROFFOPT=\"-ww -b -z\"

export MAN_KEEP_STDERR=yes (or any non-empty value)

-.-


More information about the Pkg-gmagick-im-team mailing list