update README with a sample

diff --git a/README b/README
index bfa262f3e8ad96ca5fed771b1ffd52f888e579e2..f69ce9222dc65b8157b90262b372671d6f3eacc8 100644 (file)
--- a/README
+++ b/README
@@ -5,6 +5,55 @@ as well as posts on my blog at www.devco.net
 
 Released under the Apache 2.0 licence
 
+USAGE:
+
+If you wanted a /etc/motd file that listed all the major modules
+on the machine.  And that would be maintained automatically even
+if you just remove the include lines for other modules you could
+use code like below, a sample /etc/motd would be:
+
+Puppet modules on this server:
+
+    -- Apache
+    -- MySQL
+
+
+# class to setup basic motd, include on all nodes
+class motd {
+   concat{"/etc/motd":
+      owner => root,
+      group => root,
+      mode  => 644
+   }
+
+   concat::fragment{"motd_header":
+      content => "\nPuppet modules on this server:\n\n",
+      order   => 1,
+   }
+}
+
+# used by other modules to register themselves in the motd
+define motd::register($content="", $order=10) {
+   if $content == "" {
+      $body = $name
+   } else {
+      $body = $content
+   }
+
+   concat::fragment{"motd_fragment_$name":
+      target  => "/etc/motd",
+      content => "    -- $body\n"
+   }
+}
+
+# a sample apache module
+class apache {
+   include apache::install, apache::config, apache::service
+
+   motd::register{"Apache": }
+}
+
+
 KNOWN ISSUES:
 - In 0.24.8 you will see inintended notifies, if you build a file
   in a run, the next run will also see it as changed.  This is due