Merge pull request #3608 from olehermanse/3.27-cherry

3.27 cherry-picks

Author: olehermanse

content/examples/_index.markdown

@@ -259,4 +259,9 @@ from the example.
 For example, the LDAP query in `active_directory.cf` needs a domain name.
 In the variable declaration, replace "cftesting" with your domain name:
 
-{{< CFEngine_include_snippet(integrating_the_example_into_your_main_policy.cf, .* ) >}}
+```cf3 {skip TODO}
+vars:
+  # NOTE: Edit this to your domain, e.g. "corp"
+  "domain_name"
+    string => "cftesting";
+```

content/examples/example-snippets/_index.markdown

@@ -12,7 +12,6 @@ aliases:
 - [Software administration examples][Software administration examples]
 - [Commands, scripts, and execution examples][Commands, scripts, and execution examples]
 - [File and directory examples][File and directory examples]
-- [File template examples][File template examples]
 - [Database examples][Database examples]
 - [Network examples][Network examples]
 - [System security examples][System security examples]

content/examples/example-snippets/all_hosts_the_same.cf

@@ -10,7 +10,7 @@ bundle agent central
   vars:
       "policy_server" string => "myhost.domain.tld";
       "mypackages" slist => {
-                              "nagios"
+                              "nagios",
                               "gcc",
                               "apache2",
                               "php5"

content/examples/example-snippets/basic-file-directory.markdown

@@ -76,7 +76,24 @@ Also you could write this using a list variable:
 
 ## Copy files
 
-{{< CFEngine_include_snippet(copy_files.cf, .* ) >}}
+```cf3 {skip TODO}
+files:
+  "/var/cfengine/inputs"
+    handle => "update_policy",
+    perms => m("600"),
+    copy_from => u_scp("$(master_location)",@(policy_server)),
+    depth_search => recurse("inf"),
+    file_select => input_files,
+    action => immediate;
+
+  "/var/cfengine/bin"
+    perms => m("700"),
+    copy_from => u_scp("/usr/local/sbin","localhost"),
+    depth_search => recurse("inf"),
+    file_select => cf3_files,
+    action => immediate,
+    classes => on_change("reload");
+```
 
 ## Copy and flatten directory
 

content/examples/example-snippets/copy_files.cf

@@ -13,11 +13,6 @@ body knowledge control
       sql_type => "postgres";
 }
 
-bundle knowledge dummy
-{
-  topics:
-}
-
 body common control
 {
       bundlesequence => { "databases" };

content/examples/example-snippets/database_creation.cf

@@ -26,11 +26,11 @@ bundle agent testbundle
   files:
       "/tmp/passwd_excerpt"
       create    => "true",
-      edit_line => MarkNRoot;
+      edit_line => mark_n_root;
 }
 ########################################################
 
-bundle edit_line MarkNRoot
+bundle edit_line mark_n_root
 {
   delete_lines:
       "mark.*|root.*" not_matching => "true";

content/examples/example-snippets/deleting_lines_exception.cf

@@ -8,7 +8,7 @@ body common control
 {
       version => "1.2.3";
       inputs => { "$(sys.libdir)/stdlib.cf" };
-      bundlesequence  => { "SetRootPassword" };
+      bundlesequence  => { "set_root_password" };
 }
 ########################################################
 
@@ -19,7 +19,7 @@ bundle common g
 }
 ########################################################
 
-bundle agent SetRootPassword
+bundle agent set_root_password
 {
   vars:
       # Or get variables directly from server with Enterprise
@@ -32,11 +32,11 @@ bundle agent SetRootPassword
       # or $(pw_class)-root.txt
 
       "/tmp/shadow"
-      edit_line => SetRootPw;
+      edit_line => set_root_password;
 }
 ########################################################
 
-bundle edit_line SetRootPw
+bundle edit_line set_root_password
 {
   vars:
       # Assume this file contains a single string of the form root:passwdhash:

content/examples/example-snippets/distribute_root_passwords.cf

@@ -26,18 +26,18 @@ bundle agent testbundle
 
       "/home/mark/tmp/passwd"
       create    => "true",
-      edit_line => SetUserParam("mark","6","/set/this/shell");
+      edit_line => set_user_param("mark","6","/set/this/shell");
 
       "/home/mark/tmp/group"
       create    => "true",
-      edit_line => AppendUserParam("root","4","@(userset)");
+      edit_line => append_user_param("root","4","@(userset)");
 
   commands:
       "/bin/echo" args => $(userset);
 }
 ########################################################
 
-bundle edit_line SetUserParam(user,field,val)
+bundle edit_line set_user_param(user,field,val)
 {
   field_edits:
       "$(user):.*"
@@ -46,7 +46,7 @@ bundle edit_line SetUserParam(user,field,val)
 }
 ########################################################
 
-bundle edit_line AppendUserParam(user,field,allusers)
+bundle edit_line append_user_param(user,field,allusers)
 {
   vars:
       "val" slist => { @(allusers) };

content/examples/example-snippets/editing_tabular_files.cf

@@ -1,4 +1,4 @@
-bundle agent CFEngine_processes
+bundle agent cfengine_processes
 {
   vars: