From b0b35d608457adfdc28dc1c67ae1c4b24d962ef0 Mon Sep 17 00:00:00 2001
From: Florian Festi <florian@festi.info>
Date: Sat, 19 Oct 2019 12:29:56 +0200
Subject: [PATCH] Mention BurnTest in docs and in the burn parameter
 description

---
 boxes/__init__.py                | 2 +-
 documentation/src/usermanual.rst | 9 +++++++--
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/boxes/__init__.py b/boxes/__init__.py
index 65bb8cb..f9ce456 100755
--- a/boxes/__init__.py
+++ b/boxes/__init__.py
@@ -277,7 +277,7 @@ class Boxes:
             help="print reference rectangle with given length (zero to disable)")
         defaultgroup.add_argument(
             "--burn", action="store", type=float, default=0.1,
-            help="burn correction in mm (bigger values for tighter fit)")
+            help='burn correction in mm (bigger values for tighter fit). Use BurnTest in "Parts and Samples" to find the right value.')
 
     @contextmanager
     def saved_context(self):
diff --git a/documentation/src/usermanual.rst b/documentation/src/usermanual.rst
index 146421f..1de13e5 100644
--- a/documentation/src/usermanual.rst
+++ b/documentation/src/usermanual.rst
@@ -70,10 +70,10 @@ basically the radius of the laser - or half the width of the laser cut.
 The value of the burn parameter depends on your laser cutter, the
 material cut and the thickness of the material. In addition it depends
 on whether you want the parts to be over or under sized. Materials
-that are spongy like wood can be cut oversized (larger burn value) to
+that are spongy like wood can be cut oversized (larger burn value) so
 they can be press fitted with some force and may be assembled without
 glue. Brittle materials (like Acrylic) need to be cut undersized to
-leave a gap for glue.
+leave a gap for the glue.
 
 **Note:** The way the burn param works is a bit counter intuitive. Bigger
 burn values make a tighter fit. Smaller values make a looser fit.
@@ -82,6 +82,11 @@ Small changes in the burn param can make a notable difference. Typical
 steps for adjustment are 0.01 or even 0.005mm to choose between
 different amounts of force needed to press plywood together.
 
+To find the right burn value cut out a rectangle and then meassure how
+much smaller it is than its nominal size. The burn value should be
+around half of the difference. To test the fit for several values at
+once you can use the **BurnTest** generator in the "Parts and Samples" section.
+
 format
 ......