fix: Add docstrings for language-specific setting

Author: anaisbetts

crates/biome_cli/tests/snapshots/main_commands_check/check_help.snap

@@ -71,8 +71,9 @@ The configuration that is contained inside the file `biome.json`
                               its super languages) files.
         --javascript-formatter-indent-width=NUMBER  The size of the indentation applied to
                               JavaScript (and its super languages) files. Default to 2.
-        --javascript-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to
-                              JavaScript (and its super languages) files.
+        --javascript-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to
+                              JavaScript (and its super languages) files. `auto` uses CRLF on
+                              Windows and LF on other platforms.
         --javascript-formatter-line-width=NUMBER  What's the max width of a line applied to
                               JavaScript (and its super languages) files. Defaults to 80.
         --javascript-formatter-quote-style=<double|single>  The type of quotes used in JavaScript
@@ -103,8 +104,9 @@ The configuration that is contained inside the file `biome.json`
                               languages) files.
         --json-formatter-indent-width=NUMBER  The size of the indentation applied to JSON (and its
                               super languages) files. Default to 2.
-        --json-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to JSON (and its
-                              super languages) files.
+        --json-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to JSON (and
+                              its super languages) files. `auto` uses CRLF on Windows and LF on
+                              other platforms.
         --json-formatter-line-width=NUMBER  What's the max width of a line applied to JSON (and its
                               super languages) files. Defaults to 80.
         --json-formatter-trailing-commas=<none|all>  Print trailing commas wherever possible in
@@ -130,8 +132,9 @@ The configuration that is contained inside the file `biome.json`
                               languages) files.
         --css-formatter-indent-width=NUMBER  The size of the indentation applied to CSS (and its
                               super languages) files. Default to 2.
-        --css-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to CSS (and its
-                              super languages) files.
+        --css-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to CSS (and
+                              its super languages) files. `auto` uses CRLF on Windows and LF on
+                              other platforms.
         --css-formatter-line-width=NUMBER  What's the max width of a line applied to CSS (and its
                               super languages) files. Defaults to 80.
         --css-formatter-quote-style=<double|single>  The type of quotes used in CSS code. Defaults
@@ -142,8 +145,8 @@ The configuration that is contained inside the file `biome.json`
         --graphql-formatter-indent-style=<tab|space>  The indent style applied to GraphQL files.
         --graphql-formatter-indent-width=NUMBER  The size of the indentation applied to GraphQL
                               files. Default to 2.
-        --graphql-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to GraphQL
-                              files.
+        --graphql-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to
+                              GraphQL files. `auto` uses CRLF on Windows and LF on other platforms.
         --graphql-formatter-line-width=NUMBER  What's the max width of a line applied to GraphQL
                               files. Defaults to 80.
         --graphql-formatter-quote-style=<double|single>  The type of quotes used in GraphQL code.
@@ -165,8 +168,9 @@ The configuration that is contained inside the file `biome.json`
                               languages) files.
         --html-formatter-indent-width=NUMBER  The size of the indentation applied to HTML (and its
                               super languages) files. Default to 2.
-        --html-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to HTML (and its
-                              super languages) files.
+        --html-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to HTML (and
+                              its super languages) files. `auto` uses CRLF on Windows and LF on
+                              other platforms.
         --html-formatter-line-width=NUMBER  What's the max width of a line applied to HTML (and its
                               super languages) files. Defaults to 80.
         --html-formatter-attribute-position=<multiline|auto>  The attribute position style in HTML

crates/biome_cli/tests/snapshots/main_commands_ci/ci_help.snap

@@ -72,8 +72,9 @@ The configuration that is contained inside the file `biome.json`
                               its super languages) files.
         --javascript-formatter-indent-width=NUMBER  The size of the indentation applied to
                               JavaScript (and its super languages) files. Default to 2.
-        --javascript-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to
-                              JavaScript (and its super languages) files.
+        --javascript-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to
+                              JavaScript (and its super languages) files. `auto` uses CRLF on
+                              Windows and LF on other platforms.
         --javascript-formatter-line-width=NUMBER  What's the max width of a line applied to
                               JavaScript (and its super languages) files. Defaults to 80.
         --javascript-formatter-quote-style=<double|single>  The type of quotes used in JavaScript
