Merge pull request #6844 from terminalmage/docs

Add more information on overriding providers
Fixed some typos and bugs.
Add lines for {net,open}bsdservice to State Providers doc

These lines were left incomplete in f15ce62, this commit finishes them.
Initial addition of hash caching in the roots filserver plugin

This will cache the hash/mtime of files on disk in the cache dir so we don't have to re-calculate the hashes on every request.
This includes a function _reap_cache which will reap all the hash caches that the real files no longer exist
Refactor of cache reaping-- now it works for both!
Fix no spaces before operator.
Merge pull request #6847 from terminalmage/docs

Add lines for {net,open}bsdservice to State Providers doc
`communicate()` first returns `stdout` not `stderr`.
Redirect `stderr` to `stdout` if asked.
Redirect `stderr` to `stdout`.
Let's try `Popen`.
'changes' output more verbose on changed states with test=True
Merge pull request #6849 from s0undt3ch/hotfix/lint

Fix no spaces before operator.
Fix sphinx-build errors due to improper indentation

This commit fixes some build errors and also formats the list of flags
as a bulleted list. The previous way this list was formatted did not
have any line breaks.
Merge pull request #6852 from terminalmage/docs

Fix sphinx-build errors due to improper indentation
Remove degugging print statements
Remove non-generic reap_cache
While handling `iorder` on states, skip non string entries.
Also skip non dictionary entries.
Get the package name from `egg=<package-name>`. Refs #6643.