<?xml version="1.0" ?>
<!DOCTYPE refentry>
<refentry xmlns="http://docbook.org/ns/docbook"
          version="4.5">
  <refnamediv>
    <refname>CREATE JOURNAL</refname>
    <refpurpose>create a new empty journal</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <synopsis>CREATE JOURNAL <replaceable>journal</replaceable></synopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <para>
      <command>CREATE JOURNAL</command> creates a new empty journal.
    </para>
  </refsect1>

  <refsect1>
    <title>Options</title>

    <variablelist>
      <varlistentry>
        <term><replaceable>journal</replaceable></term>
        <listitem>
          <para>
            The name of the journal to create. It is an error to create a
            journal with the same name as an already existing journal.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>Response</title>

    <para>
      <command>CREATE JOURNAL</command> returns an empty response upon success.
    </para>
  </refsect1>
</refentry>
