~bzr-pqm/bzr/bzr.dev

Brief developer guide entry about confirmations

added added

removed removed

used for programmer convenience, but not performing unpredictably in the

presence of different locales.

Confirmation

------------

There are some operations, such as uncommitting, or breaking a lock, where

bzr may want to get confirmation from the user before proceeding.

However in some circumstances bzr should just go ahead without asking: if

it's being used from a noninteractive program, or if the user's asked to

never be asked for this particular confirmation or for any confirmations

at all.

We provide a special UIFactory method `confirm_action` to do this. It

takes a `confirmation_id` parameter that acts as a symbolic name for the

type of confirmation, so the user can configure them off. (This is not

implemented at present.)

Writing Output

==============