nerdbank-gitversioning 3.11.1-beta → 3.11.93-beta

package/nbgv.cli/tools/net10.0/any/Nerdbank.GitVersioning.xml

@@ -136,6 +136,11 @@
         <member name="M:Nerdbank.GitVersioning.CloudBuildServices.BitbucketCloud.SetCloudBuildVariable(System.String,System.String,System.IO.TextWriter,System.IO.TextWriter)">
             <inheritdoc />
         </member>
+        <member name="F:Nerdbank.GitVersioning.CloudBuildServices.GitHubActions.EnvironmentFileEncoding">
+            <summary>
+            The encoding GitHub Actions uses to read the file identified by the <c>GITHUB_ENV</c> environment variable.
+            </summary>
+        </member>
         <member name="P:Nerdbank.GitVersioning.CloudBuildServices.GitHubActions.IsApplicable">
             <inheritdoc/>
         </member>
@@ -166,6 +171,39 @@
         <member name="M:Nerdbank.GitVersioning.CloudBuildServices.GitHubActions.SetCloudBuildVariable(System.String,System.String,System.IO.TextWriter,System.IO.TextWriter)">
             <inheritdoc/>
         </member>
+        <member name="M:Nerdbank.GitVersioning.CloudBuildServices.GitHubActions.AppendVariable(System.String,System.String,System.String)">
+            <summary>
+            Appends a variable assignment to a GitHub Actions environment file.
+            </summary>
+            <param name="environmentFilePath">The path to the file identified by the <c>GITHUB_ENV</c> environment variable.</param>
+            <param name="name">The name of the variable to set. Must not be empty nor contain a newline.</param>
+            <param name="value">The value to assign to the variable. May be <see langword="null" />, empty, or contain newlines.</param>
+            <remarks>
+            <para>
+            Several MSBuild processes may run concurrently within one GitHub Actions step (e.g. when building
+            many projects or target frameworks in parallel) and every one of them may append to the same file.
+            This method therefore takes an exclusive lock on the file for the duration of the append.
+            </para>
+            <para>
+            The lock is essential on non-Windows platforms because .NET resolves <see cref="F:System.IO.FileMode.Append" />
+            to a seek-to-end at the time the file is opened rather than to the <c>O_APPEND</c> open flag.
+            Concurrent appenders would otherwise each write at the same stale offset, silently overwriting one
+            another and leaving torn lines behind that GitHub Actions rejects with the error
+            <c>Unable to process file command 'env' successfully</c>.
+            </para>
+            </remarks>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.CloudBuildServices.GitHubActions.FormatVariable(System.String,System.String)">
+            <summary>
+            Formats a variable assignment using the syntax that GitHub Actions expects in the <c>GITHUB_ENV</c> file.
+            </summary>
+            <param name="name">The name of the variable.</param>
+            <param name="value">The value of the variable.</param>
+            <returns>A newline-terminated string to append to the environment file.</returns>
+            <remarks>
+            A value that spans multiple lines cannot use the <c>name=value</c> syntax, so a heredoc is used for those.
+            </remarks>
+        </member>
         <member name="T:Nerdbank.GitVersioning.CloudBuildServices.GitLab">
             <summary>
             Cloud build handling for GitLab.
@@ -422,6 +460,9 @@
             Gets the error that occurred.
             </summary>
         </member>
+        <member name="M:Nerdbank.GitVersioning.DisabledGitContext.GetShortUniqueCommitId(System.String,System.Int32)">
+            <inheritdoc/>
+        </member>
         <member name="T:Nerdbank.GitVersioning.FilterPath">
             <summary>
             A filter (include or exclude) representing a repo relative path.
@@ -443,7 +484,12 @@
              <item><c>:!relative/exclusion.txt</c></item>
              <item><c>:^relative/exclusion.txt</c></item>
              <item><c>:^/absolute/exclusion.txt</c></item>
+             <item><c>localization/*/messages.json</c></item>
+             <item><c>src/**/generated?.cs</c></item>
              </list>
+             Asterisks match zero or more characters within a path segment, question marks match one
+             character within a path segment, and a path segment consisting of two asterisks matches
+             zero or more path segments.
              </param>
              <param name="relativeTo">
              Path (relative to the root of the repository) that <paramref name="pathSpec"/> is relative to.
