Misc typo fixes, removing references to links not shipped by xli due to
conflicts with xloadimage, display a line, hyphens; #300665, #310024, #326540
Also escape some hashes and add description for -forall option
Index: xli-1.17.0+20061110/xli.man
===================================================================
--- xli-1.17.0+20061110.orig/xli.man
+++ xli-1.17.0+20061110/xli.man
@@ -1,8 +1,10 @@
 .\"	@(#)x11:contrib/clients/xloadimage/xli.man 1.13 94/07/29 Labtam
 .\"	
-.TH XLI 1 "27 Jul 1994"
+.\" comment out xsetbg and xview (not in Debian package) - jrv
+.TH XLI 1 "28 Oct 2002"
 .SH NAME
-xli, xsetbg, xview \- load images into an X11 window or onto
+.\"	xli, xsetbg, xview \- load images into an X11 window or onto
+xli \- load images into an X11 window or onto
 the root window
 .SH SYNOPSIS
 \fIxli\fR [global_options] {[image_options] image ...}
@@ -19,18 +21,18 @@ from standard input.
 If the destination display cannot support the number of colors in the
 image, the image will be dithered (monochrome destination) or have its
 colormap reduced (color destination) as appropriate.  This can also be
-done forcibly with the \fI-halftone\fR, \fI-dither\fR, and
-\fI-colors\fR options.
+done forcibly with the \fI\-halftone\fR, \fI\-dither\fR, and
+\fI\-colors\fR options.
 .PP
 A variety of image manipulations can be specified, including gamma
-correction, brightening, clipping, dithering, depth-reduction,
+correction, brightening, clipping, dithering, depth\-reduction,
 rotation, and zooming.  Most of these manipulations have simple
 implementations; speed was opted for above accuracy.
 .PP
 If you are viewing a large image in a window, the initial window will
 be at most 90% of the size of the display unless the window manager
 does not correctly handle window size requests or if you've used the
-\fI-fullscreen\fR or \fI-fillscreen\fR options.
+\fI\-fullscreen\fR or \fI\-fillscreen\fR options.
 You may move the image around in the window
 by dragging with the first mouse button.  The cursor will indicate
 which directions you may drag, if any.
@@ -42,14 +44,14 @@ Type 'q' or '^C' to exit xli.
 Type space, 'n' or 'f' to move to the next image in the list.
 Type 'b' or 'p' to move to the previous image in the list.
 Type . to reload the image.
-Type l to rotate the image anti-clockwise.
+Type l to rotate the image anti\-clockwise.
 Type r to rotate the image clockwise.
 Type 0 to set the images assumed gamma to your display gamma
        (usually darkens images)
 Type 1 to set the images assumed gamma to 1.0
        (usually lightens images)
-Type 5-2 to lighten the image (5 in small steps, up to 2 in large steps)
-Type 6-9 to darken the image (6 in small steps, up to 9 in large steps)
+Type 5\-2 to lighten the image (5 in small steps, up to 2 in large steps)
+Type 6\-9 to darken the image (6 in small steps, up to 9 in large steps)
 .ad
 .fi
 .PP
@@ -57,8 +59,8 @@ A wide variety of common image manipulat
 matching the available options.  See the section entitled \fIHINTS FOR
 GOOD IMAGE DISPLAYS\fR for some ideas.
 .PP
-\fIXsetbg\fR is equivalent to \fIxli -onroot -quiet\fR and
-\fIxview\fR is equivalent to \fIxli -view -verbose\fR.
+.\"\fIXsetbg\fR is equivalent to \fIxli \-onroot \-quiet\fR and
+.\"\fIxview\fR is equivalent to \fIxli \-view \-verbose\fR.
 .SH RESOURCE CLASS
 \fIxli\fR uses the resource class name \fI_XSETROOT_Id\FR for
 window managers which need this resource set.
@@ -66,27 +68,27 @@ window managers which need this resource
 The following options affect the global operation of \fIxli\fR.
 They may be specified anywhere on the command line.
 .TP
--default
+\-default
 Set the root background to the default root weave.  This is the same
 as \fIxsetroot\fR with no arguments.
 .TP
--debug
+\-debug
 Talk to the X server in synchronous mode.  This is useful for
 debugging.  If an X error is seen while in this mode, a core will be
 dumped.
 .TP
--dumpcore
+\-dumpcore
 Signals will not be trapped, and instead a coredump will occur.
 .TP
--display \fIdisplay_name\fR
+\-display \fIdisplay_name\fR
 X11 display name to send the image(s) to.
 .TP
--dispgamma \fIDisplay_gamma\fR
+\-dispgamma \fIDisplay_gamma\fR
 Specify the gamma correction value appropriate for the display device.
