X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;f=docs%2Fmanpages%2Fprocess-new.1.sgml;fp=docs%2Fmanpages%2Fprocess-new.1.sgml;h=f99c6cfcfc0d13f6356c01d637379f765d83fe51;hb=5709024d25da3b89d53e278724691b1b1767ea5e;hp=0000000000000000000000000000000000000000;hpb=0ac00b66f877a83e63362b7d7177c6d5428b5f47;p=dak.git

diff --git a/docs/manpages/process-new.1.sgml b/docs/manpages/process-new.1.sgml
new file mode 100644
index 00000000..f99c6cfc
--- /dev/null
+++ b/docs/manpages/process-new.1.sgml
@@ -0,0 +1,95 @@
+<!-- -*- mode: sgml; mode: fold -*- -->
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
+
+<!ENTITY % dakent SYSTEM "dak.ent">
+%dakent;
+
+]>
+
+<refentry>
+  &dak-docinfo;
+
+  <refmeta>
+    <refentrytitle>dak_process-new</>
+    <manvolnum>1</>
+  </refmeta>
+
+  <!-- Man page title -->
+  <refnamediv>
+    <refname>dak process-new</>
+    <refpurpose>Processes BYHAND and NEW packages</>
+  </refnamediv>
+
+  <!-- Arguments -->
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>dak process-new</>
+      <arg><option><replaceable>options</replaceable></></arg>
+      <arg choice="plain"><replaceable>changes_file</replaceable></arg>
+      <arg><option><replaceable>...</replaceable></option></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <RefSect1><Title>Description</>
+    <para>
+      <command>dak process-new</command> is the program which installs packages from the accepted directory into the distribution.
+    </PARA></REFSECT1>
+
+  <RefSect1><Title>Options</>
+
+    <VariableList>
+
+      <varlistentry>
+	<term><option>-a/--automatic</option></term>
+	<listitem>
+	  <para>Run automatically; i.e. perform the default action if it's possible to do so without user interaction.  Intend for use in cron jobs and the like.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><option>-h/--help</option></term>
+	<listitem>
+	  <para>Display usage help and then exit.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><option>-m/--manual-reject=<replaceable>message</replaceable></option></term>
+	<listitem>
+	  <para>Perform a manual rejection of the package.  The <replaceable>message</replaceable> is included in the rejection notice sent to the uploader.  If no <replaceable>message</replaceable> is given, an editor will be spawned so one can be added to the rejection notice.
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><option>-n/--no-action</option></term>
+	<listitem>
+	  <para>Don't actually install anything; just show what would be done.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><option>-p/--no-lock</option></term>
+	<listitem>
+	  <para>Don't check the lockfile.  Obviously dangerous and should only be used for cron jobs (if at all).</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><option>-v/--version</option></term>
+	<listitem>
+	  <para>Display the version number and then exit.</para>
+	</listitem>
+      </varlistentry>
+
+    </VariableList>
+  </RefSect1>
+
+  <RefSect1><Title>Diagnostics</>
+    <para>
+      <command>dak process-new</command> returns zero on normal operation, non-zero on error.
+    </PARA>
+  </RefSect1>
+
+  &manauthor;
+
+</refentry>