diff --git a/docs/features.rst b/docs/features.rst
index 8228e5e8..1eb00d68 100644
--- a/docs/features.rst
+++ b/docs/features.rst
@@ -142,9 +142,12 @@ not need such intensive escaping::
 __ https://docs.python.org/3/library/re.html#re.sub
 
 Remove parent value only if it matches regular expression is done
-using  the ``-~`` suffix.  If value matches any of provided
-`regular expressions`__ it is removed, these regular expressions
-can be just a single item or a list of strings::
+using  the ``-~`` suffix. If value matches any of provided
+`regular expressions`__ it is removed. In the case of parent value
+being a list the item is removed from this list. If the parent value
+is a string value is set to the empty string. If parent value is
+a dictionary, the key is removed. These regular expressions can
+be just a single item or a list of strings::
 
     description-~: '.*'
     require-~: