groff, grap2graph.man: Macro IX is not defined and some formatting changes

[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/grap2graph/grap2graph.man

COMMAND LINE:

groff -b -ww -mandoc -z <input file>

DESCRIPTION OF INCORRECT BEHAVIOUR OR DEFECTS IN SOURCE:

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

  Changes (besides warning):

  Extra space (\^ or \| or ' ') around |

  Space at the end of lines removed

  No right margin adjustment of lines with long words

  Manuals (man pages) should usually only have the left margin
adjusted.
  Use '.ad l' at the beginning

SUGGESTED FIX [optional]:

--- grap2graph.man      2013-10-27 22:52:20.000000000 +0000
+++ grap2graph.man.new  2013-10-27 23:03:06.000000000 +0000
@@ -3,6 +3,13 @@
 .
 .
 .TH GRAP2GRAPH @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
+.\" The macro IX is not a part of the groff macros
+.if \n(.g \{\
+.  if !d IX \{\
+.    de IX
+.  .
+.  \}
+.\}
 .IX grap2graph
 .SH NAME
 grap2graph \- convert a grap diagram into a cropped bitmap image
@@ -14,7 +21,7 @@ grap2graph \- convert a grap diagram int
 .B \-unsafe
 ]
 [
-.BI \-resolution\  M\fR|\fPMxN
+.BI \-resolution\  M\fR\^|\^\fPMxN
 ]
 [
 .BI \-format\  fmt
@@ -34,16 +41,16 @@ macros.
 .P
 The output image will be a black-on-white graphic clipped to the
 smallest possible bounding box that contains all the black pixels.
-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, set the background transparent, set the
 image's pixel density, or perform other useful transformations.
 .P
-This program uses 
+This program uses
 .BR grap (1),
 .BR @address@hidden (@MAN1EXT@),
 .BR groff (@MAN1EXT@),
-and the ImageMagick 
+and the ImageMagick
 .BR convert (1)
 program.
 These programs must be installed on your system and accessible on your
@@ -53,7 +60,7 @@ $PATH for \fBgrap2graph\fR to work.
 .SH OPTIONS
 .TP
 .B \-unsafe
-Run 
+Run
 .BR @address@hidden (@MAN1EXT@)
 and
 .BR groff (@MAN1EXT@)
@@ -88,6 +95,7 @@ Otherwise, temporary files will be creat
 .BR /tmp .
 .
 .
+.na
 .SH "SEE ALSO"
 .BR pic2graph (@MAN1EXT@),
 .BR eqn2graph (@MAN1EXT@),
@@ -98,7 +106,7 @@ Otherwise, temporary files will be creat
 .
 .
 .SH AUTHOR
-Eric S. Raymond <address@hidden>
+Eric S.\& Raymond <address@hidden>
 .
 .\" Local Variables:
 .\" mode: nroff

-- 
Bjarni I. Gislason