Documented examples for using no-write

README.md

@@ -87,6 +87,39 @@ clean: {
 "Compact" and "Files Array" formats support a few [additional properties](http://gruntjs.com/configuring-tasks#files)
 which help you deal with hidden files, process dynamic mappings and so on.
 
+###### Options
+
+Options can be specified for all `clean` tasks and for each `clean:target`.
+
+####### All tasks
+
+```js
+// Prevents all targets from deleting any files
+clean: {
+  options: {
+    'no-write': true
+  },
+  build: ['dev/build'],
+  release: ['dist']
+}
+```
+
+####### Per-target
+
+```js
+// Will delete files for `build` target
+// Will NOT delete files for `release` target
+clean: {
+  build: ['dev/build'],
+  release: {
+    options: {
+      'no-write': true
+    },
+    src: ['dist']
+  }
+}
+```
+
 
 ## Release History
 
@@ -105,4 +138,4 @@ which help you deal with hidden files, process dynamic mappings and so on.
 
 Task submitted by [Tim Branyen](http://tbranyen.com/)
 
-*This file was generated on Fri Jan 22 2016 11:09:53.*
+*This file was generated on Fri Jan 22 2016 11:11:40.*

docs/clean-examples.md

@@ -38,3 +38,36 @@ clean: {
 
 "Compact" and "Files Array" formats support a few [additional properties](http://gruntjs.com/configuring-tasks#files)
 which help you deal with hidden files, process dynamic mappings and so on.
+
+#### Options
+
+Options can be specified for all `clean` tasks and for each `clean:target`.
+
+##### All tasks
+
+```js
+// Prevents all targets from deleting any files
+clean: {
+  options: {
+    'no-write': true
+  },
+  build: ['dev/build'],
+  release: ['dist']
+}
+```
+
+##### Per-target
+
+```js
+// Will delete files for `build` target
+// Will NOT delete files for `release` target
+clean: {
+  build: ['dev/build'],
+  release: {
+    options: {
+      'no-write': true
+    },
+    src: ['dist']
+  }
+}
+```