-This overides the value read from the environment variable \fBDISPLAY_GAMMA\fR,
+This overrides the value read from the environment variable \fBDISPLAY_GAMMA\fR,
 or the default value of 2.2, which is approximately correct for
 many displays. A value of between 1.6 and 2.8 is reasonable. If individual
-images are too bright or dark, use the -gamma option.
+images are too bright or dark, use the \-gamma option.
 .PP
 There is an image provided with xli called 'chkgamma.jpg' that lets you
 set the display gamma reasonably accurately.  This file contains two
@@ -95,34 +97,38 @@ eye, one using continuous tones, and the
 When the display gamma is correct, then the two ramps should look symmetrical,
 and the point at which they look equally bright should be almost exactly half
 way from the top to the bottom. (To find this point it helps if you move away
-a little from the screen, and de-focus your eyes a bit.)
+a little from the screen, and de\-focus your eyes a bit.)
 .PP
 If the equal brightness point is above center increase the
 gamma, and decrease it if it is below the center. The value
 will usually be around 2.2 Once you've got it right, you can set
 the DISPLAY_GAMMA environment variable in your .profile
 .TP
--fillscreen
+\-fillscreen
 Use the whole screen for displaying an image. The image will be zoomed
-so that it just fits the size of the screen. If -onroot is also specified,
+so that it just fits the size of the screen. If \-onroot is also specified,
 it will be zoomed to completely fill the screen.
 .TP
--fit
+\-fit
 Force image to use the default visual and colormap.  This is useful if
 you do not want technicolor effects when the colormap focus is inside
 the image window, but it may reduce the quality of the displayed
-image.  This is on by default if -onroot or -windowid is specified.
+image.  This is on by default if \-onroot or \-windowid is specified.
 .TP
--fork
+\-forall
+Apply \-fillscreen and \-fullscreen options to all images and not just
+the first.
+.TP
+\-fork
 Fork xli.  This causes xli to disassociate itself from
-the shell.  This option automatically turns on -quiet.
+the shell.  This option automatically turns on \-quiet.
 .TP
--fullscreen
+\-fullscreen
 Use the whole screen for displaying an image. The image will be surrounded by
-a border if it is smaller than the screen. If -onroot is also specified,
+a border if it is smaller than the screen. If \-onroot is also specified,
 the image will be zoomed so that it just fits the size of the screen.
 .TP
--geometry \fIWxH[{+-X}{+-}Y]\fR
+\-geometry \fIWxH[{+\-X}{+\-}Y]\fR
 This sets the size of the window onto which the images are loaded to a
 different value than the size of the image.  When viewing an image in
 a window, this can be used to set the size and position of the
@@ -131,121 +137,122 @@ If the size is not specified in the geom
 then the size will be chosen to be small enough to able to fit
 the window in the screen (as usual).
 .TP
--goto image_name
+\-goto image_name
 When the end of the list of images is reached, go to image 
 \fIimage_name\fR.  This is useful for generating looped slideshows.
 If more than one image of the same name as the target exists on the
 argument list, the first in the argument list is used.
 .TP
--help [option ...]
+\-help [option ...]
 Give information on an option or list of options.  If no option is
 given, a simple interactive help facility is invoked.
 .TP
--identify
+\-identify
 Identify the supplied images rather than display them.
 .TP
--install
+\-install
 Forcibly install the images colormap when the window is focused.
 This violates ICCCM standards and only exists to allow operation with
 naive window managers.  Use this option only if your window manager
 does not install colormaps properly.
 .TP
--list
+\-list
 List the images which are along the image path.
 .TP
--onroot
+\-onroot
 Load image(s) onto the root window instead of viewing in a window.
-This option automatically sets the -fit option.
-This is the opposite of \fI-view\fR.  \fIXSetbg\fR has this option set
-by default.  If used in conjunction with -fullscreen,
-the image will be zoomed to just fit. If used with -fillscreen, the image will
-be zoomed to completely fill the screen. -border, -at, and -center also affect the
+This option automatically sets the \-fit option.
+This is the opposite of \fI\-view\fR.
+.\"\fIXSetbg\fR has this option set by default.
+If used in conjunction with \-fullscreen,
+the image will be zoomed to just fit. If used with \-fillscreen, the image will
+be zoomed to completely fill the screen. \-border, \-at, and \-center also affect the
 results.
 .TP
--path
+\-path
 Displays the image path and image suffixes which will be used when
 looking for images.  These are loaded from ~/.xlirc and
 optionally from a system wide file (normally /usr/lib/xlirc).
 .TP
