[Fix #1111] Fix reading of non-UTF-8 files in EndOfLine

The problem was that we used buffer.source.encoding as the file's
encoding when reading it again, but Parser has re-encoded the buffer
so it's always UTF-8. By first reading the file as ascii-8bit
(binary) encoding, and then re-encoding it based on Parser's logic
for recognizing encodings, we should be able to match /\r$/ always.
Merge pull request #1114 from jonas054/fix_1111_eol

[Fix #1111] Fix reading of non-UTF-8 files in EndOfLine
Add section about custom cops [ci skip]
Merge pull request #1099 from geniou/rspec_readme

Add section about custom cops [ci skip]
[Fix #1115] Fix Next to ignore super nodes
Merge pull request #1116 from geniou/next_fix

[Fix #1115] Fix Next when methods invoking super
[Fix #1117] Don't correct indentation for block comments

We choose a simple solution and just avoid auto-correct entirely if
a node contains a block comment.
Add autocorrect to BlockComments cop

Make ordinary comments from block comments. Related to #1117.
Merge pull request #1119 from jonas054/fix_1117_block_comments

Fix block comments
[Fix #1075] More strict limits on when to require trailing comma

When TrailingComma:EnforcedStyleForMultiline is comma, we only
report an offense if each value in the list is on its own line,
and the closing round/square/curly bracket is also on its own line
(as opposed to sharing a line with the last value).
Merge pull request #1121 from jonas054/1075_trailing_comma

[Fix #1075] More strict limits on when to require trailing comma
Failing test: allow parentheses around setter in condition
Auto-correct class-level trivial accessors
Fix bug with --auto-gen-config and RegexpLiteral

The `RegexpLiteral` cop stores a running tally of slashes found inside
regular expressions, which it uses to determine whether the
auto-generated config should disable the cop completely, or just specify
the maximum number of slashes to make the cop pass.

Previously this tally was stored in an instance variable. However, this
doesn't work when run against a project with multiple files, because a
new instance of the cop is created for each file. Thus, we need to store
the running tally in a class-level variable.
[Fix #1123] Setter calls in safe assignment

Support if (a.b = x).
Merge pull request #1125 from jonas054/1123_parentheses

Support setter calls in safe assignment
[Fix #1090] Correct handling of documentation vs annotation comment

Regard comment as valid documentation comment if at least one line
is not an annotation comment.
Rename Rubocop module to RuboCop
Merge pull request #1126 from ggilder/ggilder/fix-regexp-literal-auto-gen

Fix bug with --auto-gen-config and RegexpLiteral
Merge pull request #1127 from jonas054/1090_doc_with_annotation

[Fix #1090] Correct handling of documentation vs annotation comment