microsoft/CsWin32

Inherited COM methods do not have documentation comments

クローズ

#1,391 opened on 2025/03/23

 (0 件のコメント) (0 件のリアクション) (0 人の担当者)C# (123 件のフォーク)github user discovery
buggood first issue

Repository metrics

Stars
 (2,515 個のスター)
PR merge metrics
 (平均マージ 16d 2h) (30d で 19 merged PRs)

説明

Create the following NativeMethods.txt:

IShellDispatch2

Then open the generated Windows.Win32.IShellDispatch2.g.cs. Note that the methods defined originally in IShellDispatch2 have documentation:

/// <summary>IShellDispatch2.IsRestricted method - Retrieves a group's restriction setting from the registry.</summary>
/// <returns></returns>
/// <remarks>
/// <para>This method is implemented and accessed through the [**Shell.IsRestricted**](./shell-isrestricted.md) method. **IsRestricted** first looks for a subkey name that matches *sGroup* under the following key. </para>
/// <para>This doc was truncated.</para>
/// <para><see href="https://learn.microsoft.com/windows/win32/shell/ishelldispatch2-isrestricted#">Read more on docs.microsoft.com</see>.</para>
/// </remarks>
int IsRestricted(winmdroot.Foundation.BSTR Group, winmdroot.Foundation.BSTR Restriction);

But the methods which are defined originally in IShellDispatch and redefined in IShellDispatch2 have no documentation:

new void FileRun();

Open the generated Windows.Win32.IShellDispatch.g.cs, confirming that the original FileRun has documentation:

/// <summary>Displays the Run dialog to the user.</summary>
/// <returns>This method has no parameters.</returns>
/// <remarks>This method is implemented and accessed through the [**Shell.FileRun**](shell-filerun.md) method.</remarks>
void FileRun();

The documentation should also be generated on the re-defined methods in derived interfaces.

Context

  • CsWin32 version: 0.3.183
  • Target Framework: net9.0

コントリビューターガイド