Bug#380566: apt: Note the order of packages given to install matters

[Dan Jacobson <jidanni@jidanni.org>]

X-Debbugs-cc: pkg-mediawiki-devel@lists.alioth.debian.org
Package: apt
Version: 0.6.44.1
Severity: normal

At the bottom of the "install" section of the apt-get man page, add:

Note the order of packages given to install matters!
$ set mediawiki1.5 php5 php5-mysql
$ for i in "$1 $2 $3" "$1 $3 $2" "$2 $1 $3" "$2 $3 $1" "$3 $1 $2" "$3 $2 $1";
do apt-get --print-uris -q -y install $i; done|grep 'Need to get'
Need to get 5194kB of archives.
Need to get 7662kB of archives.
Need to get 7664kB of archives.
Need to get 4986kB of archives.
Need to get 7640kB of archives.
Need to get 5623kB of archives.

And mention how this is intentional and a feature and show how it can
be used advantageously.  E.g., apt cannot know if the user prefers a
smaller download or a different mix of packages, etc.