From e498c59a29d731e5340b3282f614f9dd06ba7580 Mon Sep 17 00:00:00 2001
From: Jonathon Marolf <jmarolf@microsoft.com>
Date: Wed, 10 Mar 2021 21:23:52 -0800
Subject: [PATCH 1/6] Add separate command for binary log

---
 src/CodeFormatter.cs                                |  8 ++++----
 src/FormatCommand.cs                                |  9 ++++++++-
 src/Program.cs                                      |  3 ++-
 src/Resources.resx                                  |  5 ++++-
 src/Workspaces/MSBuildWorkspaceLoader.cs            | 11 +++++------
 src/dotnet-format.csproj                            |  2 +-
 src/xlf/Resources.cs.xlf                            |  5 +++++
 src/xlf/Resources.de.xlf                            |  5 +++++
 src/xlf/Resources.es.xlf                            |  5 +++++
 src/xlf/Resources.fr.xlf                            |  5 +++++
 src/xlf/Resources.it.xlf                            |  5 +++++
 src/xlf/Resources.ja.xlf                            |  5 +++++
 src/xlf/Resources.ko.xlf                            |  5 +++++
 src/xlf/Resources.pl.xlf                            |  5 +++++
 src/xlf/Resources.pt-BR.xlf                         |  5 +++++
 src/xlf/Resources.ru.xlf                            |  5 +++++
 src/xlf/Resources.tr.xlf                            |  5 +++++
 src/xlf/Resources.zh-Hans.xlf                       |  5 +++++
 src/xlf/Resources.zh-Hant.xlf                       |  5 +++++
 tests/Analyzers/ThirdPartyAnalyzerFormatterTests.cs |  2 +-
 tests/ProgramTests.cs                               |  1 +
 tests/dotnet-format.UnitTests.csproj                |  2 +-
 22 files changed, 92 insertions(+), 16 deletions(-)

diff --git a/src/CodeFormatter.cs b/src/CodeFormatter.cs
index 6fcef04741..244c61e9bc 100644
--- a/src/CodeFormatter.cs
+++ b/src/CodeFormatter.cs
@@ -32,7 +32,7 @@ internal static class CodeFormatter
             FormatOptions formatOptions,
             ILogger logger,
             CancellationToken cancellationToken,
