<?xml version='1.0' encoding='ISO-8859-1'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
  <!ENTITY dhfirstname "<firstname>Stephane</firstname>">
  <!ENTITY dhsurname   "<surname>Graber</surname>">
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY dhdate      "<date>January 09, 2011</date>">
  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
  <!ENTITY dhemail     "<email>stgraber@ubuntu.com</email>">
  <!ENTITY dhusername  "Stephane Graber">
  <!ENTITY dhucpackage "<refentrytitle>PASTEBINIT</refentrytitle>">
  <!ENTITY dhpackage   "pastebinit">

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

<refentry>
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <copyright>
      <year>2007-2011</year>
      <holder>&dhusername;</holder>
    </copyright>
    &dhdate;
  </refentryinfo>
  <refmeta>
    &dhucpackage;

    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>&dhpackage;</refname>

    <refpurpose>command-line pastebin client</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&dhpackage;</command>
      <arg><option>-abfhiljmrtup</option></arg>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>

    <para>This manual page documents briefly the
      <command>&dhpackage;</command> commands</para>

    <para><command>&dhpackage;</command> reads text and sends it to a
    "pastebin" on the internet, returning the URL to the user.</para>
    <para>It allows the text to be passed through a pipe (|) or from
    a file passed as an argument.</para> 
  </refsect1>
  <refsect1>
    <title>OPTIONS</title>
    <refsect2>
      <title>Optional arguments (not supported by all pastebins)</title>
      <variablelist>
        <varlistentry>
          <term><option>-a <arg>author</arg></option> (default: $USER)</term>
        </varlistentry>
        <varlistentry>
          <term><option>-b <arg>pastebin url</arg></option> (default is susepaste)</term>
        </varlistentry>
        <varlistentry>
          <term><option>-f <arg>format for syntax-highlighting</arg></option> (default: text)
          (check pastebin's website for complete list, example: python). The special argument
          "auto_guess" (<option>-f auto_guess</option>) will trigger format guessing from file extension</term>
        </varlistentry>
        <varlistentry>
          <term><option>-h</option> Help screen</term>
        </varlistentry>
        <varlistentry>
          <term><option>-i <arg>filename</arg></option> Use filename for input</term>
        </varlistentry>
        <varlistentry>
          <term><option>-l</option> List all the supported pastebins</term>
        </varlistentry>
        <varlistentry>
          <term><option>-j <arg>jabberid</arg></option> (default: none)</term>
        </varlistentry>
        <varlistentry>
          <term><option>-m <arg>permatag</arg></option> (default: none)</term>
        </varlistentry>
        <varlistentry>
          <term><option>-r <arg>parent post ID</arg></option> (default: none)</term>
        </varlistentry>
        <varlistentry>
          <term><option>-t <arg>title of paste</arg></option> (default: none)</term>
        </varlistentry>
        <varlistentry>
          <term><option>-u <arg>username</arg></option> (default: none)</term>
        </varlistentry>
        <varlistentry>
          <term><option>-p <arg>password</arg></option> (default: none)</term>
        </varlistentry>
      </variablelist>
    </refsect2>
  </refsect1>
  <refsect1>
    <title>CONFIGURATION FILE</title>
    <para>If a .pastebinit.xml file is found in the user's home directory,
    pastebinit will use it for its configuration.</para>
    <para>Here's an example file:</para>
    <code language="xml">
 &lt;pastebinit&gt;
     &lt;pastebin&gt;http://paste.ubuntu.com&lt;/pastebin&gt;
     &lt;author&gt;Stephane Graber&lt;/author&gt;
     &lt;jabberid&gt;stgraber@stgraber.org&lt;/jabberid&gt;
     &lt;format&gt;text&lt;/format&gt;
 &lt;/pastebinit&gt;
</code>
  </refsect1>
  <refsect1>
    <title>AUTHORS</title>
    <para>Pastebinit is currently written by &dhfirstname; &dhsurname;.</para>
    <para>username, password, format, title, arguments and redirect
    support added by Daniel Bartlett.</para>
    <para>Website: http://launchpad.net/pastebinit</para>
    <para>E-mail: stgraber@ubuntu.com</para>
  </refsect1>
</refentry>
