exec(2): fix prototypes

[plan9front.git] / sys / man / 1 / jpg

diff --git a/sys/man/1/jpg b/sys/man/1/jpg
index 6ffc79e87a3219306a0ad83b885bf36071a1f93f..5b3b9da1a72d7ed3aaa960901e08925c26123dc5 100644 (file)
--- a/sys/man/1/jpg
+++ b/sys/man/1/jpg
@@ -1,10 +1,10 @@
 .TH JPG 1
 .SH NAME
-jpg, gif, png, ppm, bmp, v210, yuv, ico, tga, togif, toppm, topng, toico \- view and convert pictures
+jpg, gif, png, tif, ppm, bmp, v210, yuv, ico, tga, tojpg, togeordi, togif, toppm, topng, totif, toico \- view and convert pictures
 .SH SYNOPSIS
 .B jpg
 [
-.B -39cdefFkJrtv
+.B -39cdefFkJrtvy
 ] [
 .I file ...
 ]
@@ -23,6 +23,13 @@ jpg, gif, png, ppm, bmp, v210, yuv, ico, tga, togif, toppm, topng, toico \- view
 .I file ...
 ]
 .br
+.B tif
+[
+.B -39cdektv
+] [
+.I file ...
+]
+.br
 .B ppm
 [
 .B -39cdektv
@@ -58,6 +65,26 @@ jpg, gif, png, ppm, bmp, v210, yuv, ico, tga, togif, toppm, topng, toico \- view
 .I file ...
 ]
 .PP
+.B tojpg
+[
+.B -c
+.I comment
+] [
+.B -ks
+] [
+.I file
+]
+.br
+.B togeordi
+[
+.B -c
+.I comment
+] [
+.B -k
+] [
+.I file
+]
+.br
 .B togif
 [
 .B -c
@@ -85,6 +112,8 @@ jpg, gif, png, ppm, bmp, v210, yuv, ico, tga, togif, toppm, topng, toico \- view
 .B -c
 .I comment
 ] [
+.B -r
+] [
 .I file
 ]
 .br
@@ -93,12 +122,21 @@ jpg, gif, png, ppm, bmp, v210, yuv, ico, tga, togif, toppm, topng, toico \- view
 .B -c
 .I comment
 ] [
-[
 .B -g
 .I gamma
 ] [
 .I file
 ]
+.br
+.B totif
+[
+.B -c
+.I comment
+] [
+.B -3bgGhklLptvyY
+] [
+.I file
+]
 .PP
 .B ico
 [
@@ -116,6 +154,7 @@ These programs read, display, and write image files in public formats.
 .IR Jpg ,
 .IR gif ,
 .IR png ,
+.IR tif ,
 .IR ppm ,
 .IR bmp ,
 .IR tga ,
@@ -125,17 +164,26 @@ and
 read files in the corresponding formats and, by default, display
 them in the current window; options cause them instead to convert the images
 to Plan 9 image format and write them to standard output.
-.IR Togif ,
-.IR Toppm ,
+.IR Tojpg ,
+.IR togif ,
+.IR toppm ,
+.IR topng ,
 and
-.I topng
-read Plan 9 images files, convert them to GIF, PPM, or PNG, and write them to standard output.
+.I totif
+read Plan 9 images files, convert them to JPEG, GIF, PPM,
+PNG, or TIFF and write them to standard output.
 .PP
 The default behavior of
 .IR jpg ,
 .IR gif ,
+.IR png ,
+.IR tif ,
+.IR ppm ,
+.IR bmp ,
+.IR tga ,
+.IR v210 ,
 and
-.IR ppm
+.IR yuv
 is to display the
 .IR file ,
 or standard input if no file is named.
@@ -204,14 +252,85 @@ The input is a motion JPEG file, with multiple images representing frames of the
 .PD
 .PP
 The
-.IR togif
-and
+.IR tojpg ,
+.IR togif ,
 .IR toppm
-programs go the other way: they convert from Plan 9 images to GIF and PPM,
-and have no display capability.
-Both accept an option
+and
+.IR topng
+programs go the other way: they convert from Plan 9 images to JPEG, GIF,
+PPM, PNG, and TIFF and have no display capability.
+They all accept an option
 .B -c
 to set the comment field of the resulting file.
+The
+.B -r
+option makes
+.I toppm
+output raw PPM.
+The default is to output plain PPM.
+The
+.B -k
+option makes
+.I tojpg
+output grey-scale images,
+and the
+.B -s
+option makes it output scratched JPEG images.
+.I Togeordi
+is an
+.IR rc (1)
+script that invokes
+.B tojpg
+.BR -s .
+.I Totif
+accepts many options.
+Choosing Huffman, T4, or T6 compression
+forces the image to GREY1.
+.TP
+.B -3
+Convert the image to a true color RGB image.
+.TP
+.B -b
+Convert the image to a GREY1 black and white image.
+.TP
+.B -g
+Use T4 one-dimensional compression.
+.TP
+.B -G
+Use T4 two-dimensional compression.
+.TP
+.B -h
+Use Huffman compression.
+.TP
+.B -k
+Convert the image to a GREY8 grey-scale image.
+.TP
+.B -l
+Use LZW compression.
+.TP
+.B -L
+Use LZW compression with horizontal differencing.
+Some TIFF decoders may not support horizontal
+differencing applied to images of depths less than eight.
+.TP
+.B -p
+Use Packbits compression.
+.TP
+.B -t
+Use T6 compression.
+.TP
+.B -v
+Convert the image to an RGBV color-mapped image.
+.TP
+.B -y
+Convert the image to a GREY2 grey-scale image.
+.I Totif
+will then convert it to GREY4 before encoding
+because TIFF does not support depths of two.
+.TP
+.B -Y
+Convert the image to a GREY4 grey-scale image.
+.PP
 If there is only one input picture,
 .I togif
 converts the image to GIF format.
@@ -262,16 +381,26 @@ a single icon file.  The masks in the icon file will be the white
 space in the image.  The icon file is written to standard output.
 .SH SOURCE
 .B /sys/src/cmd/jpg
+.br
+.B /rc/bin/togeordi
 .SH "SEE ALSO"
 .IR page (1),
 .IR image (6).
 .br
+.B http://www.w3.org/Graphics/JPEG/jfif3.pdf
+.br
 .B http://www.w3.org/Graphics/JPEG/itu-t81.pdf
 .br
+.B http://en.wikibooks.org/wiki/JPEG_-_Idea_and_Practice
+.br
+.B http://en.wikipedia.org/wiki/JPEG
+.br
 .B http://www.w3.org/Graphics/GIF/spec-gif89a.txt
 .br
 .B http://www.w3.org/TR/2003/REC-PNG-20031110
 .br
+.B http://partners.adobe.com/public/developer/en/tiff/TIFF6.pdf
+.br
 .B http://netpbm.sourceforge.net/doc/ppm.html
 .br
 .B http://en.wikipedia.org/wiki/Windows_bitmap
@@ -281,3 +410,10 @@ space in the image.  The icon file is written to standard output.
 Writing an animated GIF using
 .I togif
 is a clumsy undertaking.
+.SH HISTORY
+.I Tojpg
+first appeared in 9front (May, 2013).
+.I Tif
+and
+.I totif
+first appeared in 9front (July, 2013).