Docs: Clarify linebreak-style docs (fixes #5628)

Author: alberto

docs/rules/README.md

@@ -165,7 +165,7 @@ These rules are purely matters of style and are quite subjective.
 * [jsx-quotes](jsx-quotes.md) - specify whether double or single quotes should be used in JSX attributes (fixable)
 * [key-spacing](key-spacing.md) - enforce spacing between keys and values in object literal properties
 * [keyword-spacing](keyword-spacing.md) - enforce spacing before and after keywords (fixable)
-* [linebreak-style](linebreak-style.md) - disallow mixed 'LF' and 'CRLF' as linebreaks (fixable)
+* [linebreak-style](linebreak-style.md) - enforce linebreak style (fixable)
 * [lines-around-comment](lines-around-comment.md) - enforce empty lines around comments
 * [max-depth](max-depth.md) - specify the maximum depth that blocks can be nested
 * [max-len](max-len.md) - specify the maximum length of a line in your program

docs/rules/linebreak-style.md

@@ -1,4 +1,4 @@
-# Disallow mixing CRLF and LF linebreaks (linebreak-style)
+# Enforce linebreak style (linebreak-style)
 
 When developing with a lot of people all having different editors, VCS applications and operating systems it may occur that
 different line endings are written by either of the mentioned (might especially happen when using the windows and mac versions of SourceTree together).
@@ -12,15 +12,14 @@ Many versioning systems (like git and subversion) can automatically ensure the c
 
 ## Rule Details
 
-This rule aims to ensure having consistent line endings independent of operating system, VCS or editor used.
+This rule aims to ensure having consistent line endings independent of operating system, VCS or editor used across your codebase.
 
 The following patterns are considered problems:
 
 ```js
 /*eslint linebreak-style: 2*/
 
-var a = 'a', // \r\n
-    b = 'b'; // \n
+var a = 'a'; // \r\n
 ```
 
 ```js

lib/rules/linebreak-style.js

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Rule to forbid mixing LF and LFCR line breaks.
+ * @fileoverview Rule to enforce a single linebreak style.
  * @author Erik Mueller
  * @copyright 2015 Varun Verma. All rights reserverd.
  * @copyright 2015 James Whitney. All rights reserved.