@@ -104,8 +105,9 @@ The configuration that is contained inside the file `biome.json`
                               languages) files.
         --json-formatter-indent-width=NUMBER  The size of the indentation applied to JSON (and its
                               super languages) files. Default to 2.
-        --json-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to JSON (and its
-                              super languages) files.
+        --json-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to JSON (and
+                              its super languages) files. `auto` uses CRLF on Windows and LF on
+                              other platforms.
         --json-formatter-line-width=NUMBER  What's the max width of a line applied to JSON (and its
                               super languages) files. Defaults to 80.
         --json-formatter-trailing-commas=<none|all>  Print trailing commas wherever possible in
@@ -131,8 +133,9 @@ The configuration that is contained inside the file `biome.json`
                               languages) files.
         --css-formatter-indent-width=NUMBER  The size of the indentation applied to CSS (and its
                               super languages) files. Default to 2.
-        --css-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to CSS (and its
-                              super languages) files.
+        --css-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to CSS (and
+                              its super languages) files. `auto` uses CRLF on Windows and LF on
+                              other platforms.
         --css-formatter-line-width=NUMBER  What's the max width of a line applied to CSS (and its
                               super languages) files. Defaults to 80.
         --css-formatter-quote-style=<double|single>  The type of quotes used in CSS code. Defaults
@@ -143,8 +146,8 @@ The configuration that is contained inside the file `biome.json`
         --graphql-formatter-indent-style=<tab|space>  The indent style applied to GraphQL files.
         --graphql-formatter-indent-width=NUMBER  The size of the indentation applied to GraphQL
                               files. Default to 2.
-        --graphql-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to GraphQL
-                              files.
+        --graphql-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to
+                              GraphQL files. `auto` uses CRLF on Windows and LF on other platforms.
         --graphql-formatter-line-width=NUMBER  What's the max width of a line applied to GraphQL
                               files. Defaults to 80.
         --graphql-formatter-quote-style=<double|single>  The type of quotes used in GraphQL code.
@@ -166,8 +169,9 @@ The configuration that is contained inside the file `biome.json`
                               languages) files.
         --html-formatter-indent-width=NUMBER  The size of the indentation applied to HTML (and its
                               super languages) files. Default to 2.
-        --html-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to HTML (and its
-                              super languages) files.
+        --html-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to HTML (and
+                              its super languages) files. `auto` uses CRLF on Windows and LF on
+                              other platforms.
         --html-formatter-line-width=NUMBER  What's the max width of a line applied to HTML (and its
                               super languages) files. Defaults to 80.
         --html-formatter-attribute-position=<multiline|auto>  The attribute position style in HTML

crates/biome_cli/tests/snapshots/main_commands_format/format_help.snap

@@ -53,8 +53,9 @@ Formatting options specific to the JavaScript files
                               its super languages) files.
         --javascript-formatter-indent-width=NUMBER  The size of the indentation applied to
                               JavaScript (and its super languages) files. Default to 2.
-        --javascript-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to
-                              JavaScript (and its super languages) files.
+        --javascript-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to
+                              JavaScript (and its super languages) files. `auto` uses CRLF on
+                              Windows and LF on other platforms.
         --javascript-formatter-line-width=NUMBER  What's the max width of a line applied to
                               JavaScript (and its super languages) files. Defaults to 80.
         --javascript-formatter-quote-style=<double|single>  The type of quotes used in JavaScript
@@ -143,8 +144,9 @@ Available options:
                               languages) files.
         --json-formatter-indent-width=NUMBER  The size of the indentation applied to JSON (and its
                               super languages) files. Default to 2.
-        --json-formatter-line-ending=<lf|crlf|cr>  The type of line ending applied to JSON (and its
-                              super languages) files.
+        --json-formatter-line-ending=<lf|crlf|cr|auto>  The type of line ending applied to JSON (and
+                              its super languages) files. `auto` uses CRLF on Windows and LF on
+                              other platforms.
         --json-formatter-line-width=NUMBER  What's the max width of a line applied to JSON (and its
                               super languages) files. Defaults to 80.
         --json-formatter-trailing-commas=<none|all>  Print trailing commas wherever possible in

