Merge pull request #5046 from nickanderson/simple-small-examples-files-promise-type-docs/master

Core examples for simple small examples to files promise type docs

Author: nickanderson

examples/files-content-if-fileexists.cf

@@ -0,0 +1,23 @@
+#+begin_src prep
+#@ ```
+#@ rm -f /tmp/hello && touch /tmp/hello
+#@ ```
+#+end_src
+#+begin_src cfengine3
+body agent control
+{
+        inform => "true";
+}
+bundle agent __main__
+{
+  files:
+    "/tmp/hello"
+      content => "Hello, CFEngine",
+      if => fileexists("/tmp/hello");
+}
+#+end_src
+#+begin_src example_output
+#@ ```
+#@    info: Updated file '/tmp/hello' with content 'Hello, CFEngine'
+#@ ```
+#+end_src

examples/files-content-with.cf

@@ -0,0 +1,24 @@
+#+begin_src prep
+#@ ```
+#@ test -e /tmp/hello && rm /tmp/hello
+#@ ```
+#+end_src
+#+begin_src cfengine3
+body agent control
+{
+        inform => "true";
+}
+bundle agent __main__
+{
+  files:
+      "/tmp/hello"
+        content => "Output from stat: $(with)",
+        with => execresult( 'stat -c "%U" /', "useshell" );
+}
+#+end_src
+#+begin_src example_output
+#@ ```
+#@    info: Created file '/tmp/hello', mode 0600
+#@    info: Updated file '/tmp/hello' with content 'Output from stat: root'
+#@ ```
+#+end_src

examples/files-content.cf

@@ -0,0 +1,23 @@
+#+begin_src prep
+#@ ```
+#@ test -e /tmp/hello && rm -f /tmp/hello
+#@ ```
+#+end_src
+#+begin_src cfengine3
+body agent control
+{
+        inform => "true";
+}
+bundle agent __main__
+{
+  files:
+    "/tmp/hello"
+      content => "Hello, CFEngine";
+}
+#+end_src
+#+begin_src example_output
+#@ ```
+#@    info: Created file '/tmp/hello', mode 0600
+#@    info: Updated file '/tmp/hello' with content 'Hello, CFEngine'
+#@ ```
+#+end_src

examples/files-create-class-expression.cf

@@ -0,0 +1,23 @@
+#+begin_src prep
+#@ ```
+#@ test -e /tmp/linux && rm /tmp/linux
+#@ ```
+#+end_src
+#+begin_src cfengine3
+body agent control
+{
+      inform => "true";
+}
+bundle agent __main__
+{
+  files:
+    linux::
+      "/tmp/linux"
+        create => "true";
+}
+#+end_src
+#+begin_src example_output
+#@ ```
+#@    info: Created file '/tmp/linux', mode 0600
+#@ ```
+#+end_src