--- ray/doc/man/man1/pcompos.1	2003/12/09 15:59:06	1.2
+++ ray/doc/man/man1/pcompos.1	2022/03/15 00:25:50	1.8
@@ -1,10 +1,12 @@
-.\" RCSid "$Id: pcompos.1,v 1.2 2003/12/09 15:59:06 greg Exp $"
+.\" RCSid "$Id: pcompos.1,v 1.8 2022/03/15 00:25:50 greg Exp $"
 .TH PCOMPOS 1 12/18/97 RADIANCE
 .SH NAME
 pcompos - composite RADIANCE pictures.
 .SH SYNOPSIS
 .B pcompos
 [
+.B \-h
+][
 .B "\-x xres"
 ][
 .B "\-y yres"
@@ -74,6 +76,13 @@ The
 option specifies a background color to appear wherever input
 files do not cover.
 The default value is black (0 0 0).
+The
+.I \-h
+option may be used to reduce the information header size, which
+can grow disproportionately after multiple runs of
+.I pcompos
+and/or
+.I pcomb(1).
 .PP
 If input files overlap, later pictures will overwrite earlier ones.
 By default, input files are copied unconditionally within the output
@@ -134,6 +143,15 @@ option will cause each image to be separated by at lea
 The
 .I "\-o x0 y0"
 option specifies a nonzero anchor point for the bottom left image.
+If a negative value is given for ncols, then the rows are reversed,
+so they start from the top rather than the bottom.
+This gives a more natural ordering in most cases, but has the
+side-effect of moving any labels from the upper-left of each placed
+subimage to the lower-left.
+Also, the
+.I \-o
+option is interpreted differently, where the y0 value is number of
+pixels from the top (rather than the bottom).
 .PP
 The standard input can be specified with a hyphen ('-').
 A command that produces a RADIANCE picture can be given in place of a file 
@@ -141,19 +159,20 @@ by preceeding it with an exclamation point ('!').
 .SH EXAMPLE
 To put a copyright label at the bottom of a picture:
 .IP "" .2i
-psign Copyright 1987 | pcompos pic.inp 0 0 +t .5 - 384 64 > pic.out
+psign Copyright 1987 | pcompos inp.hdr 0 0 +t .5 - 384 64 > out.hdr
 .PP
-To make a catalog of images separated by white 10-pixel borders:
+To make a catalog of images separated by white 10-pixel borders and
+ordered four images per row starting from the top-left:
 .IP "" .2i
-pcompos -la -a 4 -s 10 -b 1 1 1 dog*.pic > alldogs.pic
+pcompos -la -a -4 -s 10 -b 1 1 1 dog*.hdr > alldogs.hdr
 .SH NOTES
 Since there is a limit to the number of open files and processes,
 large collections of images must be created in stages.
 Even if the system limit on open files is large,
 .I pcompos
-places an artificial limit of 64 on the number of open files and/or
+places an artificial limit of 1024 on the number of open files and/or
 processes.
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
-getinfo(1), pfilt(1), psign(1), rpict(1)
+getinfo(1), pcomb(1), pfilt(1), psign(1), rcrop(1), rpict(1)