@@ -478,6 +524,11 @@
             Gets a value indicating whether the original pathspec was parsed as a relative path.
             </summary>
         </member>
+        <member name="P:Nerdbank.GitVersioning.FilterPath.HasWildcard">
+            <summary>
+            Gets a value indicating whether this filter contains wildcard characters.
+            </summary>
+        </member>
         <member name="M:Nerdbank.GitVersioning.FilterPath.Excludes(System.String,System.Boolean)">
             <summary>
             Determines if <paramref name="repoRelativePath"/> should be excluded by this <see cref="T:Nerdbank.GitVersioning.FilterPath"/>.
@@ -662,6 +713,11 @@
             Gets a collection of the tags that reference HEAD.
             </summary>
         </member>
+        <member name="P:Nerdbank.GitVersioning.GitContext.IsWorkingTreeDirty">
+            <summary>
+            Gets a value indicating whether the working tree has uncommitted changes.
+            </summary>
+        </member>
         <member name="P:Nerdbank.GitVersioning.GitContext.DotGitPath">
             <summary>
             Gets the path to the .git folder.
@@ -692,6 +748,12 @@
             <param name="engine">The git engine to use.</param>
             <returns>The newly created <see cref="T:Nerdbank.GitVersioning.GitContext"/>.</returns>
         </member>
+        <member name="M:Nerdbank.GitVersioning.GitContext.GetDefaultBranch">
+            <summary>
+            Gets the repository's default branch name.
+            </summary>
+            <returns>The detected default branch name, or <c>master</c> when it cannot be determined.</returns>
+        </member>
         <member name="M:Nerdbank.GitVersioning.GitContext.IsIgnored(System.String)">
             <summary>
             Determines whether a file would be ignored by git based on common .gitignore patterns.
@@ -731,6 +793,14 @@
             <param name="minLength">A minimum length.</param>
             <returns>A string that is at least <paramref name="minLength"/> in length but may be more as required to uniquely identify the git object identified by <see cref="P:Nerdbank.GitVersioning.GitContext.GitCommitId"/>.</returns>
         </member>
+        <member name="M:Nerdbank.GitVersioning.GitContext.GetShortUniqueCommitId(System.String,System.Int32)">
+            <summary>
+            Gets the shortest string that uniquely identifies a specified commit.
+            </summary>
+            <param name="commitId">The commit ID to shorten.</param>
+            <param name="minLength">A minimum length.</param>
+            <returns>A string that is at least <paramref name="minLength"/> in length but may be more as required to uniquely identify the commit.</returns>
+        </member>
         <member name="M:Nerdbank.GitVersioning.GitContext.IsVersionFileChangedInWorkingTree(Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.VersionOptions)">
             <summary>
             Gets a value indicating whether the version file has changed in the working tree.
@@ -749,6 +819,31 @@
             </summary>
             <param name="disposing"><see langword="true" /> to dispose managed and native resources; <see langword="false" /> to only dispose of native resources.</param>
         </member>
+        <member name="M:Nerdbank.GitVersioning.GitContext.GetRemoteNames">
+            <summary>
+            Gets the names of the repository's remotes.
+            </summary>
+            <returns>The remote names.</returns>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.GitContext.GetRemoteDefaultBranch(System.String)">
+            <summary>
+            Gets the default branch advertised by a remote.
+            </summary>
+            <param name="remoteName">The remote name.</param>
+            <returns>The default branch name, or <see langword="null"/> if the remote does not advertise one.</returns>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.GitContext.GetLocalBranchNames">
+            <summary>
+            Gets the names of the repository's local branches.
+            </summary>
+            <returns>The local branch names.</returns>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.GitContext.GetConfiguredDefaultBranch">
+            <summary>
+            Gets the default branch configured for new repositories.
+            </summary>
+            <returns>The configured branch name, or <see langword="null"/> when none is configured.</returns>
+        </member>
         <member name="M:Nerdbank.GitVersioning.GitContext.FindGitDir(System.String)">
             <summary>
             Searches a path and its ancestors for a directory with a .git subdirectory.
