diff --git a/README.asciidoc b/README.asciidoc
index b07c336a..99507ab9 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -927,11 +927,11 @@ line using:
 :echo %sh{ ls -l $kak_bufname }
 -------------------------------
 
-Register and Option expansion
------------------------------
+Register, Option and Value expansion
+------------------------------------
 
 Similar to shell expansion, register contents and options values can be
-accessed through %reg{<register>} and %opt{<option>} syntax.
+accessed through +%reg{<register>}+ and +%opt{<option>}+ syntax.
 
 for example you can display last search pattern with
 
@@ -939,6 +939,10 @@ for example you can display last search pattern with
 :echo %reg{/}
 -------------
 
+more generally, value accessible through shell can be accessed with
++%val{<name>}+, with <name> being the environment variable name minus
+the +kak_+ prefix.
+
 Defining Commands
 -----------------