From 75a3362b6ada5dae64d6ca7f6a7bff0fcae956bb Mon Sep 17 00:00:00 2001
From: Otavio Salvador <otavio@ossystems.com.br>
Date: Fri, 2 Nov 2007 13:44:00 -0200
Subject: [PATCH] * Applied patch from Mike O'Connor <stew@vireo.org> to add a
 manpage to   apt-mark, closes: #430207.

---
 debian/apt.manpages |   1 +
 debian/changelog    |   7 +++
 doc/apt-mark.8.xml  | 114 ++++++++++++++++++++++++++++++++++++++++++++
 doc/makefile        |   2 +-
 4 files changed, 123 insertions(+), 1 deletion(-)
 create mode 100644 doc/apt-mark.8.xml

diff --git a/debian/apt.manpages b/debian/apt.manpages
index b52ea3d3d..3c9c8a460 100644
--- a/debian/apt.manpages
+++ b/debian/apt.manpages
@@ -3,6 +3,7 @@ doc/apt-cdrom.8
 doc/apt-config.8
 doc/apt-get.8
 doc/apt-key.8
+doc/apt-mark.8
 doc/apt-secure.8
 doc/apt.8
 doc/apt.conf.5
diff --git a/debian/changelog b/debian/changelog
index ca38be73f..8c1b92f22 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,10 @@
+apt (0.7.10) UNRELEASED; urgency=low
+
+  * Applied patch from Mike O'Connor <stew@vireo.org> to add a manpage to
+    apt-mark, closes: #430207.
+
+ -- Otavio Salvador <otavio@debian.org>  Fri, 02 Nov 2007 13:41:02 -0200
+
 apt (0.7.9) unstable; urgency=low
 
   [ Christian Perrier ]
diff --git a/doc/apt-mark.8.xml b/doc/apt-mark.8.xml
new file mode 100644
index 000000000..5af27a337
--- /dev/null
+++ b/doc/apt-mark.8.xml
@@ -0,0 +1,114 @@
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+<!ENTITY % aptent SYSTEM "apt.ent">
+%aptent;
+
+]>
+
+<refentry>
+
+ <refentryinfo>
+   &apt-author.moconnor;
+   &apt-author.team;
+   &apt-email;
+   &apt-product;
+   <!-- The last update date -->
+   <date>2 November 2007</date>
+ </refentryinfo>
+ 
+ <refmeta>
+   <refentrytitle>apt-mark</refentrytitle>
+   <manvolnum>8</manvolnum>
+ </refmeta>
+ 
+ <!-- Man page title -->
+ <refnamediv>
+    <refname>apt-mark</refname>
+    <refpurpose>Utility to sort package index files</refpurpose>
+ </refnamediv>
+
+ <!-- Arguments -->
+ <refsynopsisdiv>
+   <cmdsynopsis>
+      <command>apt-mark</command>
+      <arg><option>-hv</option></arg>
+      <arg><option>-f=<replaceable>FILENAME</replaceable></option></arg>
+      <group choice="req"><arg>markauto</arg><arg>unmarkauto</arg></group>
+      <arg choice="plain" rep="repeat"><replaceable>package</replaceable></arg>
+   </cmdsynopsis>
+ </refsynopsisdiv>
+ 
+ <refsect1><title>Description</title>
+   <para><command>apt-mark</command> will change whether a package has
+   been marked as being automatically installed.
+   </para>
+   <para>
+     When you request that a package is installed, and as a result
+     other packages are installed to satisfy its dependencies, the
+     depedencies are marked as being automatically installed.  Once
+     these automatically installed packages are no longer depended on
+     by any manually installed packages, they will be removed.
+   </para>
+     <variablelist>
+       <varlistentry><term>markauto</term>
+	 <listitem><para><literal>markauto</literal> is used to mark a
+     package as being automatically installed, which will cause the
+     package to be removed when no more manually installed packages
+     depend on this package.
+       </para></listitem>
+       </varlistentry>
+
+       <varlistentry><term>unmarkauto</term>
+	 <listitem><para><literal>unmarkauto</literal> is used to mark a
+     package as being manually installed, which will prevent the
+     package from being automatically removed if no other packages
+     depend on it.
+       </para></listitem>
+       </varlistentry>
+     </variablelist>
+ </refsect1>
+ 
+ <refsect1><title>options</title>
+   
+   <variablelist>
+     <varlistentry><term><option>-f=<filename>FILENAME</filename></option></term><term><option>--file=<filename>FILENAME</filename></option></term>
+     <listitem><para>
+      
+     Read/Write package stats from <filename>FILENAME</filename>
+     instead of the default location, which
+     is <filename>extended_status</filename> in the directory defined
+     by the Configuration Item: <literal>Dir::State</literal>.</para></listitem>
+     </varlistentry>
+   
+     <varlistentry><term><option>-h</option></term>
+     <term><option>--help</option></term>
+     <listitem><para>Show a short usage summary.
+     </para>
+     </listitem>
+     </varlistentry>
+     
+     <varlistentry>
+      <term><option>-v</option></term>
+      <term><option>--version</option></term>
+      <listitem><para>Show the program version.
+     </para>
+     </listitem>
+     </varlistentry>
+
+     
+   </variablelist>
+ </refsect1>
+
+ <refsect1><title>See Also</title>
+   <para>&apt-conf;</para>
+ </refsect1>
+
+ <refsect1><title>Diagnostics</title>
+   <para><command>apt-mark</command> returns zero on normal operation, non-zero on error.</para>
+ </refsect1>
+
+ &manbugs;
+ 
+</refentry>
diff --git a/doc/makefile b/doc/makefile
index 5f774b825..8a8a04c03 100644
--- a/doc/makefile
+++ b/doc/makefile
@@ -15,7 +15,7 @@ include $(DEBIANDOC_H)
 SOURCE = apt-cache.8 apt-get.8 apt-cdrom.8 apt.conf.5 sources.list.5 \
          apt-config.8 apt_preferences.5  \
          apt-sortpkgs.1 apt-ftparchive.1 apt-extracttemplates.1 \
-	 apt-key.8 apt-secure.8
+	 apt-key.8 apt-secure.8 apt-mark.8
 INCLUDES = apt.ent	 
 include $(XML_MANPAGE_H)
 
-- 
2.45.2