@@ -768,6 +863,28 @@
             </summary>
             <returns><see langword="true"/> if GITHUB_ACTOR environment variable is set to "copilot-swe-agent[bot]"; otherwise, <see langword="false"/>.</returns>
         </member>
+        <member name="T:Nerdbank.GitVersioning.GitContext.VersionHeightCalculation">
+            <summary>
+            Describes the version height and the commit that last contributed to it.
+            </summary>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.GitContext.VersionHeightCalculation.#ctor(System.Int32,System.String)">
+            <summary>
+            Initializes a new instance of the <see cref="T:Nerdbank.GitVersioning.GitContext.VersionHeightCalculation"/> struct.
+            </summary>
+            <param name="height">The calculated version height.</param>
+            <param name="commitId">The commit that last contributed to the height.</param>
+        </member>
+        <member name="P:Nerdbank.GitVersioning.GitContext.VersionHeightCalculation.Height">
+            <summary>
+            Gets the calculated version height.
+            </summary>
+        </member>
+        <member name="P:Nerdbank.GitVersioning.GitContext.VersionHeightCalculation.CommitId">
+            <summary>
+            Gets the commit that last contributed to the height.
+            </summary>
+        </member>
         <member name="T:Nerdbank.GitVersioning.GitException">
             <summary>
             The exception which is thrown by the managed Git layer.
@@ -910,6 +1027,9 @@
         <member name="P:Nerdbank.GitVersioning.LibGit2.LibGit2Context.HeadTags">
             <inheritdoc />
         </member>
+        <member name="P:Nerdbank.GitVersioning.LibGit2.LibGit2Context.IsWorkingTreeDirty">
+            <inheritdoc />
+        </member>
         <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.Create(System.String,System.String)">
             <summary>Initializes a new instance of the <see cref="T:Nerdbank.GitVersioning.LibGit2.LibGit2Context"/> class.</summary>
             <param name="path">The path to the .git directory or somewhere in a git working tree.</param>
@@ -931,43 +1051,30 @@
         <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.GetShortUniqueCommitId(System.Int32)">
             <inheritdoc/>
         </member>
