make directories examples real puppet DSL

[richardc]

People don't read:

directory => [ { path => '/path/to/directory', <directive> => <value> } ],

as psuedo-code example instructing you on how to form an array of hashes, they
read them as puppet DSL examples that they can copy and paste into their
apache::vhost stanzas.

[hunner]

Awesome! This is much better.

One request before merging: could you please add docroot parameters to the examples, as this is still a required parameter (and must match at least one directories entry, iirc).

[richardc]

Sure, updated.