Update README with some background info.

Initial stab at describing the purpose of the library and why it might be valuable. Lots of scope for improvement, particularly around describing what a matcher class might look like. Also needs example output. Missing section on using smog matchers in mocks.
Updates to README.

Rewording, punctuation changes and new sections for Issues/Suggestions and
Acknowledgments. Samples section extended to show sample output for
mismatches.
Add /target/ directory to .gitignore
Initial check-in of source code and maven build configuration.
Further tweaks to the README.
Change CompositePropertyMatcher constructor visibility from public to protected.

Its an abstract class so cannot be constructed other than via a subclass.
Updates to javadoc.

Move documentation to public methods in preference to private ones. Add
documentation for some previously undocumented public methods.
Make PathAwareDiagnosingMatcher and TextSubstitutingDescription classes private.

They are not part of the public API.
Correct minor inconsistency in javadoc formatting.
Correct and improve javadoc comments in MatchAccumulator.
Fix formatting inconsistencies in the code for the examples.
Fix code formatting issues in main source code.
Move main code into new 'core' package.
Remove dependence on SLF4J for consumers where logging is not required.

Logging is now optional. Extend CompositePropertyMatcher where logging is
not required. In this case SLF4J is not a required dependency. Where
logging is required, extend LoggingCompositePropertyMatcher -
there will then be a runtime dependency on SLF4J. Consumers can
instead write their own extension to CompositePropertyMatcher to use
alternative logging libraries.
Fix maven warning relating to character encoding.

Explicitly state that we are using UTF-8.
Remove unused PathAware interface from PropertyMatcher.

PropertyMatcher uses a PathProvider but it is always passed in at
construction, so we either need a constructor that doesn't require
a PathProvider or the interface is irrelevant. Opted for the latter
until a requirement exists for post-construction setting of the
PathProvider.
Add unit test cases for PropertyMatcher.
Add unit tests for MatchAccumulator.
Update README.md

Mainly removed issue/suggestion that dependency on SLF4J be removed as that has now been done.
Add unit tests for CompositePropertyMatcher.