-        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.OpenGitRepo(System.String,System.Boolean)">
-            <summary>
-            Opens a <see cref="P:Nerdbank.GitVersioning.LibGit2.LibGit2Context.Repository"/> found at or above a specified path.
-            </summary>
-            <param name="path">The path to the .git directory or the working directory.</param>
-            <param name="useDefaultConfigSearchPaths">
-            Specifies whether to use default settings for looking up global and system settings.
-            <para>
-            By default (<paramref name="useDefaultConfigSearchPaths"/> == <see langword="false"/>), the repository will be configured to only
-            use the repository-level configuration ignoring system or user-level configuration (set using <c>git config --global</c>.
-            Thus only settings explicitly set for the repo will be available.
-            </para>
-            <para>
-            For example using <c>Repository.Configuration.Get{string}("user.name")</c> to get the user's name will
-            return the value set in the repository config or <see langword="null"/> if the user name has not been explicitly set for the repository.
-            </para>
-            <para>
-            When the caller specifies to use the default configuration search paths (<paramref name="useDefaultConfigSearchPaths"/> == <see langword="true"/>)
-            both repository level and global configuration will be available to the repo as well.
-            </para>
-            <para>
-            In this mode, using <c>Repository.Configuration.Get{string}("user.name")</c> will return the
-            value set in the user's global git configuration unless set on the repository level,
-            matching the behavior of the <c>git</c> command.
-            </para>
-            </param>
-            <returns>The <see cref="P:Nerdbank.GitVersioning.LibGit2.LibGit2Context.Repository"/> found for the specified path, or <see langword="null"/> if no git repo is found.</returns>
+        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.GetShortUniqueCommitId(System.String,System.Int32)">
+            <inheritdoc/>
         </member>
         <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.CalculateVersionHeight(Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.VersionOptions)">
             <inheritdoc/>
         </member>
-        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.GetIdAsVersion(Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.VersionOptions,System.Int32)">
+        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.GetIdAsVersion(Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.GitContext.VersionHeightCalculation)">
             <inheritdoc/>
         </member>
         <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.Dispose(System.Boolean)">
             <inheritdoc />
         </member>
+        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.GetRemoteNames">
+            <inheritdoc />
+        </member>
+        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.GetRemoteDefaultBranch(System.String)">
+            <inheritdoc />
+        </member>
+        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.GetLocalBranchNames">
+            <inheritdoc />
+        </member>
+        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2Context.GetConfiguredDefaultBranch">
+            <inheritdoc />
+        </member>
         <member name="T:Nerdbank.GitVersioning.LibGit2.LibGit2GitExtensions">
             <summary>
             Git extension methods.
@@ -1469,11 +1576,6 @@
             Gets a <see cref="T:Nerdbank.GitVersioning.ManagedGit.GitObjectId"/> which represents an empty <see cref="T:Nerdbank.GitVersioning.ManagedGit.GitObjectId"/>.
             </summary>
         </member>
-        <member name="P:Nerdbank.GitVersioning.ManagedGit.GitObjectId.Value">
-            <summary>
-            Gets the 20 byte ID of this object as a span from the <see cref="F:Nerdbank.GitVersioning.ManagedGit.GitObjectId.value"/> field.
-            </summary>
-        </member>
         <member name="M:Nerdbank.GitVersioning.ManagedGit.GitObjectId.Parse(System.ReadOnlySpan{System.Byte})">
             <summary>
             Parses a <see cref="T:System.ReadOnlySpan`1"/> which contains the <see cref="T:Nerdbank.GitVersioning.ManagedGit.GitObjectId"/>
@@ -2280,7 +2382,7 @@
             <summary>
             Parses any committish to an object id.
             </summary>
-            <param name="objectish">Any "objectish" string (e.g. commit ID (partial or full), branch name, tag name, or "HEAD").</param>
+            <param name="objectish">Any "objectish" string (e.g. commit ID (partial or full), branch name, tag name, "HEAD", or a first-parent ancestor).</param>
             <returns>The object ID referenced by <paramref name="objectish"/> if found; otherwise <see langword="null"/>.</returns>
         </member>
         <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.GetTree(Nerdbank.GitVersioning.ManagedGit.GitObjectId)">
@@ -2369,6 +2471,49 @@
         <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.Dispose">
             <inheritdoc/>
         </member>
+        <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.IsWorkingTreeDirty">
+            <summary>
+            Gets a value indicating whether the index or working tree has uncommitted changes.
+            </summary>
+            <returns><see langword="true"/> when the repository is dirty; otherwise, <see langword="false"/>.</returns>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.GetRemoteNames">
+            <summary>
+            Gets the names of the configured remotes that have remote-tracking references.
+            </summary>
+            <returns>The remote names.</returns>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.GetRemoteDefaultBranch(System.String)">
+            <summary>
+            Gets the default branch advertised by a remote.
+            </summary>
+            <param name="remoteName">The remote name.</param>
+            <returns>The default branch name, or <see langword="null"/> if the remote does not advertise one.</returns>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.GetLocalBranchNames">
+            <summary>
+            Gets the names of the local branches, including packed references.
+            </summary>
+            <returns>The local branch names.</returns>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.GetConfigurationValue(System.String,System.String)">
+            <summary>
+            Gets a value from Git configuration.
+            </summary>
+            <param name="section">The configuration section.</param>
+            <param name="name">The configuration value name.</param>
+            <returns>The configured value, or <see langword="null"/> when it is not set.</returns>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.TryReadConfigurationValue(System.String,System.String,System.String,System.String@)">
+            <summary>
+            Attempts to read a value from a git config file.
+            </summary>
+            <param name="configPath">The path to the git config file.</param>
+            <param name="section">The configuration section.</param>
+            <param name="name">The configuration value name.</param>
+            <param name="value">Receives the configuration value when found.</param>
+            <returns><see langword="true"/> if the setting was found; otherwise <see langword="false"/>.</returns>
+        </member>
         <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.TryReadIgnoreCaseFromConfigFile(System.String,System.Boolean@)">
             <summary>
             Attempts to read the core.ignorecase setting from a git config file.
@@ -2798,6 +2943,9 @@
         <member name="P:Nerdbank.GitVersioning.Managed.ManagedGitContext.HeadTags">
             <inheritdoc />
         </member>
+        <member name="P:Nerdbank.GitVersioning.Managed.ManagedGitContext.IsWorkingTreeDirty">
+            <inheritdoc />
+        </member>
         <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.Create(System.String,System.String)">
             <summary>Initializes a new instance of the <see cref="T:Nerdbank.GitVersioning.Managed.ManagedGitContext"/> class.</summary>
             <param name="path">The path to the .git directory or somewhere in a git working tree.</param>
@@ -2816,20 +2964,36 @@
         <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.GetShortUniqueCommitId(System.Int32)">
             <inheritdoc/>
         </member>
+        <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.GetShortUniqueCommitId(System.String,System.Int32)">
+            <inheritdoc/>
+        </member>
         <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.CalculateVersionHeight(Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.VersionOptions)">
             <inheritdoc/>
         </member>
-        <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.GetIdAsVersion(Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.VersionOptions,System.Int32)">
+        <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.GetIdAsVersion(Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.GitContext.VersionHeightCalculation)">
             <inheritdoc/>
         </member>
         <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.Dispose(System.Boolean)">
             <inheritdoc/>
         </member>
-        <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.GetIdAsVersionHelper(Nerdbank.GitVersioning.VersionOptions,System.Int32)">
+        <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.GetRemoteNames">
+            <inheritdoc />
+        </member>
+        <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.GetRemoteDefaultBranch(System.String)">
+            <inheritdoc />
+        </member>
+        <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.GetLocalBranchNames">
+            <inheritdoc />
+        </member>
+        <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.GetConfiguredDefaultBranch">
+            <inheritdoc />
+        </member>
+        <member name="M:Nerdbank.GitVersioning.Managed.ManagedGitContext.GetIdAsVersionHelper(System.Nullable{Nerdbank.GitVersioning.ManagedGit.GitCommit},Nerdbank.GitVersioning.VersionOptions,System.Int32)">
             <summary>
             Encodes a commit from history in a <see cref="T:System.Version"/>
             so that the original commit can be found later.
             </summary>
+            <param name="commit">The commit whose ID should be encoded.</param>
             <param name="versionOptions">The version options applicable at this point (either from commit or working copy).</param>
             <param name="versionHeight">The version height, previously calculated.</param>
             <returns>
@@ -2908,10 +3072,13 @@
         <member name="M:Nerdbank.GitVersioning.NoGitContext.TrySelectCommit(System.String)">
             <inheritdoc/>
         </member>
+        <member name="M:Nerdbank.GitVersioning.NoGitContext.GetShortUniqueCommitId(System.String,System.Int32)">
+            <inheritdoc/>
+        </member>
         <member name="M:Nerdbank.GitVersioning.NoGitContext.CalculateVersionHeight(Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.VersionOptions)">
             <inheritdoc/>
         </member>
-        <member name="M:Nerdbank.GitVersioning.NoGitContext.GetIdAsVersion(Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.VersionOptions,System.Int32)">
+        <member name="M:Nerdbank.GitVersioning.NoGitContext.GetIdAsVersion(Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.GitContext.VersionHeightCalculation)">
             <inheritdoc/>
         </member>
         <member name="M:Nerdbank.GitVersioning.NoGitVersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)">
@@ -2922,7 +3089,8 @@
             Methods for creating releases.
             </summary>
             <remarks>
-            This class authors git commits, branches, etc. and thus must use libgit2 rather than our internal managed implementation which is read-only.
+            This class authors git commits, branches, etc. and thus uses libgit2 rather than our internal managed implementation which is read-only.
+            When commit signing is enabled, it uses the Git CLI to create signed commits.
             </remarks>
         </member>
         <member name="M:Nerdbank.GitVersioning.ReleaseManager.#ctor(System.IO.TextWriter,System.IO.TextWriter)">
@@ -2987,6 +3155,11 @@
             The versionIncrement setting cannot be applied to the current version.
             </summary>
         </member>
+        <member name="F:Nerdbank.GitVersioning.ReleaseManager.ReleasePreparationError.GitCommandFailed">
+            <summary>
+            A Git command required to sign a commit failed.
+            </summary>
+        </member>
         <member name="T:Nerdbank.GitVersioning.ReleaseManager.ReleaseManagerOutputMode">
             <summary>
             Enumerates the output formats supported by <see cref="T:Nerdbank.GitVersioning.ReleaseManager"/>.
@@ -3002,7 +3175,7 @@
             Output information about the release as JSON.
             </summary>
         </member>
-        <member name="M:Nerdbank.GitVersioning.ReleaseManager.PrepareRelease(System.String,System.String,System.Version,System.Nullable{Nerdbank.GitVersioning.VersionOptions.ReleaseVersionIncrement},Nerdbank.GitVersioning.ReleaseManager.ReleaseManagerOutputMode,System.String,System.Boolean)">
+        <member name="M:Nerdbank.GitVersioning.ReleaseManager.PrepareRelease(System.String,System.String,System.Version,System.Nullable{Nerdbank.GitVersioning.VersionOptions.ReleaseVersionIncrement},Nerdbank.GitVersioning.ReleaseManager.ReleaseManagerOutputMode,System.String,System.Boolean,System.Boolean)">
             <summary>
             Prepares a release for the specified directory by creating a release branch and incrementing the version in the current branch.
             </summary>
@@ -3033,11 +3206,14 @@
             <param name="whatIf">
             If true, simulates the prepare-release operation and returns the versions that would be set without making any changes.
             </param>
+            <param name="mergeReleaseBranch">
+            A value indicating whether to merge the release branch back into the current branch.
+            </param>
             <returns>
             A <see cref="T:Nerdbank.GitVersioning.ReleaseManager.ReleaseInfo"/> object containing information about the release when <paramref name="whatIf"/> is true; otherwise null.
             </returns>
         </member>
-        <member name="M:Nerdbank.GitVersioning.ReleaseManager.PrepareReleaseCore(System.String,System.String,System.Version,System.Nullable{Nerdbank.GitVersioning.VersionOptions.ReleaseVersionIncrement},Nerdbank.GitVersioning.ReleaseManager.ReleaseManagerOutputMode,System.String,System.Boolean)">
+        <member name="M:Nerdbank.GitVersioning.ReleaseManager.PrepareReleaseCore(System.String,System.String,System.Version,System.Nullable{Nerdbank.GitVersioning.VersionOptions.ReleaseVersionIncrement},Nerdbank.GitVersioning.ReleaseManager.ReleaseManagerOutputMode,System.String,System.Boolean,System.Boolean)">
             <summary>
             Core implementation of prepare-release functionality that can either simulate or execute the operation.
             </summary>
@@ -3069,6 +3245,9 @@
             <param name="whatIf">
             If true, simulates the prepare-release operation and returns the versions that would be set without making any changes.
             </param>
+            <param name="mergeReleaseBranch">
+            A value indicating whether to merge the release branch back into the current branch.
+            </param>
             <returns>
             A <see cref="T:Nerdbank.GitVersioning.ReleaseManager.ReleaseInfo"/> object containing information about the release when <paramref name="whatIf"/> is true; otherwise null.
             </returns>
@@ -3635,6 +3814,11 @@
             Backing field for the <see cref="P:Nerdbank.GitVersioning.VersionOptions.GitCommitIdShortAutoMinimum"/> property.
             </summary>
         </member>
+        <member name="F:Nerdbank.GitVersioning.VersionOptions.gitCommitIdIncludeDirty">
+            <summary>
+            Backing field for the <see cref="P:Nerdbank.GitVersioning.VersionOptions.GitCommitIdIncludeDirty"/> property.
+            </summary>
+        </member>
         <member name="F:Nerdbank.GitVersioning.VersionOptions.nuGetPackageVersion">
             <summary>
             Backing field for the <see cref="P:Nerdbank.GitVersioning.VersionOptions.NuGetPackageVersion"/> property.
@@ -3881,6 +4065,17 @@
             The value is 0 by default.
             </summary>
         </member>
+        <member name="P:Nerdbank.GitVersioning.VersionOptions.GitCommitIdIncludeDirty">
+            <summary>
+            Gets or sets a value indicating whether Git commit IDs should be suffixed with <c>-dirty</c>
+            when the working tree has uncommitted changes.
+            </summary>
+        </member>
+        <member name="P:Nerdbank.GitVersioning.VersionOptions.GitCommitIdIncludeDirtyOrDefault">
+            <summary>
+            Gets a value indicating whether Git commit IDs should indicate a dirty working tree.
+            </summary>
+        </member>
         <member name="P:Nerdbank.GitVersioning.VersionOptions.NuGetPackageVersion">
             <summary>
             Gets or sets the options around NuGet version strings.
@@ -4940,6 +5135,31 @@
             <param name="paddingSize">The minimum number of digits to use for any numeric identifier.</param>
             <returns>A semver 1 compliant prerelease tag. For example "-beta-0005".</returns>
         </member>
+        <member name="F:Nerdbank.GitVersioning.Utilities.RetryTimeout">
+            <summary>
+            How long <see cref="M:Nerdbank.GitVersioning.Utilities.FileOperationWithRetry(System.Action)" /> keeps retrying a transient failure before giving up.
+            </summary>
+        </member>
+        <member name="F:Nerdbank.GitVersioning.Utilities.MaxBackoff">
+            <summary>
+            The longest a single backoff may last, in milliseconds.
+            </summary>
+        </member>
+        <member name="P:Nerdbank.GitVersioning.Utilities.Random">
+            <summary>
+            Gets a pseudo-random number generator that belongs to the calling thread, since <see cref="P:Nerdbank.GitVersioning.Utilities.Random" /> is not thread-safe.
+            </summary>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.Utilities.FileOperationWithRetry(System.Action)">
+            <summary>
+            Invokes a file operation, retrying while it fails for a reason that another process or thread is expected to clear.
+            </summary>
+            <param name="operation">The operation to invoke. It must be safe to invoke more than once.</param>
+            <remarks>
+            Many instances of this library may run concurrently within one build, and several of them may contend over one file.
+            Backoffs are randomized so that a large set of contenders does not keep colliding in lock step.
+            </remarks>
+        </member>
         <member name="F:Windows.Win32.Foundation.HANDLE.INVALID_HANDLE_VALUE">
             <summary>There is no interactive user. The trust provider performs the verification action without the user's assistance.</summary>
             <remarks>
@@ -5101,6 +5321,19 @@
             The priority of the member.
             </summary>
         </member>
+        <member name="T:System.Runtime.CompilerServices.ExtensionMarkerAttribute">
+            <summary>
+            This attribute is used to mark extension members and associate them with a specific marker type (which provides detailed information about an extension block and its receiver parameter).
+            This attribute should not be used by developers in source code.
+            </summary>
+        </member>
+        <member name="M:System.Runtime.CompilerServices.ExtensionMarkerAttribute.#ctor(System.String)">
+            <summary>Initializes a new instance of the <see cref="T:System.Runtime.CompilerServices.ExtensionMarkerAttribute"/> class.</summary>
+            <param name="name">The name of the marker type this extension member is associated with.</param>
+        </member>
+        <member name="P:System.Runtime.CompilerServices.ExtensionMarkerAttribute.Name">
+            <summary>The name of the marker type this extension member is associated with.</summary>
+        </member>
         <member name="T:System.Runtime.CompilerServices.CompilerLoweringPreserveAttribute">
             <summary>
             When applied to an attribute class, instructs the compiler to flow applications of that attribute,
@@ -5122,19 +5355,6 @@
             Indicates that a method will allow a variable number of arguments in its invocation.
             </summary>
         </member>
-        <member name="T:System.Runtime.CompilerServices.ExtensionMarkerAttribute">
-            <summary>
-            This attribute is used to mark extension members and associate them with a specific marker type (which provides detailed information about an extension block and its receiver parameter).
-            This attribute should not be used by developers in source code.
-            </summary>
-        </member>
-        <member name="M:System.Runtime.CompilerServices.ExtensionMarkerAttribute.#ctor(System.String)">
-            <summary>Initializes a new instance of the <see cref="T:System.Runtime.CompilerServices.ExtensionMarkerAttribute"/> class.</summary>
-            <param name="name">The name of the marker type this extension member is associated with.</param>
-        </member>
-        <member name="P:System.Runtime.CompilerServices.ExtensionMarkerAttribute.Name">
-            <summary>The name of the marker type this extension member is associated with.</summary>
-        </member>
         <member name="T:Microsoft.CodeAnalysis.EmbeddedAttribute">
             <summary>
             A special attribute recognized by Roslyn, that marks a type as "embedded", meaning it won't ever be visible from other assemblies.