-            bool createBinaryLog = false)
+            string? binaryLogPath = null)
         {
             var logWorkspaceWarnings = formatOptions.LogLevel == LogLevel.Trace;
 
@@ -44,7 +44,7 @@ internal static class CodeFormatter
 
             using var workspace = formatOptions.WorkspaceType == WorkspaceType.Folder
                 ? OpenFolderWorkspace(formatOptions.WorkspaceFilePath, formatOptions.FileMatcher)
-                : await OpenMSBuildWorkspaceAsync(formatOptions.WorkspaceFilePath, formatOptions.WorkspaceType, createBinaryLog, logWorkspaceWarnings, logger, cancellationToken).ConfigureAwait(false);
+                : await OpenMSBuildWorkspaceAsync(formatOptions.WorkspaceFilePath, formatOptions.WorkspaceType, binaryLogPath, logWorkspaceWarnings, logger, cancellationToken).ConfigureAwait(false);
 
             if (workspace is null)
             {
@@ -123,12 +123,12 @@ private static Workspace OpenFolderWorkspace(string workspacePath, SourceFileMat
         private static Task<Workspace?> OpenMSBuildWorkspaceAsync(
             string solutionOrProjectPath,
             WorkspaceType workspaceType,
-            bool createBinaryLog,
+            string? binaryLogPath,
             bool logWorkspaceWarnings,
             ILogger logger,
             CancellationToken cancellationToken)
         {
-            return MSBuildWorkspaceLoader.LoadAsync(solutionOrProjectPath, workspaceType, createBinaryLog, logWorkspaceWarnings, logger, cancellationToken);
+            return MSBuildWorkspaceLoader.LoadAsync(solutionOrProjectPath, workspaceType, binaryLogPath, logWorkspaceWarnings, logger, cancellationToken);
         }
 
         private static async Task<Solution> RunCodeFormattersAsync(
diff --git a/src/FormatCommand.cs b/src/FormatCommand.cs
index 0de958fa97..db76c92b79 100644
--- a/src/FormatCommand.cs
+++ b/src/FormatCommand.cs
@@ -3,6 +3,7 @@
 using System;
 using System.CommandLine;
 using System.CommandLine.Parsing;
+using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
 
@@ -10,7 +11,7 @@ namespace Microsoft.CodeAnalysis.Tools
 {
     internal static class FormatCommand
     {
-        // This delegate should be kept in Sync with the FormatCommand options and arguement names
+        // This delegate should be kept in Sync with the FormatCommand options and argument names
         // so that values bind correctly.
         internal delegate Task<int> Handler(
             string? workspace,
@@ -25,6 +26,7 @@ internal static class FormatCommand
             string[] exclude,
             string? report,
             bool includeGenerated,
+            string? binarylog,
             IConsole console);
 
         internal static string[] VerbosityLevels => new[] { "q", "quiet", "m", "minimal", "n", "normal", "d", "detailed", "diag", "diagnostic" };
@@ -75,6 +77,11 @@ internal static RootCommand CreateCommandLineOptions()
                 {
                     IsHidden = true
                 },
+                new Option(new[] {"--binarylog", "-bl" }, Resources.Log_all_project_or_solution_load_information_to_a_binary_log_file)
+                {
+                    Argument = new Argument<string?>(
+                        () => Path.Combine(Environment.CurrentDirectory, "formatDiagnosticLog.binlog") ) { Name = "binary-log-path" }.LegalFilePathsOnly()
+                },
             };
 
             rootCommand.Description = "dotnet-format";
diff --git a/src/Program.cs b/src/Program.cs
index 99a349306e..e533a74cfa 100644
--- a/src/Program.cs
+++ b/src/Program.cs
@@ -55,6 +55,7 @@ private static async Task<int> Main(string[] args)
             string[] exclude,
             string? report,
             bool includeGenerated,
+            string? binarylog,
             IConsole console = null!)
         {
             if (s_parseResult == null)
@@ -182,7 +183,7 @@ private static async Task<int> Main(string[] args)
                     formatOptions,
                     logger,
                     cancellationTokenSource.Token,
-                    createBinaryLog: logLevel == LogLevel.Trace).ConfigureAwait(false);
+                    binaryLogPath: binarylog).ConfigureAwait(false);
 
                 return GetExitCode(formatResult, check);
             }
diff --git a/src/Resources.resx b/src/Resources.resx
index 3df29ecc26..b3120bb4af 100644
--- a/src/Resources.resx
+++ b/src/Resources.resx
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
+<?xml version="1.0" encoding="utf-8"?>
 <root>
   <!--
     Microsoft ResX Schema
@@ -321,4 +321,7 @@
   <data name="Replace_0_characters_with_1" xml:space="preserve">
     <value>Replace {0} characters with '{1}'.</value>
   </data>
+  <data name="Log_all_project_or_solution_load_information_to_a_binary_log_file" xml:space="preserve">
+    <value>Log all project or solution load information to a binary log file.</value>
+  </data>
 </root>
\ No newline at end of file
diff --git a/src/Workspaces/MSBuildWorkspaceLoader.cs b/src/Workspaces/MSBuildWorkspaceLoader.cs
index 97f0f7f118..d7ae5a4b19 100644
--- a/src/Workspaces/MSBuildWorkspaceLoader.cs
+++ b/src/Workspaces/MSBuildWorkspaceLoader.cs
@@ -3,7 +3,6 @@
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
-using System.IO;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.CodeAnalysis.MSBuild;
@@ -19,7 +18,7 @@ internal static class MSBuildWorkspaceLoader
         public static async Task<Workspace?> LoadAsync(
             string solutionOrProjectPath,
             WorkspaceType workspaceType,
-            bool createBinaryLog,
+            string? binaryLogPath,
             bool logWorkspaceWarnings,
             ILogger logger,
             CancellationToken cancellationToken)
@@ -35,11 +34,11 @@ internal static class MSBuildWorkspaceLoader
             var workspace = MSBuildWorkspace.Create(properties);
 
             Build.Framework.ILogger? binlog = null;
-            if (createBinaryLog)
+            if (binaryLogPath is not null)
             {
                 binlog = new Build.Logging.BinaryLogger()
                 {
-                    Parameters = Path.Combine(Environment.CurrentDirectory, "formatDiagnosticLog.binlog"),
+                    Parameters = binaryLogPath,
                     Verbosity = Build.Framework.LoggerVerbosity.Diagnostic,
                 };
             }
@@ -98,7 +97,7 @@ static void LogWorkspaceDiagnostics(ILogger logger, bool logWorkspaceWarnings, I
         internal static async Task<Workspace?> LockedLoadAsync(
             string solutionOrProjectPath,
             WorkspaceType workspaceType,
-            bool createBinaryLog,
+            string? binaryLogPath,
             bool logWorkspaceWarnings,
             ILogger logger,
             CancellationToken cancellationToken)
@@ -106,7 +105,7 @@ static void LogWorkspaceDiagnostics(ILogger logger, bool logWorkspaceWarnings, I
             await Guard.WaitAsync();
             try
             {
-                return await LoadAsync(solutionOrProjectPath, workspaceType, createBinaryLog, logWorkspaceWarnings, logger, cancellationToken);
+                return await LoadAsync(solutionOrProjectPath, workspaceType, binaryLogPath, logWorkspaceWarnings, logger, cancellationToken);
             }
             finally
             {
diff --git a/src/dotnet-format.csproj b/src/dotnet-format.csproj
index 4287e6dc5c..33efbe40af 100644
--- a/src/dotnet-format.csproj
+++ b/src/dotnet-format.csproj
@@ -3,7 +3,7 @@
   <PropertyGroup>
     <TargetFramework>netcoreapp2.1</TargetFramework>
     <OutputType>Exe</OutputType>
-    <LangVersion>8.0</LangVersion>
+    <LangVersion>9.0</LangVersion>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
     <RootNamespace>Microsoft.CodeAnalysis.Tools</RootNamespace>
     <ServerGarbageCollection>true</ServerGarbageCollection>
diff --git a/src/xlf/Resources.cs.xlf b/src/xlf/Resources.cs.xlf
index 8690b56e73..9cbc2df8b9 100644
--- a/src/xlf/Resources.cs.xlf
+++ b/src/xlf/Resources.cs.xlf
@@ -167,6 +167,11 @@
         <target state="translated">Načítá se pracovní prostor.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">{0} obsahuje více souborů projektů MSBuild. Určete, který soubor chcete použít, pomocí argumentu &lt;workspace&gt;.</target>
diff --git a/src/xlf/Resources.de.xlf b/src/xlf/Resources.de.xlf
index 9e1bc2e10a..b3b711d5c7 100644
--- a/src/xlf/Resources.de.xlf
+++ b/src/xlf/Resources.de.xlf
@@ -167,6 +167,11 @@
         <target state="translated">Arbeitsbereich wird geladen.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">In "{0}" wurden mehrere MSBuild-Projektdateien gefunden. Geben Sie die zu verwendende Datei mit dem &lt;workspace&gt;-Argument an.</target>
diff --git a/src/xlf/Resources.es.xlf b/src/xlf/Resources.es.xlf
index 50fd712070..d6e09e5fe1 100644
--- a/src/xlf/Resources.es.xlf
+++ b/src/xlf/Resources.es.xlf
@@ -167,6 +167,11 @@
         <target state="translated">Cargando área de trabajo.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">Se encontraron varios archivos del proyecto MSBuild en "{0}". Especifique cuál debe usarse con el argumento &lt;workspace&gt;.</target>
diff --git a/src/xlf/Resources.fr.xlf b/src/xlf/Resources.fr.xlf
index 58c3c70de3..c3f3c87c26 100644
--- a/src/xlf/Resources.fr.xlf
+++ b/src/xlf/Resources.fr.xlf
@@ -167,6 +167,11 @@
         <target state="translated">Chargement de l'espace de travail.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">Plusieurs fichiers projet MSBuild trouvés dans '{0}'. Spécifiez celui qui doit être utilisé avec l'argument &lt;espace de travail&gt;.</target>
diff --git a/src/xlf/Resources.it.xlf b/src/xlf/Resources.it.xlf
index c408172201..d64cab46f6 100644
--- a/src/xlf/Resources.it.xlf
+++ b/src/xlf/Resources.it.xlf
@@ -167,6 +167,11 @@
         <target state="translated">Caricamento dell'area di lavoro.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">In '{0}' sono stati trovati più file di progetto MSBuild. Per specificare quello desiderato, usare l'argomento &lt;workspace&gt;.</target>
diff --git a/src/xlf/Resources.ja.xlf b/src/xlf/Resources.ja.xlf
index 6f670844e6..9b18e67b6f 100644
--- a/src/xlf/Resources.ja.xlf
+++ b/src/xlf/Resources.ja.xlf
@@ -167,6 +167,11 @@
         <target state="translated">ワークスペースを読み込んでいます。</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">複数の MSBuild プロジェクト ファイルが '{0}' で見つかりました。使用するものを &lt;workspace&gt; 引数で指定してください。</target>
diff --git a/src/xlf/Resources.ko.xlf b/src/xlf/Resources.ko.xlf
index 9e44cd4d2f..98f05de242 100644
--- a/src/xlf/Resources.ko.xlf
+++ b/src/xlf/Resources.ko.xlf
@@ -167,6 +167,11 @@
         <target state="translated">작업 영역을 로드하는 중입니다.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">'{0}'에 여러 MSBuild 프로젝트 파일이 있습니다. &lt;workspace&gt; 인수를 사용하여 사용할 파일을 지정하세요.</target>
diff --git a/src/xlf/Resources.pl.xlf b/src/xlf/Resources.pl.xlf
index 175f2d84a4..f5494898cd 100644
--- a/src/xlf/Resources.pl.xlf
+++ b/src/xlf/Resources.pl.xlf
@@ -167,6 +167,11 @@
         <target state="translated">Ładowanie obszaru roboczego.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">W elemencie „{0}” znaleziono wiele plików projektów MSBuild. Określ, którego użyć, za pomocą argumentu &lt;workspace&gt;.</target>
diff --git a/src/xlf/Resources.pt-BR.xlf b/src/xlf/Resources.pt-BR.xlf
index 7c87ed614c..dd2d073181 100644
--- a/src/xlf/Resources.pt-BR.xlf
+++ b/src/xlf/Resources.pt-BR.xlf
@@ -167,6 +167,11 @@
         <target state="translated">Carregando espaço de trabalho.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">Foram encontrados vários arquivos de projeto do MSBuild em '{0}'. Especifique qual será usado com o argumento &lt;workspace&gt;.</target>
diff --git a/src/xlf/Resources.ru.xlf b/src/xlf/Resources.ru.xlf
index 7d1cb6fc9d..06c330a2bd 100644
--- a/src/xlf/Resources.ru.xlf
+++ b/src/xlf/Resources.ru.xlf
@@ -167,6 +167,11 @@
         <target state="translated">Загрузка рабочей области.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">В "{0}" обнаружено несколько файлов проекта MSBuild. Укажите используемый файл с помощью аргумента &lt;workspace&gt;.</target>
diff --git a/src/xlf/Resources.tr.xlf b/src/xlf/Resources.tr.xlf
index 568269c879..c7b9baedcb 100644
--- a/src/xlf/Resources.tr.xlf
+++ b/src/xlf/Resources.tr.xlf
@@ -167,6 +167,11 @@
         <target state="translated">Çalışma alanı yükleniyor.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">'{0}' içinde birden fazla MSBuild proje dosyası bulundu. Hangisinin &lt;çalışma alanı&gt; bağımsız değişkeni ile kullanılacağını belirtin.</target>
diff --git a/src/xlf/Resources.zh-Hans.xlf b/src/xlf/Resources.zh-Hans.xlf
index 6f06c6f56f..fa36abc902 100644
--- a/src/xlf/Resources.zh-Hans.xlf
+++ b/src/xlf/Resources.zh-Hans.xlf
@@ -167,6 +167,11 @@
         <target state="translated">正在加载工作区。</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">在“{0}”中找到多个 MSBuild 项目文件。请指定要用于 &lt;workspace&gt; 参数的文件。</target>
diff --git a/src/xlf/Resources.zh-Hant.xlf b/src/xlf/Resources.zh-Hant.xlf
index 3b4b93e99e..fb5e683eb3 100644
--- a/src/xlf/Resources.zh-Hant.xlf
+++ b/src/xlf/Resources.zh-Hant.xlf
@@ -167,6 +167,11 @@
         <target state="translated">正在載入工作區。</target>
         <note />
       </trans-unit>
+      <trans-unit id="Log_all_project_or_solution_load_information_to_a_binary_log_file">
+        <source>Log all project or solution load information to a binary log file.</source>
+        <target state="new">Log all project or solution load information to a binary log file.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Multiple_MSBuild_project_files_found_in_0_Specify_which_to_use_with_the_workspace_argument">
         <source>Multiple MSBuild project files found in '{0}'. Specify which to use with the &lt;workspace&gt; argument.</source>
         <target state="translated">在 '{0}' 中找到多個 MSBuild 專案檔。請指定要用於 &lt;workspace&gt; 引數的檔案。</target>
diff --git a/tests/Analyzers/ThirdPartyAnalyzerFormatterTests.cs b/tests/Analyzers/ThirdPartyAnalyzerFormatterTests.cs
index 61d3755866..c7aca03255 100644
--- a/tests/Analyzers/ThirdPartyAnalyzerFormatterTests.cs
+++ b/tests/Analyzers/ThirdPartyAnalyzerFormatterTests.cs
@@ -43,7 +43,7 @@ public async Task InitializeAsync()
                 var workspacePath = Path.Combine(TestProjectsPathHelper.GetProjectsDirectory(), s_analyzerProjectFilePath);
 
                 MSBuildRegistrar.RegisterInstance(logger);
-                var analyzerWorkspace = await MSBuildWorkspaceLoader.LockedLoadAsync(workspacePath, WorkspaceType.Project, createBinaryLog: false, logWorkspaceWarnings: true, logger, CancellationToken.None);
+                var analyzerWorkspace = await MSBuildWorkspaceLoader.LockedLoadAsync(workspacePath, WorkspaceType.Project, binaryLogPath: null, logWorkspaceWarnings: true, logger, CancellationToken.None);
 
                 // From this project we can get valid AnalyzerReferences to add to our test project.
                 _analyzerReferencesProject = analyzerWorkspace.CurrentSolution.Projects.Single();
diff --git a/tests/ProgramTests.cs b/tests/ProgramTests.cs
index cdd40cb2bf..9cbcdfcb9c 100644
--- a/tests/ProgramTests.cs
+++ b/tests/ProgramTests.cs
@@ -191,6 +191,7 @@ public async Task CommandLine_AllArguments_Bind()
                 string[] exclude,
                 string report,
                 bool includeGenerated,
+                string binaryLogPath,
                 IConsole console = null)
             {
                 Assert.Equal("./src", workspace);
diff --git a/tests/dotnet-format.UnitTests.csproj b/tests/dotnet-format.UnitTests.csproj
index d903ec4fce..0d7548f54b 100644
--- a/tests/dotnet-format.UnitTests.csproj
+++ b/tests/dotnet-format.UnitTests.csproj
@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <TargetFramework>netcoreapp2.1</TargetFramework>
-    <LangVersion>8.0</LangVersion>
+    <LangVersion>9.0</LangVersion>
     <IsPackable>false</IsPackable>
     <RootNamespace>Microsoft.CodeAnalysis.Tools.Tests</RootNamespace>
 

From ee4a15e6aae02e787023acaa0bbff81ce35cc795 Mon Sep 17 00:00:00 2001
From: Jonathon Marolf <jmarolf@users.noreply.github.com>
Date: Thu, 11 Mar 2021 15:59:14 -0800
Subject: [PATCH 2/6] Update src/FormatCommand.cs

Co-authored-by: Joey Robichaud <joseph.robichaud@microsoft.com>
---
 src/FormatCommand.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/FormatCommand.cs b/src/FormatCommand.cs
index db76c92b79..26dddbd15b 100644
--- a/src/FormatCommand.cs
+++ b/src/FormatCommand.cs
@@ -77,7 +77,7 @@ internal static RootCommand CreateCommandLineOptions()
                 {
                     IsHidden = true
                 },
-                new Option(new[] {"--binarylog", "-bl" }, Resources.Log_all_project_or_solution_load_information_to_a_binary_log_file)
+                new Option(new[] { "--binarylog" }, Resources.Log_all_project_or_solution_load_information_to_a_binary_log_file)
                 {
                     Argument = new Argument<string?>(
                         () => Path.Combine(Environment.CurrentDirectory, "formatDiagnosticLog.binlog") ) { Name = "binary-log-path" }.LegalFilePathsOnly()

From 81cf27884e261a5297374329e248f263c90bef0b Mon Sep 17 00:00:00 2001
From: Jonathon Marolf <jmarolf@users.noreply.github.com>
Date: Thu, 11 Mar 2021 16:00:52 -0800
Subject: [PATCH 3/6] Update src/Program.cs

Co-authored-by: Joey Robichaud <joseph.robichaud@microsoft.com>
---
 src/Program.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Program.cs b/src/Program.cs
index e533a74cfa..911c68209d 100644
--- a/src/Program.cs
+++ b/src/Program.cs
@@ -183,7 +183,7 @@ private static async Task<int> Main(string[] args)
                     formatOptions,
                     logger,
                     cancellationTokenSource.Token,
-                    binaryLogPath: binarylog).ConfigureAwait(false);
+                    binaryLogPath: s_parseResult.WasOptionUsed("--binarylog") ? binarylog : null).ConfigureAwait(false);
 
                 return GetExitCode(formatResult, check);
             }

From 97a7cf66947f8e92c18665f518bb52912edf5a5a Mon Sep 17 00:00:00 2001
From: Jonathon Marolf <jmarolf@microsoft.com>
Date: Thu, 11 Mar 2021 20:07:03 -0800
Subject: [PATCH 4/6] add tests and do not allow --folder to be specified with
 --binaryLog

---
 src/FormatCommand.cs          | 14 +++++++++---
 src/Program.cs                | 23 ++++++++++++++++++--
 src/Resources.resx            |  3 +++
 src/xlf/Resources.cs.xlf      |  5 +++++
 src/xlf/Resources.de.xlf      |  5 +++++
 src/xlf/Resources.es.xlf      |  5 +++++
 src/xlf/Resources.fr.xlf      |  5 +++++
 src/xlf/Resources.it.xlf      |  5 +++++
 src/xlf/Resources.ja.xlf      |  5 +++++
 src/xlf/Resources.ko.xlf      |  5 +++++
 src/xlf/Resources.pl.xlf      |  5 +++++
 src/xlf/Resources.pt-BR.xlf   |  5 +++++
 src/xlf/Resources.ru.xlf      |  5 +++++
 src/xlf/Resources.tr.xlf      |  5 +++++
 src/xlf/Resources.zh-Hans.xlf |  5 +++++
 src/xlf/Resources.zh-Hant.xlf |  5 +++++
 tests/ProgramTests.cs         | 41 +++++++++++++++++++++++++++++++++++
 17 files changed, 141 insertions(+), 5 deletions(-)

diff --git a/src/FormatCommand.cs b/src/FormatCommand.cs
index 26dddbd15b..1e845d481e 100644
--- a/src/FormatCommand.cs
+++ b/src/FormatCommand.cs
@@ -3,7 +3,6 @@
 using System;
 using System.CommandLine;
 using System.CommandLine.Parsing;
-using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
 
@@ -79,14 +78,14 @@ internal static RootCommand CreateCommandLineOptions()
                 },
                 new Option(new[] { "--binarylog" }, Resources.Log_all_project_or_solution_load_information_to_a_binary_log_file)
                 {
-                    Argument = new Argument<string?>(
-                        () => Path.Combine(Environment.CurrentDirectory, "formatDiagnosticLog.binlog") ) { Name = "binary-log-path" }.LegalFilePathsOnly()
+                    Argument = new Argument<string?>(() => null) { Name = "binary-log-path", Arity = ArgumentArity.ZeroOrOne }.LegalFilePathsOnly()
                 },
             };
 
             rootCommand.Description = "dotnet-format";
             rootCommand.AddValidator(EnsureFolderNotSpecifiedWhenFixingStyle);
             rootCommand.AddValidator(EnsureFolderNotSpecifiedWhenFixingAnalyzers);
+            rootCommand.AddValidator(EnsureFolderNotSpecifiedWhenLoggingBinlog);
 
             return rootCommand;
         }
