From d44b7ada14582ab471b369743f374b6f00f07f47 Mon Sep 17 00:00:00 2001
From: Matthew Fisher <mfisher@deis.com>
Date: Thu, 16 Mar 2017 15:02:25 -0700
Subject: [PATCH] document toYaml syntax in --set for annotations

---
 docs/using_helm.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/using_helm.md b/docs/using_helm.md
index 2ecbee0b6..76bc35a96 100755
--- a/docs/using_helm.md
+++ b/docs/using_helm.md
@@ -270,6 +270,15 @@ a backslash to escape the characters; `--set name=value1\,value2` will become:
 name: "value1,value2"
 ```
 
+Similarly, you can escape dot sequences as well, which may come in handy when charts use the
+`toYaml` function to parse annotations, labels and node selectors. The syntax for
+`--set nodeSelector."kubernetes\.io/role"=master` becomes:
+
+```yaml
+nodeSelector:
+  kubernetes.io/role: master
+```
+
 The `--set` syntax is not as expressive as YAML, especially when it comes to
 collections. And there is currently no method for expressing things such as "set
 the third item in a list to...".