docs: add 2.4 API reference

Author: natemcmaster

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 [See unreleased changes][unreleased].
 
-## Unreleased
+## [v2.4.0]
 
 * Fix [#227] by [@ejball] - ArgumentEscaper should escape empty string
 * PR [#230] by [@IanG] - Attributes for files and directories that must not exist
@@ -377,7 +377,8 @@ Other:
 [@TheConstructor]: https://github.com/TheConstructor
 [@vpkopylov]: https://github.com/vpkopylov
 
-[unreleased]: https://github.com/natemcmaster/CommandLineUtils/compare/v2.3.4...HEAD
+[unreleased]: https://github.com/natemcmaster/CommandLineUtils/compare/v2.4.0...HEAD
+[v2.4.0]: https://github.com/natemcmaster/CommandLineUtils/compare/v2.3.4...v2.4.0
 [v2.3.4]: https://github.com/natemcmaster/CommandLineUtils/compare/v2.3.3...v2.3.4
 [v2.3.3]: https://github.com/natemcmaster/CommandLineUtils/compare/v2.3.2...v2.3.3
 [v2.3.2]: https://github.com/natemcmaster/CommandLineUtils/compare/v2.3.1...v2.3.2

docs/api/index.md

@@ -4,7 +4,7 @@ uid: latest_api_ref
 API Reference
 =============
 
-**Version 2.3**
+**Version 2.4**
 
 McMaster.Extensions.CommandLineUtils supports three target frameworks.
 

docs/docfx.json

@@ -23,7 +23,8 @@
   "build": {
     "content": [
       { "version": "unstable", "files": ["**/*.yml", "**/*.md"], "src": "obj/unstable", "dest": "unstable" },
-      { "version": "v2.3", "files": ["**/*.yml", "**/*.md"], "exclude": [ "v2.2/", "obj/", "**.meta", "README.md", "filterConfig.yml" ] },
+      { "version": "v2.4", "files": ["**/*.yml", "**/*.md"], "exclude": [ "v2.2/", "v2.3/", "obj/", "**.meta", "README.md", "filterConfig.yml" ] },
+      { "version": "v2.3", "files": ["**/*.yml", "**/*.md"], "src": "v2.3", "dest": "v2.3" },
       { "version": "v2.2", "files": ["**/*.yml", "**/*.md"], "src": "v2.2", "dest": "v2.2" }
     ],
     "resource": [

docs/docs/intro.md

@@ -25,7 +25,7 @@ uid: doc-intro
 
     ```xml
     <ItemGroup>
-    <PackageReference Include="McMaster.Extensions.CommandLineUtils" Version="2.2.5" />
+        <PackageReference Include="McMaster.Extensions.CommandLineUtils" Version="2.4.0" />
     </ItemGroup>
     ```
 

docs/generate.ps1

@@ -24,7 +24,7 @@ try {
         exec git worktree add $targetDir gh-pages 2>&1 | out-null
     }
 
-    $docfxVersion = '2.43.1'
+    $docfxVersion = '2.45.0'
     $docfxRoot = "$buildRoot/packages/docfx.console/$docfxVersion"
     $docfx = "$docfxRoot/tools/docfx.exe"
     if (-not (Test-Path $docfx)) {

docs/samples/Directory.Build.props

@@ -5,7 +5,6 @@
     <!-- Set samples to use the latest stable C# until C# 8 is released -->
     <LangVersion>7.3</LangVersion>
     <Nullable />
-    <NullableContextOptions />
   </PropertyGroup>
 
 </Project>

docs/samples/Directory.Build.targets

@@ -1,12 +1,6 @@
 <Project>
 
-  <PropertyGroup>
-    <!-- TODO: revert when 2.3 is done -->
-    <!--<UsePackage Condition="'$(UsePackage)' == '' AND '$(CI)' != 'true'">false</UsePackage>-->
-    <UsePackage Condition="'$(UsePackage)' == ''">false</UsePackage>
-  </PropertyGroup>
-
-  <ItemGroup Condition="'$(UsePackage)' == 'false'">
+  <ItemGroup Condition="'$(UsePackage)' != 'true'">
     <PackageReference Remove="McMaster.Extensions.CommandLineUtils" />
     <ProjectReference Include="$(MSBuildThisFileDirectory)..\..\src\CommandLineUtils\*.csproj" />
   </ItemGroup>

docs/samples/attributes/Attributes.csproj

@@ -7,7 +7,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="McMaster.Extensions.CommandLineUtils" Version="2.3.0" />
+    <PackageReference Include="McMaster.Extensions.CommandLineUtils" Version="2.4.0" />
   </ItemGroup>
 
 </Project>

docs/samples/custom-attribute/CustomAttribute.csproj

@@ -7,7 +7,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="McMaster.Extensions.CommandLineUtils" Version="2.3.0" />
+    <PackageReference Include="McMaster.Extensions.CommandLineUtils" Version="2.4.0" />
   </ItemGroup>
 
 </Project>

docs/samples/custom-conventions/CustomConvention.csproj

@@ -7,7 +7,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="McMaster.Extensions.CommandLineUtils" Version="2.3.0" />
+    <PackageReference Include="McMaster.Extensions.CommandLineUtils" Version="2.4.0" />
   </ItemGroup>
 
 </Project>