--pixmap
-Force the use of a pixmap as backing-store.  This is provided for
-servers where backing-store is broken (such as some versions of the
+\-pixmap
+Force the use of a pixmap as backing\-store.  This is provided for
+servers where backing\-store is broken (such as some versions of the
 AIXWindows server).  It may improve scrolling performance on servers
-which provide backing-store.
+which provide backing\-store.
 .TP
--private
+\-private
 Force the use of a private colormap.  Normally colors are allocated
 shared unless there are not enough colors available.
 .TP
--quiet
-Forces \fIxli\fR and \fIxview\fR to be quiet.  This is the
-default for \fIxsetbg\fR, but the others like to whistle. 
+\-quiet
+Forces \fIxli\fR and \fIxview\fR to be quiet.
+.\"This is the default for \fIxsetbg\fR, but the others like to whistle.
 .TP
--supported
+\-supported
 List the supported image types. 
 .TP
--verbose
+\-verbose
 Causes \fIxli\fR to be talkative, telling you what kind of
 image it's playing with and any special processing that it has to do. 
 This is the default for \fIxview\fR and \fIxli\fR. 
 .TP
--version
+\-version
 Print the version number and patchlevel of this version of
 \fIxli\fR.
 .TP
--view
-View image(s) in a window.  This is the opposite of \fI-onroot\fR and
+\-view
+View image(s) in a window.  This is the opposite of \fI\-onroot\fR and
 the default for \fIxview\fR and \fIxli\fR. 
 .TP
--visual \fIvisual_name\fR
+\-visual \fIvisual_name\fR
 Force the use of a specific visual type to display an image.  Normally
 \fIxli\fR tries to pick the best available image for a
 particular image type.  The available visual types are:  DirectColor,
 TrueColor, PseudoColor, StaticColor, GrayScale, and StaticGray.
 Nonconflicting names may be abbreviated and case is ignored.
 .TP
--windowid \fIhex_window_id\fR
+\-windowid \fIhex_window_id\fR
 Sets the background pixmap of a particular window ID.  The argument
 must be in hexadecimal and must be preceded by "0x" (\fIeg\fR
--windowid 0x40000b.  This is intended for setting the background
+\-windowid 0x40000b.  This is intended for setting the background
 pixmap of some servers which use untagged virtual roots
-(\fIeg\fR HP-VUE), but can have other interesting applications.
+(\fIeg\fR HP\-VUE), but can have other interesting applications.
 .SH PERSISTENT IMAGE OPTIONS
 The following options may precede each image.  They take effect from
 the next image, and continue until overridden or canceled with
-\fI-newoptions.\fR
+\fI\-newoptions.\fR
 .TP
--border \fIcolor\fR
+\-border \fIcolor\fR
 This sets the background portion of the window or clipped image which is
 not covered by any images to be \fIcolor\fR.
 .TP
--brighten \fIpercentage\fR
+\-brighten \fIpercentage\fR
 Specify a percentage multiplier for a color images colormap.  A value
 of more than 100 will brighten an image, one of less than 100 will
 darken it. 
 .TP
--colors \fIn\fR
+\-colors \fIn\fR
 Specify the maximum number of colors to use in the image.  This is a
 way to forcibly reduce the depth of an image.
 .TP
--cdither
+\-cdither
 .TP
--colordither
-Dither the image with a Floyd-Steinberg dither if the number of colors is reduced.
+\-colordither
+Dither the image with a Floyd\-Steinberg dither if the number of colors is reduced.
 This will be slow, but will give a better looking result with a restricted color
-set. \fI-cdither\fR and \fI-colordither\fR are equivalent.
+set. \fI\-cdither\fR and \fI\-colordither\fR are equivalent.
 .TP
--delay \fIsecs\fR
+\-delay \fIsecs\fR
 Sets xli to automatically advance to the following image,
 \fIsecs\fR seconds after the next image file is displayed.
 .TP
--dither
-Dither a color image to monochrome using a Floyd-Steinberg dithering
+\-dither
+Dither a color image to monochrome using a Floyd\-Steinberg dithering
 algorithm.  This happens by default when viewing color images on a
-monochrome display.  This is slower than \fI-halftone\fR and affects
+monochrome display.  This is slower than \fI\-halftone\fR and affects
 the image accuracy but usually looks much better.
 .TP
--gamma \fIImage_gamma\fR
+\-gamma \fIImage_gamma\fR
 Specify the gamma of the display the image was intended to be displayed on.
 Images seem to
 come in two flavors: 1) linear color images, produced by ray tracers,
@@ -261,135 +268,135 @@ the image for the CRT display device. If
 as if it were a linear image, then it will look too light, and a gamma value of
 (approximately) 2.2 should be specified for that image.
 Some formats (RLE) allow the image gamma to be embedded as a comment in the
-file itself, and the -gamma option allows overriding of the file comment.
+file itself, and the \-gamma option allows overriding of the file comment.
 In general, values smaller than 2.2 will lighten the image, and values
 greater than 2.2 will darken the image.
-In general this will work better than the -brighten option.
+In general this will work better than the \-brighten option.
 .TP
--gray
+\-gray
 Convert an image to grayscale.  This is very useful when displaying
 colorful images on servers with limited color capability.  The
-optional spelling \fI-grey\fR may also be used.
+optional spelling \fI\-grey\fR may also be used.
 .TP
--idelay \fIsecs\fR
+\-idelay \fIsecs\fR
 Set the delay to be used for this image to \fIsecs\fR seconds (see
-\fI-delay\fR).  If \fI-delay\fR was specified, this overrides it.  If
+\fI\-delay\fR).  If \fI\-delay\fR was specified, this overrides it.  If
 it was not specified, this sets the automatic advance delay for this
 image while others will wait for the user to advance them.
 .TP