@@ -109,6 +108,15 @@ internal static RootCommand CreateCommandLineOptions()
                 : null;
         }
 
+        internal static string? EnsureFolderNotSpecifiedWhenLoggingBinlog(CommandResult symbolResult)
+        {
+            var folder = symbolResult.ValueForOption<bool>("--folder");
+            var binarylog = symbolResult.OptionResult("--binarylog");
+            return folder && binarylog is not null && !binarylog.IsImplicit
+                ? Resources.Cannot_specify_the_folder_option_when_writing_a_binary_log
+                : null;
+        }
+
         internal static bool WasOptionUsed(this ParseResult result, params string[] aliases)
         {
             return result.Tokens
diff --git a/src/Program.cs b/src/Program.cs
index 911c68209d..fa61749823 100644
--- a/src/Program.cs
+++ b/src/Program.cs
@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft.  All Rights Reserved.  Licensed under the MIT license.  See License.txt in the project root for license information.
+// Copyright (c) Microsoft.  All Rights Reserved.  Licensed under the MIT license.  See License.txt in the project root for license information.
 
 using System;
 using System.Collections.Immutable;
@@ -183,9 +183,28 @@ private static async Task<int> Main(string[] args)
                     formatOptions,
                     logger,
                     cancellationTokenSource.Token,
-                    binaryLogPath: s_parseResult.WasOptionUsed("--binarylog") ? binarylog : null).ConfigureAwait(false);
+                    binaryLogPath: GetBinaryLogPath(s_parseResult, binarylog)).ConfigureAwait(false);
 
                 return GetExitCode(formatResult, check);
