1. Home /
  2. Option Reference

Core

The foundational file-level settings: indentation style and size, line endings, character encoding, final-newline and trailing-whitespace handling, and max_line_length — the column target that determines whether Curb reflows long lines or runs in preservation mode.

charset
Byte-order mark handling. preserve keeps whatever the file arrived with. Defaults to `preserve`
end_of_line
Line ending to write. auto matches the platform's own (Environment.NewLine), the same default Roslyn uses. Defaults to `auto`
indent_size
Columns per indent level. Defaults to `4`
indent_style
Indent with spaces or tabs. Defaults to `space`
insert_final_newline
Ensure the file ends with a newline. Defaults to `true`
max_line_length
Column target for reflow. off disables reflow entirely and selects preservation mode. Defaults to `off`
tab_width
Columns a tab occupies when measuring line width. Defaults to `4`
trim_trailing_whitespace
Remove trailing whitespace from each line. Defaults to `true`

No pages match your filter.

Previous
Option Reference
Next
New Lines
  • View as Markdown
  • Edit this page
  • Home

  • Why Curb
  • Getting started
    • Installation
  • Design principles
    • Conformance
    • Conformance divergences
    • Performance
    • Reflow
    • Safety
    • AI coding agents
    • Working with existing tooling
    • Syntax and semantic passes
  • Integrations
    • The build integration
    • Cleanup
    • Agent instructions
  • Why not X?
    • CSharpier
    • dotnet format
    • Rider / ReSharper
    • EditorConfig analyzers
  • Option Reference
    • Core
    • New Lines
    • Indentation
    • Spacing
    • Wrapping
    • Blank Lines
    • Expression Bodies
    • Usings
    • Modifiers and Braces
    • Trailing Commas
    • Suppression
  • Known limitations
  • Benchmarks
    • Churn