groff, pic2graph.man: The macro 'IX' is not defined and some formatting improvements

[Bjarni Ingi Gislason]

                           Groff Bug Report

GROFF VERSION: 1.22.2
'current-groff' from 12th October 2013

MACHINE: laptop i586

OS: Linux 3.2.46-1-rt67-1 (Debian)

COMPILER: gcc (Debian 4.7.2-5) 4.7.2

INPUT FILES:

.../groff-current/contrib/pic2graph/pic2graph.man

COMMAND LINE:
groff  -ww -b -mandoc -z <input file>

DESCRIPTION OF INCORRECT BEHAVIOUR:

  Output:

groff:<standard input>:4: warning: macro `IX' not defined

SUGGESTED FIX [optional]:

  Changes (besides warning):

  Qoutes used instead of a no-break space for an argument to a macro

  Removed space at the end of some lines

  Protected full stop at the end of a string if it is a part
of it with a \&

  Patch:

--- pic2graph.man       2013-10-26 00:44:41.000000000 +0000
+++ pic2graph.man.new   2013-10-26 01:03:27.000000000 +0000
@@ -1,6 +1,13 @@
 .\" $Id: pic2graph.man,v 1.7 2008/09/29 21:55:15 wl Exp $
 .\" This documentation is released to the public domain.
 .TH PIC2GRAPH @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
+.\" Macro IX is not defined in the groff macros
+.if \n(.g \{\
+.if !d IX \{\
+.de IX
+..
+.\}
+.\}
 .IX pic2graph
 .SH NAME
 pic2graph \- convert a PIC diagram into a cropped image
@@ -12,10 +19,10 @@ pic2graph \- convert a PIC diagram into
 .B \-unsafe
 ]
 [
-.BI \-format\  fmt
+.BI "\-format " fmt
 ]
 [
-.BI \-eqn\  delim
+.BI "\-eqn " delim
 ]
 .
 .
@@ -46,7 +53,7 @@ distribution.
 Your input PIC code should
 .I not
 be wrapped with the \&.PS and \&.PE macros that normally guard it within
-.BR groff (@MAN1EXT@) 
+.BR groff (@MAN1EXT@)
 macros.
 .P
 The output image will be clipped to the smallest possible bounding box
@@ -55,12 +62,12 @@ Older versions of
 .BR \%convert (1)
 will produce a black-on-white graphic; newer ones may produce a
 black-on-transparent graphic.
-By specifying command-line options to be passed to 
+By specifying command-line options to be passed to
 .BR \%convert (1)
 you can give it a border, force the background transparent, set the
 image's pixel density, or perform other useful transformations.
 .P
-This program uses 
+This program uses
 .BR @address@hidden (@MAN1EXT@),
 .BR @address@hidden (@MAN1EXT@),
 .BR groff (@MAN1EXT@),
@@ -77,7 +84,7 @@ to work.
 .SH OPTIONS
 .TP
 .B \-unsafe
-Run 
+Run
 .BR @address@hidden (@MAN1EXT@)
 and
 .BR groff (@MAN1EXT@)
@@ -86,14 +93,14 @@ in the `unsafe' mode enabling the PIC ma
 to execute arbitrary commands.
 The default is to forbid this.
 .TP
-.BI \-format\  fmt
+.BI "\-format " fmt
 Specify an output format; the default is PNG (Portable Network Graphics).
 Any format that
 .BR \%convert (1)
 can emit is supported.
 .TP
-.BI \-eqn\  delim
-Change the fencepost characters that delimit 
+.BI "\-eqn " delim
+Change the fencepost characters that delimit
 .BR @address@hidden (@MAN1EXT@)
 directives
 .RB ( $
@@ -112,7 +119,7 @@ Command-line switches and arguments not
 .SH FILES
 .TP \w'address@hidden@/eqnrc'u+2n
 .B @MACRODIR@/eqnrc
-The 
+The
 .BR @address@hidden (@MAN1EXT@)
 initialization file.
 .
@@ -139,16 +146,16 @@ Due to changes in the behavior of ImageM
 that are both forward and backward-incompatible,
 mismatches between your
 .B pic2graph
-and 
+and
 .BR \%convert (1)
 versions may produce zero-sized or untrimmed output images.
-For this version of 
+For this version of
 .B pic2graph
 you will need a version of
 .BR \%convert (1)
 that supports the
 .B \-trim
-option; older versions of 
+option; older versions of
 .B pic2graph
 used
 .BR \-crop\~0x0 ,
@@ -166,7 +173,7 @@ which no longer has trimming behavior.
 .
 .
 .SH AUTHOR
-Eric S. Raymond <address@hidden>, based on a recipe by W. Richard Stevens.
+Eric S.\& Raymond <address@hidden>, based on a recipe by W.\& Richard Stevens.
 .
 .\" Local Variables:
 .\" mode: nroff