Version 2025.9.30.0

Release notes for version 2025.9.30.0.

Breaking Changes in This Release

  Important

If you have created custom build components, syntax generators, plug-ins, or presentation styles, you will need to rebuild them against the latest release of the help file builder NuGet package.

  • The SandcastleBuilder.Utils assembly has been removed. Its functionality has been moved into the Sandcastle.Core and other internal assemblies. Third-party components should remove the reference to the EWSoftware.SandcastleBuilder.Utils NuGet package and update the reference to the EWSoftware.Sandcastle.Core package to the latest release. You will also need to update some namespace references. See the Component Migration Support topic for more information.

    These changes should prevent future issues with changes to MSBuild breaking the standalone GUI and should facilitate future changes related to the MSBuild tasks and the build engine in general.

  • Updated all tools to .NET Framework 4.8 and .NET 9.0.

Build Tools

  • Fixed a bug in MRefBuilder related to parameter matching when parameter types where in both mscorlib and another framework assembly.

  • Fixed handling of XML comments files related to assemblies from package references.

  • Added two new visibility options to allow removing the extension methods section from member list topics entirely or just hiding extension methods that extend System.Object.

  • Fixed how CopyFromIndexComponent and SyntaxComponent obtain their component factory info due to lack of ImportMany MEF attribute support in dotnet builds.

  • Added support for using solution filter files (*.slnf) as documentation sources.

  • Updated the reflection data set files to support .NET 10.

Sandcastle Help File Builder

  • Removed Visual Studio 2017 and 2019 support from the extension package. The extension now only supports Visual Studio 2022 and later.

  • Added support for installing the extension package in Visual Studio 2026.

  • Fixed the preview tool window so that it handles duplicate token IDs. Updated the token editor to warn if a duplicate token ID is seen within the same file.

Presentation Styles

  • Added this/Me language specific text support.

  • If the Always Show Top Level Auto-Outline option is used, the In This Article column is now hidden to prevent it silently overlaying the main content and blocking links from being clicked.

  • Enabled showing applicable extension methods on enumerated types.

  • Changed the Obsolete notice back to using the standard notice text rather than the attribute message.

See Also

Other Resources