<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
<!ENTITY dhfirstname "<firstname>David</firstname>">
<!ENTITY dhsurname   "<surname>Bremner</surname>">
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY dhdate      "<date>July  7, 2009</date>">
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
       allowed: see man(7), man(1). -->
  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
  <!ENTITY dhemail     "<email>bremner@unb.ca</email>">
  <!ENTITY dhusername  "David Bremner">
  <!ENTITY dhucpackage "<refentrytitle>SKETCH</refentrytitle>">
  <!ENTITY dhpackage   "sketch">

  <!ENTITY debian      "<productname>Debian</productname>">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
  <!ENTITY version	"0.2.27">
]>

<refentry id='sketchman'>
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <copyright>
      <year>2007</year>
      <holder>&dhusername;</holder>
    </copyright>
    &dhdate;
  </refentryinfo>

  <refmeta>
    &dhucpackage;
    &dhsection;
    <refmiscinfo class='source'> &dhpackage; </refmiscinfo>
    <refmiscinfo class='version'> &version; </refmiscinfo>
    <refmiscinfo class='manual'> User Commands </refmiscinfo>
  </refmeta>
  <refnamediv id='name'>
    <refname>&dhpackage;</refname>
    <refpurpose>Produce 3D line drawings from scene description language</refpurpose>
  </refnamediv>
<!-- body begins here -->

<refsect1 id='description'><title>DESCRIPTION</title>
<para>sketch [options] file1 [-D tag] [-U tag] file2...</para>
<variablelist remap='TP'>
  <varlistentry>
  <term><option>-h</option></term>
  <listitem>
<para>Print a summary of options to stderr</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-v</option></term>
  <listitem>
<para>                Print version info to standard output</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-d</option></term>
  <listitem>
<para> Debug parser (for developers)</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-b</option></term>
  <listitem>
<para> Use BSP rather than Painters algorithm for hidden surface removal</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-T</option>[u|e][p[P|T]]</term>
  <listitem>
<para> Produce a complete LaTeX document</para>
  <blockquote remap='RS'>
    <variablelist remap='TP'>
      <varlistentry>
      <term>u</term>
      <listitem>
<para>U.S. paper size (8.5 x 11 inches) (default)</para>
      </listitem>
      </varlistentry>
      <varlistentry>
      <term>e</term>
      <listitem>
<para>European A4 paper size (297 x 210 mm)</para>
      </listitem>
      </varlistentry>
      <varlistentry>
      <term>p</term>
      <listitem>
<para>Print document template to stdout</para>
      </listitem>
      </varlistentry>
      <varlistentry>
      <term>P</term>
      <listitem>
<para>Print PSTricks version of doc template (default)</para>
      </listitem>
      </varlistentry>
      <varlistentry>
      <term>T</term>
      <listitem>
<para>Print TikZ version of doc template</para>
      </listitem>
      </varlistentry>
    </variablelist>
    </blockquote> <!-- remap='RE' -->
  </listitem>

  </varlistentry>
  <varlistentry>
    <term><option>-t</option> templatefile </term>
    <listitem>
      <para> Load user document template 
	(any text file with escape %SKETCH_OUTPUT%)
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term><option>-o</option> outfile </term>
    <listitem>
      <para> Put output in outfile (default is stdout)
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term><option>-D</option> tag </term>
    <listitem>
      <para> Define given tag
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term><option>-U</option> tag </term>
    <listitem>
      <para> Undefine given tag
      </para>
    </listitem>
  </varlistentry>
</variablelist>
</refsect1>

<refsect1 id='see_also'><title>SEE ALSO</title>
<para>The full documentation for
<emphasis remap='B'>sketch</emphasis>
is maintained as a Texinfo manual.  If the
<emphasis remap='B'>info</emphasis>
and
<emphasis remap='B'>sketch</emphasis>
programs are properly installed at your site, the command</para>

<para><emphasis remap='B'>info sketch</emphasis></para>

<para>should give you access to the complete manual.</para>
</refsect1>

  <refsect1>
    <title>AUTHOR</title>

    <para>This manual page was written by &dhusername; &dhemail; for
      the &debian; system (but may be used by others).  Permission is
      granted to copy, distribute and/or modify this document under
      the terms of the &gnu; General Public License, Version 2 any 
	  later version published by the Free Software Foundation.
    </para>
	<para>
	  On Debian systems, the complete text of the GNU General Public
	  License can be found in /usr/share/common-licenses/GPL.
	</para>

  </refsect1>

</refentry>

