docs/melanie.1.sgml

   1 <!-- -*- mode: sgml; mode: fold -*- -->
   2 <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
   3
   4 <!ENTITY % katieent SYSTEM "katie.ent">
   5 %katieent;
   6
   7 ]>
   8
   9 <refentry>
  10   &katie-docinfo;
  11
  12   <refmeta>
  13     <refentrytitle>melanie</>
  14     <manvolnum>1</>
  15   </refmeta>
  16
  17   <!-- Man page title -->
  18   <refnamediv>
  19     <refname>melanie</>
  20     <refpurpose>Utility to remove/add packages from suites</>
  21   </refnamediv>
  22
  23   <!-- Arguments -->
  24   <refsynopsisdiv>
  25     <cmdsynopsis>
  26       <command>melanie</>
  27       <arg><option><replaceable>options</replaceable></></arg>
  28       <arg choice="plain"><replaceable>package</replaceable></arg>
  29       <arg><option><replaceable>...</replaceable></option></arg>
  30     </cmdsynopsis>
  31   </refsynopsisdiv>
  32
  33   <RefSect1><Title>Description</>
  34     <para>
  35       <command>melanie</command> is the command line tool to add and remove packages from suites.
  36
  37   <RefSect1><Title>Options</>
  38
  39     <VariableList>
  40       <VarListEntry><term><option>-a/--architecture=<replaceable>architecture</replaceable></option></>
  41         <ListItem><Para>
  42             Restrict the packages being considered to the architecture(s) listed.
  43       </VarListEntry>
  44
  45       <VarListEntry><term><option>-b/--binary</option></>
  46         <ListItem><Para>
  47             Only look at binary packages.
  48       </VarListEntry>
  49
  50       <VarListEntry><term><option>-c/--component=<replaceable>component</replaceable></option></>
  51         <ListItem><Para>
  52             Restrict the packages being considered to those found in the component(s) listed.  The default is <literal>main</literal>.
  53       </VarListEntry>
  54
  55       <VarListEntry><term><option>-d/--done=<replaceable>done</replaceable></option></>
  56         <ListItem><Para>
  57             Close the bug(s) listed on successful completion.
  58       </VarListEntry>
  59
  60       <VarListEntry><term><option>-m/--reason=<replaceable>reason</replaceable></option></>
  61         <ListItem><Para>
  62             The reason for the removal or addition of the package(s).  This is a required option; if not provided an editor will be spawned so the reason can be added there.
  63       </VarListEntry>
  64
  65       <VarListEntry><term><option>-n/--no-action</option></>
  66         <ListItem><Para>
  67             Don't actually do anything; just show what would be done.
  68       </VarListEntry>
  69
  70       <VarListEntry><term><option>-p/--partial</option></>
  71         <ListItem><Para>
  72             Partial removal of a package, so the package is not removed from the overrides.  This option is implied by <option>-a/--architecture</option>.
  73       </VarListEntry>
  74
  75       <VarListEntry><term><option>-s/--suite=<replaceable>suite</replaceable></option></>
  76         <ListItem><Para>
  77             Only add/remove the packages from the suite(s) listed.  The default is <literal>unstable</literal>
  78       </VarListEntry>
  79
  80       <VarListEntry><term><option>-S/--source-only</option></>
  81         <ListItem><Para>
  82             Only look at source packages.
  83       </VarListEntry>
  84
  85     </VariableList>
  86   </RefSect1>
  87
  88     <refsect1>
  89       <title>How packages are chosen</title>
  90       <para>There are 3 methods for selecting packages.</para>
  91       <itemizedlist>
  92         <listitem>
  93           <para>Source + Binary. (default)</para>
  94           <para>In this mode <command>melanie</command> will assume each of the package(s) passed as arguments are source packages and will also remove any binary packages built from these source packages.</para>
  95         </listitem>
  96         <listitem>
  97           <para>Binary only.</para>
  98           <para>Only binary packages are searched; source packages are ignored.  This mode is chosen by use of the <option>-b/--binary</option> switch.</para>
  99         </listitem>
 100         <listitem>
 101           <para>Source only.</para>
 102           <para>Only source packages are searched; binary packages are ignored.  This mode is chosen by use of the <option>-S/--source</option> switch.</para>
 103         </listitem>
 104       </itemizedlist>
 105     </refsect1>
 106
 107   <refsect1>
 108     <title>Examples</title>
 109     <para></para>
 110   </refsect1>
 111
 112   <RefSect1><Title>Description</>
 113     <para>
 114       <command>melanie</command> is the command line tool to add and remove packages from suites.
 115
 116   <RefSect1><Title>Diagnostics</>
 117     <para>
 118       <command>melanie</command> returns zero on normal operation, non-zero on error.
 119   </RefSect1>
 120
 121   &manauthor;
 122
 123 </refentry>