From 814ef86221336c3608317216b675b16673491a12 Mon Sep 17 00:00:00 2001 From: Andrew Brown Date: Sun, 26 Feb 2012 21:46:25 -0500 Subject: [PATCH] added disclaimer to the crop option --- docs/config.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/config.rst b/docs/config.rst index 5473cd3..7d8b1c8 100644 --- a/docs/config.rst +++ b/docs/config.rst @@ -349,6 +349,20 @@ values. The valid configuration keys are listed below. 'crop': (-500, -500, 500, 500), } + .. warning:: + + If you decide to change the bounds on a render, you may find it produces + unexpected results. + + For an expansion to the bounds, because chunks in the new bounds have + the same mtime as the old, tiles will not automatically be updated. You + may need to use :option:`--forcerender` to force those tiles to update. + + For reductions to the bounds, because there is currently no mechanism to + detect tiles that shouldn't exist but do, old tiles may remain and will + not get deleted. The only fix for this currently is to delete that + render directory and render it again with :option:`--forcerender`. + .. _customrendermodes: Custom Rendermodes and Rendermode Primitives