docopt · atifaziz · Dec 24, 2025 · Dec 24, 2025
diff --git a/src/DocoptNet/CodeGeneration/SourceGenerator.cs b/src/DocoptNet/CodeGeneration/SourceGenerator.cs
@@ -252,7 +252,9 @@ static void Generate(CSharpSourceBuilder code,
 
             const string usageConstName = "Usage";
 
-            code["#nullable enable"].NewLine
+            code["// <auto-generated/>"].NewLine
+                .NewLine
+                ["#nullable enable"].NewLine
 
                 .NewLine
                 .Using("System.Collections")

diff --git a/...with_classes_from_different_namespaces_share_the_same_name/Namespace1.ProgramArguments.cs b/...with_classes_from_different_namespaces_share_the_same_name/Namespace1.ProgramArguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...with_classes_from_different_namespaces_share_the_same_name/Namespace2.ProgramArguments.cs b/...with_classes_from_different_namespaces_share_the_same_name/Namespace2.ProgramArguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...s/Generate_with_classes_from_different_namespaces_share_the_same_name/ProgramArguments.cs b/...s/Generate_with_classes_from_different_namespaces_share_the_same_name/ProgramArguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...urceGeneratorTests/Generate_with_classes_in_separate_files/Namespace1.ProgramArguments.cs b/...urceGeneratorTests/Generate_with_classes_in_separate_files/Namespace1.ProgramArguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...urceGeneratorTests/Generate_with_classes_in_separate_files/Namespace2.ProgramArguments.cs b/...urceGeneratorTests/Generate_with_classes_in_separate_files/Namespace2.ProgramArguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...coptNet.Tests/CodeGeneration/SourceGeneratorTests/Generate_with_inline_usage/Arguments.cs b/...coptNet.Tests/CodeGeneration/SourceGeneratorTests/Generate_with_inline_usage/Arguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...ation/SourceGeneratorTests/Generate_with_inline_usage_with_custom_const_name/Arguments.cs b/...ation/SourceGeneratorTests/Generate_with_inline_usage_with_custom_const_name/Arguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments1.cs b/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments1.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments2.cs b/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments2.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments3.cs b/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments3.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments4.cs b/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments4.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments5.cs b/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments5.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments6.cs b/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments6.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments7.cs b/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments7.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments8.cs b/...ts/CodeGeneration/SourceGeneratorTests/Generate_with_multiple_inline_usages/Arguments8.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...on/SourceGeneratorTests/Generate_with_nested_args_class/MyConsoleApp.Program-Arguments.cs b/...on/SourceGeneratorTests/Generate_with_nested_args_class/MyConsoleApp.Program-Arguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/.../CodeGeneration/SourceGeneratorTests/Generate_with_nested_args_class/Program-Arguments.cs b/.../CodeGeneration/SourceGeneratorTests/Generate_with_nested_args_class/Program-Arguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...neration/SourceGeneratorTests/Generate_with_nested_args_class/Program-Nested-Arguments.cs b/...neration/SourceGeneratorTests/Generate_with_nested_args_class/Program-Nested-Arguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...deGeneration/SourceGeneratorTests/Generate_with_nested_namespace/Outer.Inner.Arguments.cs b/...deGeneration/SourceGeneratorTests/Generate_with_nested_namespace/Outer.Inner.Arguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/...eGeneration/SourceGeneratorTests/Generate_with_usage_in_external_file/ProgramArguments.cs b/...eGeneration/SourceGeneratorTests/Generate_with_usage_in_external_file/ProgramArguments.cs
@@ -1,3 +1,5 @@
+// <auto-generated/>
+
 #nullable enable
 
 using System.Collections;

diff --git a/tests/Integration/.editorconfig b/tests/Integration/.editorconfig
@@ -0,0 +1,5 @@
+[*.cs]
+dotnet_analyzer_diagnostic.category-Style.severity = warning
+
+# IDE0055: Fix formatting
+dotnet_diagnostic.IDE0055.severity = suggestion
diff --git a/tests/Integration/DocoptNet.Tests.Integration.csproj b/tests/Integration/DocoptNet.Tests.Integration.csproj
@@ -5,6 +5,10 @@
     <IsPackable>false</IsPackable>
     <RestoreAdditionalProjectSources>$(MSBuildThisFileDirectory)..\..\dist</RestoreAdditionalProjectSources>
     <RestorePackagesPath>$(MSBuildThisFileDirectory).nuget</RestorePackagesPath>
+    <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
+    <!-- Workaround for IDE0005 (Remove unnecessary usings/imports); see https://github.com/dotnet/roslyn/issues/41640 -->
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);CS1591</NoWarn>
   </PropertyGroup>
 
   <ItemGroup>