--smooth
+\-smooth
 Smooth a color image.  This reduces blockiness after zooming an image
 up.  If used on a monochrome image, nothing happens.  This option can
 take awhile to perform, especially on large images.  You may specify
-more than one \fI-smooth\fR option per image, causing multiple
+more than one \fI\-smooth\fR option per image, causing multiple
 iterations of the smoothing algorithm.
 .TP
--title \fIwindow_title\fR
+\-title \fIwindow_title\fR
 Set the titlebar of the window used to display the image.
-This will overide any title that is read from the image
+This will override any title that is read from the image
 file. The title will also be used for the icon name.
 .TP
--xpm \fIcolor_context_key\fR
-Select the prefered xpm colour map. XPM files may contain more than one
+\-xpm \fIcolor_context_key\fR
+Select the preferred xpm colour map. XPM files may contain more than one
 color mapping, each mapping being appropriate for a particular visual.
-Normally xli will select an apropriate color mapping from that supported
+Normally xli will select an appropriate color mapping from that supported
 by the XPM file by checking on the default X visual class and depth.
-This option allows the user to overide this choice.
+This option allows the user to override this choice.
 Legal values of  \fIcolor_context_key\fR are: m, g4, g and c.
 m = mono, g4 = 4 level gray, g = gray, c = color ).
 .TP
--xzoom \fIpercentage\fR
+\-xzoom \fIpercentage\fR
 Zoom the X axis of an image by \fIpercentage\fR.  A number greater
 than 100 will expand the image, one smaller will compress it.  A zero
-value will be ignored.  This option, and the related \fI-yzoom\fR are
+value will be ignored.  This option, and the related \fI\-yzoom\fR are
 useful for correcting the aspect ratio of images to be displayed.
 .TP
--yzoom \fIpercentage\fR
-Zoom the Y axis of an image by \fIpercentage\fR.  See \fI-xzoom\fR for
+\-yzoom \fIpercentage\fR
+Zoom the Y axis of an image by \fIpercentage\fR.  See \fI\-xzoom\fR for
 more information. 
 .TP
--zoom \fIpercentage\fR
-Zoom both the X and Y axes by \fIpercentage\fR.  See \fI-xzoom\fR for
+\-zoom \fIpercentage\fR
+Zoom both the X and Y axes by \fIpercentage\fR.  See \fI\-xzoom\fR for
 more information.  Technically the percentage actually zoomed is the
 square of the number supplied since the zoom is to both axes, but I
 opted for consistency instead of accuracy.
 .TP
--newoptions
-Reset options that propagate.  The \fI-bright, -colors, -colordither, -delay,
--dither, -gamma, -gray, -normalize, -smooth, -xzoom, -yzoom\fR, and
-\fI-zoom\fR options normally propagate to all following images.
+\-newoptions
+Reset options that propagate.  The \fI\-bright, \-colors, \-colordither, \-delay,
+\-dither, \-gamma, \-gray, \-normalize, \-smooth, \-xzoom, \-yzoom\fR, and
+\fI\-zoom\fR options normally propagate to all following images.
 .SH LOCAL IMAGE OPTIONS
 The following options may precede each image.  These options are
 local to the image they precede. 
 .TP
--at \fIX\fR,\fIY\fR
+\-at \fIX\fR,\fIY\fR
 Indicates coordinates to load the image at \fIX\fR,\fIY\fR on the base image.
-If this is an option to the first image, and the \fI-onroot\fR option is
+If this is an option to the first image, and the \fI\-onroot\fR option is
 specified, the image will be loaded at the given location on the
 display background. 
 .TP
