Example Tag Assembler and Descriptor + Registration.
Scrutinizer/Travis Fixes.
Support for Inline.
Moved Example resolution from ExampleTag to ExampleAssembler.
Replace Inline Examples inside of <pre> not <pre {scrollable}>

I originally put them in scrollables to account for large examples, but Inline Examples shouldn't be that large, so a simple <pre> should be fine.
Scrutinizer Cleanup.
Merge branch 'tag/example' of github.com:thebeline/phpDocumentor2 into thebeline-tag/example
#48: Refactor @thebeline and @siad007's PR

In this commit I have built on the awesome work done by @thebeline and @siad007
in PR #1227 and PR #115 and added the following:

- Now uses the new configuration objects
- Now supports setting multiple example folders instead of one
- Example folders can be set in the 'files' section of the configuration
- All essential classes are now unit tested
- Moved determination of example location to a new Finder class
- Rewired the classes to make better use of DI
- Generated output is now in Markdown and not in HTML to increase portability
Merge pull request #1392 from mvriel/feature/48

Add full support for the `@example` tag