Bug#557637: [doc] apt_preferences(5) does not clearly states that a single version gets several priorities

[David Kalnischkies <kalnischkies+debian@gmail.com>]

Hi Tanguy Ortolo,

first of all: Thanks for your patch! :)

2009/11/23 Tanguy Ortolo <tanguy+debian@ortolo.eu>:
> several priorities, one for each place where it is available. This was
> specially difficult with a french version of the manpage, that incorrectly uses
> a singular where the original had a plural.
Unfortunately you have patched the old version while
reporting it against a newer version, so i am not sure
if the typo (?) applies to the old or new version of the french
manpage as the manpage system has seen a great improvement
in 0.7.24: We have now po4a and a new french translation. :)
(CC'ed Christian Perrier to be sure he get the message)

So in short: You only need to patch the english xml files
(and maybe the language po files - i am currently working
 on switching the other languages to po files, so the next
 upload should be po4a-only in this aspect).

> I suggest to add:
> - a note about this fact in the paragraph that introduces the algorithm;
> - a reference to “apt-cache policy”, to illustrate it after the algorithm;
> - a precision about “apt-get upgrade” and “apt-get install”, that will upgrade
>  a package only if the version with the maximal priority is not the same than
>  the installed one.
"We" discuss this issue also currently in #554773 and the
out-coming is in my eyes that we really should clarify it.
So feel free to "rebase" the patch against the new version
and add more explanations. :)


Best regards / Mit freundlichen Grüßen,

David "DonKult" Kalnischkies