<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<refentry>
  <refentryinfo>
    <address>
      <email>debacle@debian.org</email>
    </address>
    <author>
      <firstname>W.</firstname>
      <othername>Martin</othername>
      <surname>Borgert</surname>
    </author>
    <copyright>
      <year>2009</year>
      <holder>W. Martin Borgert</holder>
    </copyright>
    <date>2009-09-19</date>
  </refentryinfo>
  <refmeta>
    <refentrytitle>email2trac</refentrytitle>
    <manvolnum>1</manvolnum>
    <refmiscinfo class="source">email2trac</refmiscinfo>
    <refmiscinfo class="manual">User Commands</refmiscinfo>
  </refmeta>
  <refnamediv>
    <refname>email2trac</refname>

    <refpurpose>Creates and amends Trac tickets from e-mail.</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>email2trac</command>

      <arg><option>-h</option></arg>

      <arg><option>--help</option></arg>

      <arg><option>-f <replaceable>configuration file</replaceable></option></arg>

      <arg><option>--file=<replaceable>configuration file</replaceable></option></arg>

      <arg><option>-n</option></arg>

      <arg><option>--dry-run</option></arg>

      <arg><option>-p <replaceable>project name</replaceable></option></arg>

      <arg><option>--project=<replaceable>project name</replaceable></option></arg>

      <arg><option>-t <replaceable>name</replaceable></option></arg>

      <arg><option>--ticket_prefix=<replaceable>name</replaceable></option></arg>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>Description</title>

    <para>
      email2trac creates tickets for the issue tracking system Trac
      from e-mail. The default configuration file is
      <filename>/etc/email2trac.conf</filename>.
    </para>

    <para>
      Is also amends existing tickets, if the subject contains the
      ticket number. The syntax for the ticket number in the e-mail
      subject line is <literal>#NNN:</literal>, i.e. hash mark, ticket
      number, colon.
    </para>
  </refsect1>
  <refsect1>
    <title>Copyright</title>

    <para>Copyright 2009 W. Martin Borgert and released under the
    <acronym>GNU</acronym> General Public License
    (<abbrev>GPL</abbrev>). Permission is granted to copy, distribute
    and/or modify this document under the terms of the
    <acronym>GNU</acronym> General Public License, Version 2 or any
    later version published by the Free Software Foundation.</para>
  </refsect1>
</refentry>