--background \fIcolor\fR
+\-background \fIcolor\fR
 Use \fIcolor\fR as the background color instead of the default
 (usually white but this depends on the image type) if you are
 transferring a monochrome image to a color display. 
 .TP
--center
+\-center
 Center the image on the base image loaded.  If this is an option to
-the first image, and the \fI-onroot\fR option is specified, the image
+the first image, and the \fI\-onroot\fR option is specified, the image
 will be centered on the display background. 
 .TP
--clip \fIX\fR,\fIY\fR,\fIW\fR,\fIH\fR
+\-clip \fIX\fR,\fIY\fR,\fIW\fR,\fIH\fR
 Clip the image before loading it.  \fIX\fR and \fIY\fR define the
-upper-left corner of the clip area, and \fIW\fR and \fIH\fR define the
+upper\-left corner of the clip area, and \fIW\fR and \fIH\fR define the
 extents of the area.  A zero value for \fIW\fR or \fIH\fR will be
 interpreted as the remainder of the image. 
 Note that \fIX\fR and \fIY\fR may be negative, and that \fIW\fR and \fIH\fR
 may be larger than the image. This causes a border to be placed around the
-image. The border color may be set with the \fI-border\fR option.
+image. The border color may be set with the \fI\-border\fR option.
 .TP
--expand
+\-expand
 Forces the image (after all other optional processing) to be expanded
 into a True Color (24 bit) image. This is useful on systems which support
 24 bit color, but where xli might choose to load a bitmap or 8 bit image
 into one of the other smaller depth visuals supported on your system.
 .TP
--foreground \fIcolor\fR
+\-foreground \fIcolor\fR
 Use \fIcolor\fR as the foreground color instead of black if you are
 transferring a monochrome image to a color display.  This can also be
 used to invert the foreground and background colors of a monochrome
 image. 
 .TP
--halftone
+\-halftone
 Force halftone dithering of a color image when displaying on a
 monochrome display.  This option is ignored on monochrome images.
 This dithering algorithm blows an image up by sixteen times; if you
-don't like this, the \fI-dither\fR option will not blow the image up
+don't like this, the \fI\-dither\fR option will not blow the image up
 but will take longer to process and will be less accurate.
 .TP
--invert
-Inverts a monochrome image.  This is shorthand for \fI-foreground
-white -background black\fR.
+\-invert
+Inverts a monochrome image.  This is shorthand for \fI\-foreground
+white \-background black\fR.
 .TP
--merge
+\-merge
 Merge this image onto the base image after local processing.  The base
 image is considered to be the first image specified or the last image
-that was not preceded by \fI-merge\fR.  If used in conjunction with
-\fI-at\fR and \fI-clip\fR, very complex images can be built up.
+that was not preceded by \fI\-merge\fR.  If used in conjunction with
+\fI\-at\fR and \fI\-clip\fR, very complex images can be built up.
 Note that the final image will be the size of the first image, and that
 subsequent merged images overlay previous images. The final image size
-can be altered by using the \fI-clip\fR option on the base image to
+can be altered by using the \fI\-clip\fR option on the base image to
 make it bigger or smaller.
-This option is on by default for all images if the \fI-onroot\fR or
-\fI-windowid\fR options are specified.
+This option is on by default for all images if the \fI\-onroot\fR or
+\fI\-windowid\fR options are specified.
 .TP
--name \fIimage_name\fR
+\-name \fIimage_name\fR
 Force the next argument to be treated as an image name.  This is
-useful if the name of the image is \fI-dither\fR, for instance. 
+useful if the name of the image is \fI\-dither\fR, for instance.
 .TP
--normalize
+\-normalize
 Normalize a color image.
 .TP
--rotate \fIdegrees\fR
+\-rotate \fIdegrees\fR
 Rotate the image by \fIdegrees\fR clockwise.  The number must be a
 multiple of 90.
 .SH EXAMPLES
@@ -397,69 +404,69 @@ To load the rasterfile "my.image" onto t
 it to fill the entire background:
 .sp
 .ti +5
-xli -onroot my.image
+xli \-onroot my.image
 .PP
 To load a monochrome image "my.image" onto the background, using red
 as the foreground color, replicate the image, and overlay
 "another.image" onto it at coordinate (10,10):
 .sp
 .ti +5
-xli -foreground red my.image -at 10,10 another.image
+xli \-foreground red my.image \-at 10,10 another.image
 .PP
 To center the rectangular region from 10 to 110 along the X axis and
 from 10 to the height of the image along the Y axis:
 .sp
 .ti +5
