Added docs for r:stash

marcpalmer · marcpalmer · commit a21764576de3 · 2012-09-12T14:23:42.000+01:00
diff --git a/grails-app/taglib/org/grails/plugin/resource/ResourceTagLib.groovy b/grails-app/taglib/org/grails/plugin/resource/ResourceTagLib.groovy
@@ -293,7 +293,6 @@ class ResourceTagLib {
         needsResourceLayout()
         
         def trk = request.resourceModuleTracker
-        
         def mandatory = attrs.strict == null ? true : attrs.strict.toString() != 'false'
         def moduleNames
         if (attrs.module) {
diff --git a/src/docs/ref/Tags/stash.gdoc b/src/docs/ref/Tags/stash.gdoc
@@ -0,0 +1,35 @@
+h1. r:stash Tag
+
+Using this tag you can write "inline" content anywhere in your GSP (providing you use Sitemesh layouts) and place into any disposition.
+
+Corresponding [layoutResources|tags] can write these out.
+
+This mechanism is used internally for inline [script|tags] invocations.
+
+Currently only @script@ and @style@ types are supported.
+
+{code:xml}
+<html>
+   <head>
+      <meta name="layout" content="main"/>
+   </head>
+   <body>
+       <r:stash type="style" disposition="head-end">
+          .ugly-inline-style { border: none; }
+       </r:stash>
+
+       <r:stash type="script" disposition="middle">
+          window.alert('This is same as r:script with disposition="middle"'');
+       </r:stash>
+   </body>
+</html>
+{code}
+
+h2. Attributes
+
+* type - Required. The type of the stash - values supported are "script" and "style"
+* disposition - Required. The disposition name to use for the stash.
+
+
+
+
