Updated content to conform to README best practices template

Before alterations, this content was the module author-determined
description of and instructions for use of the module.

As part of a joint Forge/Docs team effort to standardize formatting and
encourage quality module documentation, a best practices README
template was created via internal and external user testing. That
template was then applied to this module.

I pulled in content from the original README on GitHub. Standard
headings were added (Overview, Module Description, Setup, Usage,
Implementation, etc.) to organize content, existent and pulled-in
content was moved under its appropriate heading and edited for
tone/flow/clarity, and basic formatting was done to adhere to template
standards.
Add parameter for purging vdir

The new parameter $purge_vdir in apache class gives the possibility to disable the purging of the virtual hosts directory.
Enable puppet 3.0.1 in travis.yml

A fix for rodjek/rspec-puppet#58 has been merged which
should allow puppet 3.0.1 to run the spec tests
Build all branches on travis

We should build all branches for travis, otherwise users won't be able to test
their own feature branches.

Signed-off-by: Ken Barber <ken@bob.sh>
Merge branch 'update_travis'

* update_travis:
  Build all branches on travis
  Enable puppet 3.0.1 in travis.yml
Standardize travis and gemfile

This commit standardizes the travis and gemfile to be similar
to the files in stdlib.
Merge pull request #144 from blkperl/update_travis

Standardize travis and gemfile
Updated README content to accurately reflect reworked module

Pre-changes, this README reflected the current apache module. However,
the apache module is being reworked.

This is the updated README to reflect the workings of the new module.
It is only a first draft and will have more updates as questions are
answered and development continues. (This version still contains
self-notes. )
Add setenv/setenvif to apache::vhost

`SetEnv` is used by httpd to set environment variables for vhosts.
`SetEnvIf` is used to conditionally set environment variables.
Add optional purge parameter

Configuration of Apache should be managed by Puppet, as unexpected failures
can happen from erroniously placed configuration files. But in some
cases it may be desired to disable full puppet management for the time
being, and this `purge_configs` parameter will allow that to be
disabled.
Updated content to conform to README best practices template

This README has gone through several drafts. Initially, it was the
module author-determined description of and instructions for use of the
module. I rewrote that README to reflect the Apache module as it was on
GitHub. After a discussion with @hunner , I reworked the README to
reflect his rewriting of the module.

This reworking added sections to reflect the new structuring of the
module, fleshed out content to explain the new features, added a ton of
parameters and examples to guide usage.

This commit is still a draft and is up for review.
Fixed the TOC

I originally just completely wonked out the TOC. Fixed it.
Restrict the versions and add 3.1

~> 2.6 will match 2.7
Merge pull request #159 from richardc/patch-1

Restrict the versions and add 3.1
Correct vhost_ssl.pp
Add priority to default ssl
Adding default_vhost true/false param

Any unmatched virtualhost requests are served by httpd to the
virtualhost configuration that was loaded first. Previously the
`priority` param was used to control `apache::vhost` loading order.

This commit adds a `default_vhost` parameter that should be used instead
of the `priority` parameter, and the priority parameter is only used in
specific cases when specific vhost loading order is required (which
currently do not exist, but may).
Merge pull request #7 from hunner/default_vhost_param

Adding default_vhost true/false param
Merge pull request #4 from hunner/add_setenv

Add setenv/setenvif to apache::vhost
Merge pull request #5 from hunner/optional_purge

Add optional purge parameter