-xli -center -clip 10,10,100,0 my.image
+xli \-center \-clip 10,10,100,0 my.image
 .PP
 To double the size of an image:
 .sp
 .ti +5
-xli -zoom 200 my.image
+xli \-zoom 200 my.image
 .PP
 To halve the size of an image:
 .sp
 .ti +5
-xli -zoom 50 my.image
+xli \-zoom 50 my.image
 .PP
 To brighten a dark image:
 .sp
 .ti +5
-xli -brighten 150 my.image
+xli \-brighten 150 my.image
 .PP
 To darken a bright image:
 .sp
 .ti +5
-xli -brighten 50 my.image
+xli \-brighten 50 my.image
 .SH HINTS FOR GOOD IMAGE DISPLAYS
 Since images are likely to come from a variety of sources, they may be
 in a variety of aspect ratios which may not be supported by your
-display.  The \fI-xzoom\fR and \fI-yzoom\fR options can be used to
+display.  The \fI\-xzoom\fR and \fI\-yzoom\fR options can be used to
 change the aspect ratio of an image before display.  If you use these
 options, it is recommended that you increase the size of one of the
 dimensions instead of shrinking the other, since shrinking looses
 detail.  For instance, many GIF and G3 FAX images have an X:Y ratio of
 about 2:1.  You can correct this for viewing on a 1:1 display with
