Comments

src/config/options.rs

@@ -50,9 +50,15 @@ pub enum ControlBraceStyle {
 }
 
 #[config_type]
+/// How to treat the semicolon that is optional for final diverging expressions
+/// (`return`/`break`/`continue`).
 pub enum TrailingSemicolon {
+    /// Always rewrite `return;` and `break;` expressions to have a trailing semicolon,
+    /// unless the block is a single-line block, e.g. `let PAT = e else { return }`.
     Always,
+    /// Always return `return` and `break` expressions to remove the trailing semicolon.
     Never,
+    /// Preserve an existing trailing semicolon if it exists.
     Preserve,
 }