source: pst/ps/psutils.xml@ 959f944

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
 
  <!ENTITY psutils-download-http "http://gd.tuwien.ac.at/publishing/tex/tex-utils/psutils/psutils-&psutils-version;.tar.gz">
  <!ENTITY psutils-download-ftp  " ">
  <!ENTITY psutils-size          "68 KB">
  <!ENTITY psutils-buildsize     "740 KB">
  <!ENTITY psutils-time          "0.01 SBU">
]>

<sect1 id="psutils" xreflabel="PSUtils-&psutils-version;">
<?dbhtml filename="psutils.html"?>
<title>PSUtils-&psutils-version;</title>

<sect2>
<title>Introduction to <application>PSUtils</application></title>

<para><application>PSUtils</application> is a set of utilities to manipulate 
PostScript files.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&psutils-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&psutils-download-ftp;"/></para></listitem>
<listitem><para>Download size: &psutils-size;</para></listitem>
<listitem><para>Estimated Disk space required:
&psutils-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&psutils-time;</para></listitem></itemizedlist>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>PSUtils</application></title>

<para>Install <application>PSUtils</application> by running the following 
commands:</para>

<screen><userinput><command>cat Makefile.unix | sed -e 's/\/usr\/local/\/usr/g' &gt; Makefile &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

</sect2>

<sect2>
<title>Installation command explanations</title>

<para><command>cat ... | sed ...</command>: This command creates a
<filename>Makefile</filename> that installs the program to the
<filename class="directory">/usr</filename> prefix instead of the
<filename class="directory">/usr/local</filename> prefix.</para>

</sect2>

<sect2>
<title>Contents</title>
                                                                                
<para>The <application>PSUtils</application> package contains <command>
psbook</command>, <command>psselect</command>, <command>pstops</command>
<command>psnup</command>, <command>psresize</command>,
<command>epsffit</command>, <command>getafm</command>,
<command>showchar</command>, <command>fixdlsrps</command>,
<command>fixfmps</command>, <command>fixmacps</command>, <command>fixpsditps
</command>, <command>fixpspps</command>, <command>fixscribeps</command>,
<command>fixtpps</command>, <command>fixwfwps</command>,
<command>fixwpps</command>, <command>fixwwps</command>, <command>extractres</command>, <command>includeres</command> and <command>psmerge</command>.</para>

<para>Sometimes <command>psnup</command> and other utilities from this
package produce PostScript files that don't conform to Adobe's
<acronym>DSC</acronym> standard.
<application><acronym>CUPS</acronym></application> may print them
incorrectly. On the other hand,
<application><acronym>CUPS</acronym></application> has builtin
replacements for most commands from this package. For example, to print
a document 2-up, you will issue this command:</para>

<screen><userinput><command>lp -o number-up=2 <replaceable>[filename]</replaceable></command></userinput></screen>
                                                                                
</sect2>
                                                                                
<sect2><title>Description</title>
                                                                                
<sect3><title>psbook</title>
<para><command>psbook</command> rearranges pages into signatures.</para></sect3>
                                                                                
<sect3><title>psselect</title>
<para><command>psselect</command> selects pages and page ranges.</para>
</sect3>
                        
<sect3><title>pstops</title>
<para><command>pstops</command> performs general page rearrangements
and selection.</para></sect3>
                                                                                
<sect3><title>psnup</title>
<para><command>psnup</command> puts multiple pages per physical sheet
of paper.</para></sect3>

<sect3><title>psresize</title>
<para><command>psresize</command>  alters the document paper size.</para></sect3>
                                                                                
<sect3><title>epsffit</title>
<para><command>epsffit</command> fits an <acronym>EPSF</acronym> file to a 
given bounding box.</para></sect3>


<sect3><title>scripts</title>
<para>The remaining commands are scripts that perform specific functions
described in their respective man pages.</para></sect3>

</sect2>

</sect1>