+
+                static string? GetBinaryLogPath(ParseResult parseResult, string? binarylog)
+                {
+                    if (parseResult.WasOptionUsed("--binarylog"))
+                    {
+                        if (binarylog is null)
+                        {
+                            return Path.Combine(Directory.GetCurrentDirectory(), "format.binlog");
+                        }
+                        else if (Path.GetExtension(binarylog)?.Equals(".binlog") == false)
+                        {
+                            return Path.ChangeExtension(binarylog, ".binlog");
+                        }
+
+                        return binarylog;
+                    }
+
+                    return null;
+                }
             }
             catch (FileNotFoundException fex)
             {
diff --git a/src/Resources.resx b/src/Resources.resx
index b3120bb4af..4fb17389f6 100644
--- a/src/Resources.resx
+++ b/src/Resources.resx
@@ -324,4 +324,7 @@
   <data name="Log_all_project_or_solution_load_information_to_a_binary_log_file" xml:space="preserve">
     <value>Log all project or solution load information to a binary log file.</value>
   </data>
+  <data name="Cannot_specify_the_folder_option_when_writing_a_binary_log" xml:space="preserve">
+    <value>Cannot specify the '--folder' option when writing a binary log.</value>
+  </data>
 </root>
\ No newline at end of file
diff --git a/src/xlf/Resources.cs.xlf b/src/xlf/Resources.cs.xlf
index 9cbc2df8b9..1203d78735 100644
--- a/src/xlf/Resources.cs.xlf
+++ b/src/xlf/Resources.cs.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">Styl kódu</target>
diff --git a/src/xlf/Resources.de.xlf b/src/xlf/Resources.de.xlf
index b3b711d5c7..9d6369cadb 100644
--- a/src/xlf/Resources.de.xlf
+++ b/src/xlf/Resources.de.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">Codeformat</target>
diff --git a/src/xlf/Resources.es.xlf b/src/xlf/Resources.es.xlf
index d6e09e5fe1..f41fb5db03 100644
--- a/src/xlf/Resources.es.xlf
+++ b/src/xlf/Resources.es.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">Estilo de código</target>
diff --git a/src/xlf/Resources.fr.xlf b/src/xlf/Resources.fr.xlf
index c3f3c87c26..532bb3be5b 100644
--- a/src/xlf/Resources.fr.xlf
+++ b/src/xlf/Resources.fr.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">Style de code</target>
diff --git a/src/xlf/Resources.it.xlf b/src/xlf/Resources.it.xlf
index d64cab46f6..8cc86a3e11 100644
--- a/src/xlf/Resources.it.xlf
+++ b/src/xlf/Resources.it.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">Stile codice</target>
diff --git a/src/xlf/Resources.ja.xlf b/src/xlf/Resources.ja.xlf
index 9b18e67b6f..b95be77f11 100644
--- a/src/xlf/Resources.ja.xlf
+++ b/src/xlf/Resources.ja.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">コード スタイル</target>
diff --git a/src/xlf/Resources.ko.xlf b/src/xlf/Resources.ko.xlf
index 98f05de242..c66a67c2d5 100644
--- a/src/xlf/Resources.ko.xlf
+++ b/src/xlf/Resources.ko.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">코드 스타일</target>
diff --git a/src/xlf/Resources.pl.xlf b/src/xlf/Resources.pl.xlf
index f5494898cd..06fc25c191 100644
--- a/src/xlf/Resources.pl.xlf
+++ b/src/xlf/Resources.pl.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">Styl kodu</target>
diff --git a/src/xlf/Resources.pt-BR.xlf b/src/xlf/Resources.pt-BR.xlf
index dd2d073181..97c0191822 100644
--- a/src/xlf/Resources.pt-BR.xlf
+++ b/src/xlf/Resources.pt-BR.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">Estilo do Código</target>
diff --git a/src/xlf/Resources.ru.xlf b/src/xlf/Resources.ru.xlf
index 06c330a2bd..fb82ae8318 100644
--- a/src/xlf/Resources.ru.xlf
+++ b/src/xlf/Resources.ru.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">Стиль кода</target>
diff --git a/src/xlf/Resources.tr.xlf b/src/xlf/Resources.tr.xlf
index c7b9baedcb..f58dbdc534 100644
--- a/src/xlf/Resources.tr.xlf
+++ b/src/xlf/Resources.tr.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">Kod Stili</target>
diff --git a/src/xlf/Resources.zh-Hans.xlf b/src/xlf/Resources.zh-Hans.xlf
index fa36abc902..a958567835 100644
--- a/src/xlf/Resources.zh-Hans.xlf
+++ b/src/xlf/Resources.zh-Hans.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">代码样式</target>
diff --git a/src/xlf/Resources.zh-Hant.xlf b/src/xlf/Resources.zh-Hant.xlf
index fb5e683eb3..d092011079 100644
--- a/src/xlf/Resources.zh-Hant.xlf
+++ b/src/xlf/Resources.zh-Hant.xlf
@@ -52,6 +52,11 @@
         <target state="new">Cannot specify the '--folder' option when running analyzers.</target>
         <note />
       </trans-unit>
+      <trans-unit id="Cannot_specify_the_folder_option_when_writing_a_binary_log">
+        <source>Cannot specify the '--folder' option when writing a binary log.</source>
+        <target state="new">Cannot specify the '--folder' option when writing a binary log.</target>
+        <note />
+      </trans-unit>
       <trans-unit id="Code_Style">
         <source>Code Style</source>
         <target state="translated">程式碼樣式</target>
diff --git a/tests/ProgramTests.cs b/tests/ProgramTests.cs
index 9cbcdfcb9c..3673563e9a 100644
--- a/tests/ProgramTests.cs
+++ b/tests/ProgramTests.cs
@@ -239,5 +239,46 @@ public async Task CommandLine_AllArguments_Bind()
             Assert.Equal(0, parseResult.Errors.Count);
             Assert.Equal(uniqueExitCode, result);
         }
