[nongnu] elpa/ws-butler 8c495cfca3 16/64: explain meaning of "unobtrusiveness"

[Stefan Kangas]

branch: elpa/ws-butler
commit 8c495cfca3f5e58768a551a4cd425d6f92508896
Author: Le Wang <le.wang@agworld.com.au>
Commit: Le Wang <le.wang@agworld.com.au>

    explain meaning of "unobtrusiveness"
    
    #1
---
 README.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 9f551f1505..1ba6fe6fc6 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,18 @@
 ## ws-butler -- an unobtrusive way to trim spaces from end of line
 
-Only lines touched get trimmed.  
+- Only lines touched get trimmed.  If the white space at end of buffer is
+  changed, then blank lines at the end of buffer are truncated respecting
+  `require-final-newline`
 
-Trimming only happens when saving.
+- Trimming only happens when saving.
+
+## What does unobtrusive mean?
+
+The user is not made explicitly aware when trimming happens.  He keep working
+and the butler takes care of white-space for you.
+
+This means if point is at a location that was trimmed, point is not moved, but
+the data on disk has been cleaned up (revert the buffer to confirm).
 
 ## history