--- OLD/ppm/ppmtorgb3.1 Thu Jan 1 00:00:00 1970 +++ NEW/ppm/ppmtorgb3.1 Thu Jan 1 00:00:00 1970 @@ -5,17 +5,23 @@ .SH SYNOPSIS .B ppmtorgb3 .RI [ ppmfile ] +.RI [ "r-out g-out b-out" ] .SH DESCRIPTION Reads a portable pixmap as input. Writes three portable graymaps as output, one each for red, green, and blue. .IX "color separation" .PP -The output filenames are constructed by taking the input filename, -stripping off any extension, and appending ".red", ".grn", and ".blu". +By default, the output filenames are constructed by taking the input +filename, stripping off any extension, and appending +".red", ".grn", and ".blu". For example, separating lenna.ppm would result in lenna.red, lenna.grn, and lenna.blu. If the input comes from stdin, the names are noname.red, noname.grn, and noname.blu. +However, three filenames can be explicitly specified, either with or +without an input filename specified. (The apparent ambiguity as to +whether the first arg is ppmfile or r-out is resolved by checking +whether there are three or four arguments). .SH "SEE ALSO" rgb3toppm(1), ppmtopgm(1), pgmtoppm(1), ppm(5), pgm(5) .SH AUTHOR @@ -26,3 +32,8 @@ .\" copyright notice and this permission notice appear in supporting .\" documentation. This software is provided "as is" without express or .\" implied warranty. +.\" +.\" Hacked on, 2003-06-14, to describe the r-out/g-out/b-out args, with +.\" matching code added to the source. All intellectual property +.\" rights I have in the resulting derivative works I hereby release +.\" into the public domain. -Mouse