--- OLD/pnm/pnmtops.1	Thu Jan  1 00:00:00 1970
+++ NEW/pnm/pnmtops.1	Thu Jan  1 00:00:00 1970
@@ -6,6 +6,12 @@
 .B pnmtops
 .RB [ -scale
 .IR s ]
+.RB [ -xscale
+.IR s ]
+.RB [ -yscale
+.IR s ]
+.RB [ -force ]
+.RB [ -keepaspect ]
 .RB [ -turn | -noturn ]
 .RB [ -rle | -runlength ]
 .RB [ -dpi
@@ -46,6 +52,51 @@
 the output look about the same size as the input would if it was displayed
 on a typical 72 dpi screen.
 To get one PNM pixel per 300 dpi printer pixel, use "-scale 0.25".
+.PP
+By default, if the image appears too big for the page, the scale factor
+is reduced to make it fit.  The
+.B -force
+flag overrides this, obeying the given (or default) scale factor even
+if it appears the picture may overflow the page.
+.PP
+The scale is normally the same on both axes, but if you have a picture
+you wish to scale by different amounts on the two axes, you can specify
+different scaling factors in the X and Y dimensions with
+.B -xscale
+and
+.B -yscale
+(X and Y here are with respect to the image, not the output; see the
+.B -turn
+and
+.B -noturn
+flags).  If you use
+.B -xscale
+or
+.B -yscale
+and
+.I pnmtops
+needs to alter the scaling factors because the image will not otherwise
+fit on the page, by default it will modify the scaling factors
+independently.  If you specify
+.B -keepaspect
+it will preserve the aspect ratio the image would have had with the
+specified scaling factors if it needs to rescale.
+.PP
+Using
+.B -scale
+after giving
+.B -xscale
+or
+.B -yscale
+will ignore the earlier option; giving
+.B -xscale
+or
+.B -yscale
+after
+.B -scale
+will act as though the
+.B -scale
+had been the other axis-specific scaling option.
 .PP
 The
 .B -turn