From 77c9def7e8caf13bb1630bc4e3bdc4f2c1853dd4 Mon Sep 17 00:00:00 2001
From: "Eugene V. Lyubimkin" <jackyf@1501-debian>
Date: Sat, 1 Nov 2008 13:19:15 +0200
Subject: Clearly documented '/<release>' and '=<version>' in apt-get.8.

---
 debian/changelog  |  9 +++++----
 doc/apt-get.8.xml | 37 ++++++++++++++++++++++++++++++++-----
 2 files changed, 37 insertions(+), 9 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index ceb5efbdc..da540872e 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -35,12 +35,13 @@ apt (0.7.17) unstable; urgency=low
     - Lowercased short package descriptions.
     - Bumped 'Standards-Version' to 3.8.0, no changes needed.
   * cmdline/apt-cache.cc:
-    - Advanced built-in help. Patch by
-      Andre Felipe Machado <andremachado@techforce.com.br>. (Closes: #286061)
+    - Advanced built-in help. Patch by Andre Felipe Machado. (Closes: #286061)
   * doc/:
     - Substituded 'apt-archive' with 'apt-ftparchive' in docs.
-      Patch based on work of
-      Andre Felipe Machado <andremachado@techforce.com.br>. (Closes: #350865)
+      Patch based on work of Andre Felipe Machado. (Closes: #350865)
+    - Mentioned '/<release>' and '=<version>' for 'apt-get install' and
+      '=<version>' for 'apt-get source'. Patch based on work of Andre Felipe
+      Machado. (Closes: #399673)
 
  -- Eugene V. Lyubimkin <jackyf.devel@gmail.com>  Fri, 24 Oct 2008 23:45:17 +0300
 
diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml
index 2ea6ea1d4..7dc2fedb9 100644
--- a/doc/apt-get.8.xml
+++ b/doc/apt-get.8.xml
@@ -15,7 +15,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>29 February 2004</date>
+   <date>28 October 2008</date>
  </refentryinfo>
  
  <refmeta>
@@ -40,10 +40,30 @@
          <arg>update</arg>
          <arg>upgrade</arg>
          <arg>dselect-upgrade</arg>
-         <arg>install <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
+         <arg>install 
+		 <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable>
+			<group choice='opt'>
+				<arg>
+					=<replaceable>pkg_version_number</replaceable>
+				</arg>
+				<arg>
+					/<replaceable>target_release_name</replaceable>
+				</arg>
+			</group>
+		 </arg>
+	 </arg>
          <arg>remove <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
          <arg>purge <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
-         <arg>source <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
+	 </arg>
+         <arg>source 
+		 <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable>
+			 <group choice='opt'>
+				 <arg>
+					 =<replaceable>pkg_version_number</replaceable>
+				 </arg>
+			 </group>
+		 </arg>
+	 </arg>
          <arg>build-dep <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
          <arg>check</arg>
          <arg>clean</arg>
@@ -495,7 +515,14 @@
  <refsect1><title>Diagnostics</title>
    <para><command>apt-get</command> returns zero on normal operation, decimal 100 on error.</para>
  </refsect1>
-
+ <refsect1>
+	 <title>ORIGINAL AUTHORS</title>
+	 &apt-author.jgunthorpe;
+ </refsect1>
+ <refsect2>
+	 <title>CURRENT AUTHORS</title>
+	 &apt-author.team;
+	 &apt-qapage;
+ </refsect2>
  &manbugs;
- 
 </refentry>
-- 
cgit v1.2.3