Report file validation errors as warnings

For all commands the file validation errors are reported as warnings
but for the validate command, where it is an actual error.
Added missing blank in warning
Merge pull request #412 from SUSE/review_fix_missing_blank

Added missing blank in warning
Add API documentation for the two load methods
Merge branch 'turn_file_validation_errors_into_warning'

Pull request #416
Store description after each inspection task

Instead of storing the complete description after every inspection run
the description is now stored after each inspection taskso the user has
at least some of the data when cancelling the inspection.

Fixes #364
Use underscore for unused method arguments in example classes
Merge pull request #417 from SUSE/store_results_after_each_inspector2

Store description after each inspection task
Fix same scopes are inspected multiple times

Fix issue #303.
Merge pull request #418 from SUSE/fix_same_scope_inspected_multiple

Fix same scopes are inspected multiple times
Handle zypper locks during pattern inspection graceful

Fixes issue #415.
Merge pull request #419 from SUSE/fix_execution_of_zypper_failed

Handle zypper locks during pattern inspection gracefully
Document validation behavior
Clarify role of manifest file
Merge branch 'man_file_validation'

Pull request #420
Move config-file-diffs path to analyze/config_file_diffs

Store analyzed data in analyze directory and store config files diffs
in config_file_diffs subdirectory.
This way the files in the config_files scope are the definitive
reference of what is in the description.

Fixes #363
Add migration to format v3

Changing the config-file-diffs directory needs a migration.
Add Rake task to upgrade test descriptions
Use global CURRENT_FORMAT_VERSION for system_description tests

Since we don't want to use our Factory for the system_description
unit test to not miss errors in our implementation we still use
static json data there.

To not have to change the "format_version" manually each time it
is now replaced automatically by the global CURRENT_FORMAT_VERSION
value.
Upgrade format_version in Factory