crates/biome_configuration/src/css.rs

@@ -81,8 +81,8 @@ pub struct CssFormatterConfiguration {
     #[serde(skip_serializing_if = "Option::is_none")]
     pub indent_width: Option<IndentWidth>,
 
-    /// The type of line ending applied to CSS (and its super languages) files.
-    #[bpaf(long("css-formatter-line-ending"), argument("lf|crlf|cr"))]
+    /// The type of line ending applied to CSS (and its super languages) files. `auto` uses CRLF on Windows and LF on other platforms.
+    #[bpaf(long("css-formatter-line-ending"), argument("lf|crlf|cr|auto"))]
     #[serde(skip_serializing_if = "Option::is_none")]
     pub line_ending: Option<LineEnding>,
 

crates/biome_configuration/src/graphql.rs

@@ -50,8 +50,8 @@ pub struct GraphqlFormatterConfiguration {
     #[bpaf(long("graphql-formatter-indent-width"), argument("NUMBER"))]
     pub indent_width: Option<IndentWidth>,
 
-    /// The type of line ending applied to GraphQL files.
-    #[bpaf(long("graphql-formatter-line-ending"), argument("lf|crlf|cr"))]
+    /// The type of line ending applied to GraphQL files. `auto` uses CRLF on Windows and LF on other platforms.
+    #[bpaf(long("graphql-formatter-line-ending"), argument("lf|crlf|cr|auto"))]
     pub line_ending: Option<LineEnding>,
 
     /// What's the max width of a line applied to GraphQL files. Defaults to 80.

crates/biome_configuration/src/html.rs

@@ -65,8 +65,12 @@ pub struct HtmlFormatterConfiguration {
     #[serde(skip_serializing_if = "Option::is_none")]
     pub indent_width: Option<IndentWidth>,
 
-    /// The type of line ending applied to HTML (and its super languages) files.
-    #[bpaf(long("html-formatter-line-ending"), argument("lf|crlf|cr"), optional)]
+    /// The type of line ending applied to HTML (and its super languages) files. `auto` uses CRLF on Windows and LF on other platforms.
+    #[bpaf(
+        long("html-formatter-line-ending"),
+        argument("lf|crlf|cr|auto"),
+        optional
+    )]
     #[serde(skip_serializing_if = "Option::is_none")]
     pub line_ending: Option<LineEnding>,
 

crates/biome_configuration/src/javascript/formatter.rs

@@ -74,10 +74,10 @@ pub struct JsFormatterConfiguration {
     #[serde(skip_serializing_if = "Option::is_none")]
     pub indent_width: Option<IndentWidth>,
 
-    /// The type of line ending applied to JavaScript (and its super languages) files.
+    /// The type of line ending applied to JavaScript (and its super languages) files. `auto` uses CRLF on Windows and LF on other platforms.
     #[bpaf(
         long("javascript-formatter-line-ending"),
-        argument("lf|crlf|cr"),
+        argument("lf|crlf|cr|auto"),
         optional
     )]
     #[serde(skip_serializing_if = "Option::is_none")]

crates/biome_configuration/src/json.rs

@@ -77,8 +77,8 @@ pub struct JsonFormatterConfiguration {
     #[serde(skip_serializing_if = "Option::is_none")]
     pub indent_width: Option<IndentWidth>,
 
-    /// The type of line ending applied to JSON (and its super languages) files.
-    #[bpaf(long("json-formatter-line-ending"), argument("lf|crlf|cr"))]
+    /// The type of line ending applied to JSON (and its super languages) files. `auto` uses CRLF on Windows and LF on other platforms.
+    #[bpaf(long("json-formatter-line-ending"), argument("lf|crlf|cr|auto"))]
     #[serde(skip_serializing_if = "Option::is_none")]
     pub line_ending: Option<LineEnding>,