Solaris/manpages/sman1/fax2ps.1
branch217update
changeset 19096 d542fc2c823e
parent 19095 e8e7aa8c74b9
--- a/Solaris/manpages/sman1/fax2ps.1	Fri Nov 24 16:16:16 2006 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,148 +0,0 @@
-<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
-<!--ArborText, Inc., 1988-1999, v.4002-->
-<!ENTITY cmd "fax2ps">
-<!ENTITY % commonents SYSTEM "smancommon.ent">
-%commonents;
-<!ENTITY % booktitles SYSTEM "booktitles.ent">
-%booktitles;
-<!ENTITY suncopy "Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.">
-]>
-<?Pub UDT _bookmark _target>
-<?Pub Inc>
-<refentry id="fax2ps-1">
-<!-- %Z%%M% %I% %E% SMI; -->
-<refmeta><refentrytitle>fax2ps</refentrytitle><manvolnum>1</manvolnum>
-<refmiscinfo class="date">26 Mar 2004</refmiscinfo>
-<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
-<refmiscinfo class="software">&release;</refmiscinfo>
-<refmiscinfo class="arch">generic</refmiscinfo>
-<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
-</refmeta>
-<indexterm><primary>fax2ps</primary></indexterm><indexterm><primary>convert
-a TIFF facsimile to compressed PostScript</primary></indexterm>
-<refnamediv id="fax2ps-1-name"><refname>fax2ps</refname><refpurpose>convert
-a TIFF facsimile to compressed PostScript</refpurpose></refnamediv>
-<refsynopsisdiv id="fax2ps-1-synp"><title>&synp-tt;</title>
-<cmdsynopsis><command>&cmd;</command><arg choice="opt"><option role="nodash"><replaceable>
-options</replaceable></option></arg><arg choice="opt"><option role="nodash"><replaceable>
-file</replaceable></option></arg>
-</cmdsynopsis></refsynopsisdiv>
-<refsect1 id="fax2ps-1-desc"><title>&desc-tt;</title>
-<para><command>&cmd;</command> reads one or more TIFF facsimile image files
-and prints a compressed form of PostScript that is suitable for printing on
-the standard output.</para>
-</refsect1>
-<refsect1 id="fax2ps-1-opts"><title>&opts-tt;</title>
-<para>The following options are supported:</para>
-<variablelist termlength="narrow">
-<varlistentry><term><option>H <replaceable>height</replaceable></option></term>
-<listitem><para>Use height as the height, in inches, of the output page. The
-default page height is 11 inches.</para>
-</listitem></varlistentry>
-<varlistentry><term><option>p <replaceable>number</replaceable></option></term>
-<listitem><para>Print only the indicated page. To print multiple pages, specify
-this option as often as required.</para>
-</listitem></varlistentry>
-<varlistentry><term><option>S</option></term><listitem><para>Scale each page
-of image data to fill the output page dimensions. By default, images are presented
-according to the dimension information recorded in the TIFF file.</para>
-</listitem></varlistentry>
-<varlistentry><term><option>W <replaceable>width</replaceable></option></term>
-<listitem><para>Use <replaceable>width</replaceable> as the width, in inches,
-of the output page. The default page width is 8.5 inches.</para>
-</listitem></varlistentry>
-<varlistentry><term><option>x <replaceable>resolution</replaceable></option></term>
-<listitem><para>Use <replaceable>resolution</replaceable> as the horizontal
-resolution, in dots per inch, of the image data. By default, this value is
-taken from the file.</para>
-</listitem></varlistentry>
-<varlistentry><term><option>y <replaceable>resolution</replaceable></option></term>
-<listitem><para>Use <replaceable>resolution</replaceable> as the vertical
-resolution, in lines per inch, of the image data. By default, this value is
-taken from the file.</para>
-</listitem></varlistentry>
-</variablelist></refsect1>
-<refsect1 id="fax2ps-1-oper"><title>&oper-tt;</title>
-<para>The following operands are supported:</para>
-<variablelist termlength="narrow">
-<varlistentry><term><option role="nodash"><replaceable>file</replaceable></option></term>
-<listitem><para>The name of the TIFF facsimile image file to be converted
-to compressed PostScript.</para>
-</listitem></varlistentry>
-</variablelist></refsect1>
-<refsect1 id="fax2ps-1-exde"><title>&exde-tt;</title>
-<para>By default, each page is scaled to reflect the image dimensions and
-resolutions stored in the file. The <option>x</option> and <option>y</option>
-options can be used to specify the horizontal and vertical image resolutions,
-respectively. If the <option>S</option> option is specified, each page is
-scaled to fill an output page. The default output page is 8.5 by 11 inches.
-Alternate page dimensions can be specified in inches with the <option>W</option>
-and <option>H</option> options.</para>
-<para>By default, <command>&cmd;</command> generates PostScript for all pages
-in the file. You can use the <option>p</option> option to select one or more
-pages from a multipage document.</para>
-<para><command>&cmd;</command> generates a compressed form of PostScript that
-is optimized for sending pages of text to a PostScript printer attached to
-a host through a low-speed link such as a serial line. Each output page is
-filled with white and then only the black areas are drawn. The PostScript
-specification of the black drawing operations is optimized by using a special
-font that encodes the move-draw operations required to fill the black regions
-on the page. This compression scheme typically results in a substantially
-reduced PostScript description, relative to the straightforward imaging of
-the page with a PostScript image operator. This algorithm can, however, be
-ineffective for continuous-tone and white-on-black images. For these images,
-it sometimes is more efficient to send the raster bitmap image directly, see <citerefentry>
-<refentrytitle>tiff2ps</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
-If the destination printer supports PostScript Level II, it is always faster
-to just send the encoded bitmap generated by the <citerefentry><refentrytitle>
-tiff2ps</refentrytitle><manvolnum>1</manvolnum></citerefentry> command.</para>
-<refsect2 id="fax2ps-1-exde-diags">
-<title>Diagnostics</title>
-<para>Some messages about malformed TIFF images come from the TIFF library.
-</para>
-<para>Various messages about badly formatted facsimile images may be generated
-due to transmission errors in received facsimile. <command>&cmd;</command>
-attempts to recover from such data errors by resynchronizing decoding at the
-end of the current scanline. This can result in long horizontal black lines
-in the resultant PostScript image.</para>
-</refsect2>
-</refsect1>
-<refsect1 id="fax2ps-1-exam"><title>&exam-tt;</title>
-<example role="example">
-<title>Converting the Tiff File test.tif to Compressed PostScript</title>
-<para><screen>example% <userinput>&cmd; test.tif</userinput></screen></para>
-</example>
-</refsect1>
-<refsect1 id="fax2ps-1-attr"><title>&attr-tt;</title>
-<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
-<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
-for descriptions of the following attributes:</para>
-<informaltable frame="all">
-<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
-<colspec colname="COLSPEC1" colwidth="1*">
-<thead>
-<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
-valign="middle">ATTRIBUTE VALUE</entry></row>
-</thead>
-<tbody>
-<row><entry><para>Availability</para></entry><entry><para>SUNWTiff</para></entry>
-</row>
-<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
-colname="COLSPEC1"><para>Evolving</para></entry></row>
-</tbody>
-</tgroup>
-</informaltable>
-</refsect1>
-<refsect1 id="fax2ps-1-also"><title>&also-tt;</title>
-<!--Reference to another man page-->
-<!--Reference to a Help manual-->
-<!--Reference to a book.-->
-<para><citerefentry><refentrytitle>tiff2ps</refentrytitle><manvolnum>1</manvolnum>
-</citerefentry>, <citerefentry><refentrytitle>libtiff</refentrytitle><manvolnum>
-3</manvolnum></citerefentry></para>
-</refsect1>
-<refsect1 id="fax2ps-1-note"><title>&note-tt;</title><?Pub Caret>
-<para>Updated by Breda McColgan, Sun Microsystems Inc., 2004.</para>
-</refsect1>
-</refentry>
-<?Pub *0000007825>