+
+        [Fact]
+        public void CommandLine_BinaryLog_DoesNotFailIfPathNotSpecified()
+        {
+            // Arrange
+            var sut = FormatCommand.CreateCommandLineOptions();
+
+            // Act
+            var result = sut.Parse(new[] { "--binarylog" });
+
+            // Assert
+            Assert.Equal(0, result.Errors.Count);
+            Assert.True(result.WasOptionUsed("--binarylog"));
+        }
+
+        [Fact]
+        public void CommandLine_BinaryLog_DoesNotFailIfPathIsSpecified()
+        {
+            // Arrange
+            var sut = FormatCommand.CreateCommandLineOptions();
+
+            // Act
+            var result = sut.Parse(new[] { "--binarylog", "log" });
+
+            // Assert
+            Assert.Equal(0, result.Errors.Count);
+            Assert.True(result.WasOptionUsed("--binarylog"));
+        }
+
+        [Fact]
+        public void CommandLine_BinaryLog_FailsIfFolderIsSpecified()
+        {
+            // Arrange
+            var sut = FormatCommand.CreateCommandLineOptions();
+
+            // Act
+            var result = sut.Parse(new[] { "--folder", "--binarylog" });
+
+            // Assert
+            Assert.Equal(1, result.Errors.Count);
+        }
     }
 }

