From 8d1cb6da6e21302c654da3f09de3975af7e4a11f Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Mon, 6 Jun 2016 17:58:00 +0200 Subject: eipp: add Allow-Temporary-Remove-of-Essentials A rather special need option, but the internal planer supports this and we have a testcase for it & sometimes it is hit (as a bug through). The option itself mostly serves as a reminder for implementors that they should be careful with removes and especially temporary removes if they perform any. --- doc/external-installation-planer-protocol.txt | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/external-installation-planer-protocol.txt b/doc/external-installation-planer-protocol.txt index 7760ecf60..2a0bdbee3 100644 --- a/doc/external-installation-planer-protocol.txt +++ b/doc/external-installation-planer-protocol.txt @@ -162,14 +162,22 @@ The following **preference fields** are supported in request stanzas: informational string specifying to which planer this request was send initially. -- *Immediate-Configuration:** (option, unset by default) A boolean value - defining if the planer should try to configure all packages as quickly - as possible (true) or shouldn't perform any kind of immediate +- **Immediate-Configuration:** (option, unset by default) A boolean + value defining if the planer should try to configure all packages as + quickly as possible (true) or shouldn't perform any kind of immediate configuration at all (false). If not explicitly set with this field the planer is free to pick either mode or implementing e.g. a mode which configures only packages immediately if they are flagged as `Essential` (or are dependencies of packages marked as `Essential`). +- **Allow-Temporary-Remove-of-Essentials** (optional, defaults to `no`). + A boolean value allowing the planer (if set to yes) to temporarily + remove an essential package. Associated with the APT::Force-LoopBreak + configuration option its main use is highlighting that planers who do + temporary removes must take special care in terms of essentials. Legit + uses of this option by users is very uncommon, traditionally + a situation in which it is needed indicates a packaging error. + #### Package universe -- cgit v1.2.3