From 62efc037328d6cb9bf82d485540327de877e24df Mon Sep 17 00:00:00 2001 From: Gregory Haynes Date: Mon, 15 Aug 2016 12:13:52 -0700 Subject: [PATCH] Clarify OVERWRITE_OLD_IMAGE docs There has been some confusion about what this environment variable controls, and it isnt very clear in the docs. Change-Id: Id21b3c5ce361c4d1121eb7015020235b4c0a2f36 --- doc/source/developer/invocation.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/source/developer/invocation.rst b/doc/source/developer/invocation.rst index 1b47b4f1..e6cab7a9 100644 --- a/doc/source/developer/invocation.rst +++ b/doc/source/developer/invocation.rst @@ -19,7 +19,9 @@ to the end of the path if a path is supplied. By default, the image building scripts will not overwrite existing disk images, allowing you to compare the newly built image with the existing one. To change that behaviour, set the variable -``OVERWRITE_OLD_IMAGE`` to any value that isn't ``0``. +``OVERWRITE_OLD_IMAGE`` to any value that isn't ``0``. If this value is +zero then any existing image will be moved before the new image is +written to the destination. Setting the variable ``DIB_SHOW_IMAGE_USAGE`` will print out a summarised disk-usage report for the final image of files and