-either \fI-xzoom 50\fR or \fI-yzoom 200\fR (reduce X axis to 50% of
+either \fI\-xzoom 50\fR or \fI\-yzoom 200\fR (reduce X axis to 50% of
 its size and expand Y axis to 200% of its size, respectively) but the
 latter should be used so no detail is lost in the conversion.
 .PP
 When zooming color images up you can reduce blockiness with
-\fI-smooth\fR.  For zooms of 300% or more, I recommend two smoothing
+\fI\-smooth\fR.  For zooms of 300% or more, I recommend two smoothing
 passes (although this can take awhile to do on slow machines).  There
 will be a noticeable improvement in the image.
 .PP
 You can perform image processing on a small portion of an image by
-loading the image more than once and using the \fI-merge\fR, \fI-at\fR
-and \fI-clip\fR options.  Load the image, then merge it with a
+loading the image more than once and using the \fI\-merge\fR, \fI\-at\fR
+and \fI\-clip\fR options.  Load the image, then merge it with a
 clipped, processed version of itself.  To brighten a 100x100 rectangular
 portion of an image located at (50,50), for instance, you could type:
 .sp
 .ti +5
-xli my.image -merge -at 50,50 -clip 50,50,100,100 -brighten 150 my.image
+xli my.image \-merge \-at 50,50 \-clip 50,50,100,100 \-brighten 150 my.image
 .PP
 If you're using a display with a small colormap to display colorful
-images, try using the \fI-gray\fR option to convert to grayscale.
+images, try using the \fI\-gray\fR option to convert to grayscale.
 .SH XLITO
 \fIxlito\fR (XLoadImageTrailingOptions) is a separate utility that provides
 a file format independent way of marking image files with the appropriate
@@ -486,30 +493,30 @@ xlito image_file ...
 Changed or added with:
 .sp
 .ti +5
-xlito -c "string of options" image_file
+xlito \-c "string of options" image_file
 .PP
 And deleted with:
 .sp
 .ti +5
-xlito -d image_file ...
+xlito \-d image_file ...
 .PP
 For example, if you have a gif file fred.gif which is too dark and is the
 wrong aspect ratio, then it may need to be viewed with:
 .sp
 .ti +5
-xli -yzoom 130 -gamma 1.0 fred.gif
+xli \-yzoom 130 \-gamma 1.0 fred.gif
 .PP
 to get it to look OK. These options can then be appended to the file by:
 .sp
 .ti +5
-xlito -c "-yzoom 130 -gamma 1.0" fred.gif
+xlito \-c "\-yzoom 130 \-gamma 1.0" fred.gif
 .PP
 and from then on xli will get the appropriate options from the
 image file itself.  See the  \fIxlito\fR manual entry for more details
 about this utility.
 
 .SH PATHS AND EXTENSIONS
-The file ~/.xlirc (and optionally a system-wide file) defines
+The file ~/.xlirc (and optionally a system\-wide file) defines
 the path and default extensions that \fIxli\fR will use when
 looking for images.  This file can have two statements: "path=" and
 "extension=" (the equals signs must follow the word with no spaces
@@ -520,25 +527,25 @@ specified.  Everything following the "ex
 appended to the supplied image name if the supplied name does not
 specify an existing file.  As with paths, these extensions will be
 searched in the order they are given.  Comments are any portion of a
-line following a hash-mark (#).
+line following a hash\-mark (\[sh]).
 .PP
 The following is a sample ~/.xlirc file:
 .PP
 .nf
-  # paths to look for images in
+  \[sh] paths to look for images in
   path= /usr/local/images
         /home/usr1/guest/madd/images
         /usr/include/X11/bitmaps
 
-  # default extensions for images; .Z is automatic; scanned in order
+  \[sh] default extensions for images; .Z is automatic; scanned in order
   extension= .csun .msun .sun .face .xbm .bm
 .fi
 .PP
 Versions of \fIxli\fR prior to version 01, patchlevel 03 would
-load the system-wide file (if any), followed by the user's file.  This
+load the system\-wide file (if any), followed by the user's file.  This
 behavior made it difficult for the user to configure her environment
 if she didn't want the default.  Newer versions will ignore the
-system-wide file if a personal configuration file exists.
+system\-wide file if a personal configuration file exists.
 .SH IMAGE TYPES
 .PP
 \fIxli\fR currently supports the following image types:
@@ -568,11 +575,11 @@ system-wide file if a personal configura
 .fi
 .PP
 Normal, compact, and raw PBM images are supported.  Both standard and
-run-length encoded Sun rasterfiles are supported.  Any image whose
+run\-length encoded Sun rasterfiles are supported.  Any image whose
 name ends in .Z is assumed to be a compressed image and will be
 filtered through "uncompress". If HAVE_GUNZIP is defined in the
 Makefile.std make file, then any image whose name ends in
-.gz or .Z will be filtered through gunzip.
+\&.gz or .Z will be filtered through gunzip.
 .PP
 Any file that looks like a uuencoded file will be decoded
 automatically.
@@ -595,26 +602,26 @@ Version 1.17 of xli is derived from xli
 smar@reptiles.org
 .fi
 .PP
-For a more-or-less complete list of other contributors (there are a
+For a more\-or\-less complete list of other contributors (there are a
 \fIlot\fR of them), please see the README file enclosed with the
 distribution.
 .SH FILES
 .nf
 .in +5
-xli	                    - the image loader and viewer
-xsetbg                  - pseudonym which quietly sets the background
-xview                   - pseudonym which views in a window
-xlito                   - the trailing options utility
-/usr/lib/X11/Xli        - default system-wide configuration file
-~/.xlirc                - user's personal configuration file
+xli	                    \- the image loader and viewer
+.\"xsetbg                  \- pseudonym which quietly sets the background
+.\"xview                   \- pseudonym which views in a window
+xlito                   \- the trailing options utility
+/usr/lib/X11/Xli        \- default system\-wide configuration file
+~/.xlirc                \- user's personal configuration file
 .in -5
 .fi
 .SH COPYRIGHT
 Copyright (c) 1989, 1990, 1991, 1992, 1993 Jim Frost, Graeme Gill and others.
 .PP
-\fIXli\fR is copywritten material with a very loose copyright
+\fIXli\fR is copyrighted material with a very loose license
 allowing unlimited modification and distribution if the copyright
-notices are left intact.  Various portions are copywritten by various
+notices are left intact.  Various portions are copyrighted by various
 people, but all use a modification of the MIT copyright notice.
 Please check the source for complete copyright information.  The
 intent is to keep the source free, not to stifle its distribution, so
@@ -634,7 +641,7 @@ The GIF format allows more than one imag
 file, but \fIxli\fR will only display the first.
 .PP
 One of the pseudonyms for \fIxli\fR, \fIxview\fR, is the same
-name as Sun uses for their SunView-under-X package.  This will be
+name as Sun uses for their SunView\-under\-X package.  This will be
 confusing if you're one of those poor souls who has to use Sun's
 XView.
 .PP
@@ -646,9 +653,9 @@ screen, something which is normally avoi
 also ignore the MaxSize argument's real function, to limit the maximum
 size of the window, and allow the window to be resized larger than the
 image.  If this happens, \fIxli\fR merely places the image in
-the upper-left corner of the window and uses the zero-value'ed pixel
+the upper\-left corner of the window and uses the zero\-value'ed pixel
 for any space which is not covered by the image.  This behavior is
-less-than-graceful but so are window managers which are cruel enough
+less\-than\-graceful but so are window managers which are cruel enough
 to ignore such details.
 .PP
 The order in which operations are performed on an image is independent
@@ -659,5 +666,5 @@ increase speed (zooming downward before
 .PP
 Display Gamma should setable in the ~/.xlirc file.
 .PP
-Embedded trailing options overide the command line \fIImage Options.\fR Command
-line options should really overide trailing options.
+Embedded trailing options override the command line \fIImage Options.\fR Command
+line options should really override trailing options.
Index: xli-1.17.0+20061110/xlito.man
===================================================================
--- xli-1.17.0+20061110.orig/xlito.man
+++ xli-1.17.0+20061110/xlito.man
@@ -26,7 +26,7 @@ Any \fIGlobal Options\fR will be ignored
 images.
 .PP
 Old versions of \fIxloadimage\fR (3.01 or less) can be made forward compatible
-by using the \fI-x\fR option to pull the trailing options out of the image files,
+by using the \fI\-x\fR option to pull the trailing options out of the image files,
 and put them on the command line where \fIxloadimage\fR can see them.
 .SH OPTIONS
 The default behavior is to display the trailing option strings (if any) of
@@ -42,40 +42,40 @@ Delete any embedded trailing option stri
 .TP
 -x \fIfile_name ...\fR
 Process the files and create a command line string suitable for use by
-\fIxloadimage.\fR Arguments starting with \fI-\fR are echoed, arguments
-not starting with \fI-\fR are treated as files and any trailing options
+\fIxloadimage.\fR Arguments starting with \fI\-\fR are echoed, arguments
+not starting with \fI\-\fR are treated as files and any trailing options
 strings are echoed followed by the file name. The \fIxloadimage\fR option
-\fI-name\fR is treated correctly. 
+\fI\-name\fR is treated correctly. 
 .SH EXAMPLES
 If fred.gif has the wrong aspect ratio, then it might need
 viewing with the \fIxloadimage\fR options:
 .sp
 .ti +5
-xloadimage -yzoom 130 fred.gif
+xloadimage \-yzoom 130 fred.gif
 .PP
 This option can then be appended to the file by:
 .sp
 .ti +5
-xlito -c "-yzoom 130" fred.gif
+xlito \-c "\-yzoom 130" fred.gif
 .PP
 and from then on some new versions of xloadimage will get the appropriate options
 from the image file itself. Old versions of \fIxloadimage\fR can be made to
 work by using:
 .sp
 .ti +5
-xloadimage \(gaxlito -x fred.gif\(ga
+xloadimage \(gaxlito \-x fred.gif\(ga
 .PP
 This can be made transparent by using a script containing something like:
 .sp
 .ti +5
-xloadimage \(gaxlito -x $\(**\(ga
+xloadimage \(gaxlito \-x $\(**\(ga
 .PP
 The script could be called \fIxli\fR for instance.
 .PP
 The options can be deleted with:
 .sp
 .ti +5
-xlito -d fred.gif
+xlito \-d fred.gif
 .SH AUTHOR
 .nf
 Graeme Gill
@@ -89,7 +89,7 @@ smar@reptiles.org
 .SH COMPATIBILITY WITH IMAGE FILES
 Some image files are actually ascii files that are used in other contexts.
 X Bitmap files are an example. They are formatted as 'C' style
-#defines and an initialised array of characters, so that they can be included
+\[sh]defines and an initialised array of characters, so that they can be included
 in 'C' source code.  Adding trailing options would therefore render the file
 unusable with a compiler, since it will get a syntax error on the railing option
 string and the magic numbers. The solution to this is that xlito will ignore a
@@ -101,9 +101,9 @@ in some 'C' comments:
 .PP
 eg: say the file starts as:
 .br
-#define tt_width 4
+\[sh]define tt_width 4
 .br
-#define tt_height 4
+\[sh]define tt_height 4
 .br
 static char tt_bits[] = {
 .br
@@ -111,29 +111,29 @@ static char tt_bits[] = {
 .PP
 and you add a trailing options:
 .br
-#define tt_width 4
+\[sh]define tt_width 4
 .br
-#define tt_height 4
+\[sh]define tt_height 4
 .br
 static char tt_bits[] = {
 .br
    0x08, 0x02, 0x04, 0x01};
 .br
-01234567890123456789XXX xloadimage trailing options XXX0007"-smooth"0007XXX
+01234567890123456789XXX xloadimage trailing options XXX0007"\-smooth"0007XXX
 .br
 xloadimage trailing options XXX
 .PP
 Then the trailing options can be commented out:
 .br
-#define tt_width 4
+\[sh]define tt_width 4
 .br
-#define tt_height 4
+\[sh]define tt_height 4
 .br
 static char tt_bits[] = {
 .br
    0x08, 0x02, 0x04, 0x01};
 .br
-/\(**234567890123456789XXX xloadimage trailing options XXX0007"-smooth"0007XXX
+/\(**234567890123456789XXX xloadimage trailing options XXX0007"\-smooth"0007XXX
 .br
 xloadimage trailing options XXX \(**/
 .SH BUGS