From 55270aeaea5e8241b4cd3864a04b6da3546db0bd Mon Sep 17 00:00:00 2001
From: Jonathon Marolf <jmarolf@microsoft.com>
Date: Thu, 11 Mar 2021 21:07:00 -0800
Subject: [PATCH 5/6] fix formatting

---
 src/Program.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/Program.cs b/src/Program.cs
index fa61749823..6cec2cde0d 100644
--- a/src/Program.cs
+++ b/src/Program.cs
@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft.  All Rights Reserved.  Licensed under the MIT license.  See License.txt in the project root for license information.
+// Copyright (c) Microsoft.  All Rights Reserved.  Licensed under the MIT license.  See License.txt in the project root for license information.
 
 using System;
 using System.Collections.Immutable;
@@ -12,6 +12,7 @@
 using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
+
 using Microsoft.CodeAnalysis.Tools.Logging;
 using Microsoft.CodeAnalysis.Tools.MSBuild;
 using Microsoft.CodeAnalysis.Tools.Utilities;

From dbeb30ff4c3b5fd72f6c0f0f0552b0ab0c64cada Mon Sep 17 00:00:00 2001
From: Jonathon Marolf <jmarolf@microsoft.com>
Date: Fri, 12 Mar 2021 10:38:20 -0800
Subject: [PATCH 6/6] update docs

---
 README.md      | 1 +
 docs/README.md | 1 +
 2 files changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 8f0771559f..3a59c76e57 100644
--- a/README.md
+++ b/README.md
@@ -106,6 +106,7 @@ Options:
   --exclude <exclude>                 A list of relative file or folder paths to exclude from formatting.
   --check                             Formats files without saving changes to disk. Terminates with a non-zero exit code if any files were formatted.
   --report <report>                   Accepts a file path, which if provided, will produce a json report in the given directory.
+  --binarylog <binary-log-path>       Log all project or solution load information to a binary log file.
   --verbosity, -v <verbosity>         Set the verbosity level. Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic]
   --version                           Show version information
 ```
diff --git a/docs/README.md b/docs/README.md
index 362eb74989..08fb125093 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -117,6 +117,7 @@ dotnet format -f --include ./src/ ./tests/ --exclude ./src/submodule-a/ --check
 
 - `--verbosity` - Set the verbosity level. Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic]
 - `--report` - Writes a json file to the given directory. Defaults to 'format-report.json' if no filename given.
+- `--binarylog` - Writes a [binary log file](https://msbuildlog.com/) to help in diagnosing solution or project load errors. Defaults to 'format.binlog' if no filename given.
 
 ### Validate formatting