[Reproducible-commits] [dpkg] 13/17: dpkg(1): Document available database update procedure to set selections

[Holger Levsen]

This is an automated email from the git hooks/post-receive script.

holger pushed a commit to annotated tag 1.16.13
in repository dpkg.

commit 8b7b1f91158117050f7360c425ce08e2c8083f40
Author: Guillem Jover <guillem at debian.org>
Date:   Sun Jul 28 13:26:03 2013 +0200

    dpkg(1): Document available database update procedure to set selections
    
    Cherry picked from commit af2524c23478134ca90d7990127205550c5d1d4d.
    
    Mention that the available database needs to be updated, refer to the
    dpkg FAQ for more details, and add an example when using apt.
    
    Suggested-by: Klaus Ita <koki.eml at gmail.com>
---
 debian/changelog |  2 ++
 man/dpkg.1       | 14 +++++++++++---
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 3168d98..4ccd8d5 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -16,6 +16,8 @@ dpkg (1.16.13) UNRELEASED; urgency=low
   * Clarify that dpkg --set-selections needs an up-to-date available db,
     by documenting it on the dpkg(1) man page, and warning whenever dpkg
     finds unknown packages while setting the selections. Closes: #703092
+  * Improve documentation on how to update the available database before
+    setting package selections. Suggested by Klaus Ita <koki.eml at gmail.com>.
 
   [ Updated scripts translations ]
   * Fix a typo in the German scripts translation.
diff --git a/man/dpkg.1 b/man/dpkg.1
index 7c2e3ff..0196cb8 100644
--- a/man/dpkg.1
+++ b/man/dpkg.1
@@ -23,7 +23,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
 .
-.TH dpkg 1 "2012-06-05" "Debian Project" "dpkg suite"
+.TH dpkg 1 "2013-07-28" "Debian Project" "dpkg suite"
 .SH NAME
 dpkg \- package manager for Debian
 .
@@ -802,8 +802,16 @@ To make a local copy of the package selection states:
 \fB     dpkg \-\-get\-selections >myselections\fP
 .br
 
-You might transfer this file to another computer, and install it there
-with:
+You might transfer this file to another computer, and after having updated
+the available database there with your package manager frontend of choice
+(see https://wiki.debian.org/Teams/Dpkg/FAQ for more details), for example:
+.br
+\fB     avail=`mktemp`\fP
+\fB     apt\-cache dumpavail >"$avail"\fP
+\fB     dpkg \-\-merge\-avail "$avail"\fP
+\fB     rm "$avail"\fP
+.br
+you can install it with:
 .br
 \fB     dpkg \-\-clear\-selections\fP
 \fB     dpkg \-\-set\-selections <myselections\fP

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/reproducible/dpkg.git