Github user rdowner commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/178#discussion_r115236606
--- Diff: guide/blueprints/config-files.md ---
@@ -0,0 +1,78 @@
+---
+title: Uploading Script and Configuration Files
+layout: website-normal
+toc: ../guide_toc.json
+categories: [use, guide, defining-applications]
+---
+
+Blueprints often require that parameterized scripts and configuration
files are available to be copied to the
+target VM. These must be URLs resolvable from the Brooklyn instance, or on
the Brooklyn classpath. One simple way
+to achieve this is to compile the support files into a .jar, which is then
added to Brooklyn's 'dropins' folder.
+Alternatively, an OSGi bundle can be used, referenced from the catalog
item.
+
+There are two types of file that can be uploaded: plain files and
templated files. A plain
+file is uploaded unmodified. A templated file is interpreted as a
[FreeMarker](http://freemarker.org)
+template. This supports a powerful set of substitutions. In brief,
anything (unescaped) of the form
+`${name}` will be substituted, in this case looking up "name" for the
value to use.
+
+
+### Using files
+
+Files can be referenced as URLs. This includes support for things like
`classpath://mypath/myfile.bat`.
+This looks for the given (fully qualified) resource on the Brooklyn
classpath.
--- End diff --
"... or inside the bundle, if using the OSGI version of Brooklyn with
catalog blueprint" (or similar wording)
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
