Skip to content

Commit 2375b3d

Browse files
committed
Fix typos and minor edits
1 parent 22c5a8c commit 2375b3d

File tree

1 file changed

+13
-10
lines changed

1 file changed

+13
-10
lines changed

docs/release-notes-1-9.md

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Excel-DNA Release Notes - v1.9.0
22

3-
**Released:** _Soon..._ [v1.9.0-rc2 is now available on NuGet](https://www.nuget.org/packages/ExcelDna.AddIn).
3+
**Released:** _Soon..._ [v1.9.0-rc3 is now available on NuGet](https://www.nuget.org/packages/ExcelDna.AddIn).
44

55
This document provides an overview of the new features and enhancements in Excel-DNA version 1.9.0. This release significantly refactors and extends function registration, including simplified support for optional / default parameters and asynchronous functions, and introduces built-in support for object handles.
66

@@ -44,7 +44,7 @@ In v1.9, the functionality previously exposed in the separate `ExcelDna.Registra
4444
Key changes include:
4545
* **Expanded Default Support:** A significantly broader range of parameter and return types are now supported directly for methods marked with `[ExcelFunction]`.
4646
* **Integrated Async & Object Handles:** Support for asynchronous (`Task<T>`) and streaming (`IObservable<T>`) functions, along with object handles (`[ExcelHandle]`, `[return: ExcelHandle]`), is now built-in.
47-
* **Migrated Extension Points:** Customization hooks like `P` `FunctionExecutionHandler` are now part of the main library, generally found within the `ExcelDna.Registration` namespace.
47+
* **Migrated Extension Points:** Customization hooks like `FunctionExecutionHandler` are now part of the main library, generally found within the `ExcelDna.Registration` namespace.
4848
* **Deprecation of `Excel.Registration` Package:** The `ExcelDna.Registration.*` packages are no longer required, and have been marked as deprecated.
4949

5050
### Function Registration in v1.9
@@ -120,11 +120,11 @@ In order to customize the async or streaming functions beyond the default wrappe
120120

121121
* `ExcelAsyncUtil.RunTask`: Helper for running `Task`-based operations and integrating them with Excel's async model.
122122
```csharp
123-
// Example usage of ExcelAsyncUtil.RunTask (from fragment, slightly adapted)
124-
// public static object RunMyTask<TResult>(string callerFunctionName, object callerParameters, Func<Task<TResult>> taskSource)
125-
// {
126-
// return ExcelDna.Integration.ExcelAsyncUtil.RunTask(callerFunctionName, callerParameters, taskSource);
127-
// }
123+
// Example usage of ExcelAsyncUtil.RunTask
124+
public static object RunMyTask<TResult>(string callerFunctionName, object callerParameters, Func<Task<TResult>> taskSource)
125+
{
126+
return ExcelDna.Integration.ExcelAsyncUtil.RunTask(callerFunctionName, callerParameters, taskSource);
127+
}
128128
```
129129
* `ExcelDna.Integration.AsyncTaskUtil`: Utility class for managing `Task`-based functions.
130130
* `ExcelDna.Integration.NativeAsyncTaskUtil`: For deeper integration with native async capabilities.
@@ -149,7 +149,7 @@ In order to customize the async or streaming functions beyond the default wrappe
149149

150150
#### Registration Customization
151151

152-
Explicit registration by retrieving and processing the `ExcelFunction` list was previously done by extensions in the `ExcelDna.Registration` library. The relevant types from that library are now included in the `ExcelDna.Integration` assembly, but the namespaces and type names are not changes. Thus code previously doing explicit registration should still work after the update. (The `ExcelDna.Registration` NuGet package just becomes obsolete.)
152+
Explicit registration by retrieving and processing the `ExcelFunction` list was previously done by extensions in the `ExcelDna.Registration` library. The relevant types from that library are now included in the `ExcelDna.Integration` assembly, but the namespaces and type names are not changed. Thus code previously doing explicit registration should still work after the update. (The `ExcelDna.Registration` NuGet package just becomes obsolete.)
153153

154154
We also provide a simpler approach for including registration extensions in an add-in.
155155

@@ -369,7 +369,7 @@ The `[ExcelHandle]` attribute provides a robust mechanism for managing .NET obje
369369
* **Assembly-Level `ExcelHandleExternal` Attribute:** For types defined in other assemblies that you want Excel-DNA to treat as handles, you can use the `[assembly: ExcelHandleExternal(typeof(YourExternalType))]` attribute.
370370
```csharp
371371
// In AssemblyInfo.cs or a similar file:
372-
// [assembly: ExcelDna.Integration.ExcelHandleExternal(typeof(MyCompany.SharedLibrary.SomeDataType))]
372+
[assembly: ExcelDna.Integration.ExcelHandleExternal(typeof(MyCompany.SharedLibrary.SomeDataType))]
373373
```
374374

375375

@@ -386,10 +386,13 @@ The affected methods are:
386386
* `OnUpdateNotifyInvokedInsideLock`
387387
* `OnRefreshDataProcessedInsideLock`
388388

389-
The sample project RtdClock-Watchdog (in the Excel-DNA\Samples repository) shows how these methods can be used to ass a watchdog to an RTD server that monitors whether the RTD data is being fetched timeously.
389+
The sample project RtdClock-Watchdog (in the Excel-DNA\Samples repository) shows how these methods can be used to add a watchdog to an RTD server that monitors whether the RTD data is being fetched timeously.
390390

391391
## Other Changes and Enhancements
392392

393+
### Support for newer .NET Versions
394+
* With this release we extend support to .NET 9 (and preliminary support for .NET 10)
395+
393396
### Help File Packaging
394397
* Added support for packing compiled HTML Help (`.chm`) files into the packed add-in (`.xll`).
395398

0 commit comments

Comments
 (0)