Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

System.Speech: Use intellisense xml from dotnet-api-docs#111983

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
carlossanlop merged 1 commit intodotnet:mainfromcarlossanlop:SystemSpeechDocs
Jan 30, 2025
Merged

System.Speech: Use intellisense xml from dotnet-api-docs#111983

carlossanlop merged 1 commit intodotnet:mainfromcarlossanlop:SystemSpeechDocs
Jan 30, 2025

Conversation

@carlossanlop
Copy link
Contributor

Fixes#87711

The intellisense file that comes from Microsoft.Private.Intellisense, located inC:\.tools\.nuget\packages\microsoft.private.intellisense\9.0.0-preview-20241010.1\IntellisenseFiles\net\1033\System.Speech.xml, weighs 317KB.

But when building, the xml files underC:\Users\calope\source\repos\runtime\artifacts\obj\System.Speech\$(Configuration)\ all weigh much less than that (varies depending on the OS/platform) and only contain resource strings (no actual docs).

This means we are using the xmls from the build, and almost none of the System.Speech have triple slash comments. I was able to confirm this by analyzing the binlog and finding thatUseCompilerGeneratedDocXmlFile is set totrue (the default value) so none of the logic fromintellisense.targets is used.

The fix is to set this assembly'sUseCompilerGeneratedDocXmlFile to explicitly tofalse in the csproj, exactly as@gewarren found in the original issue.

I was able to confirm with a rebuild of the csproj that the xml placed next to the built DLL is now the one coming from dotnet-api-docs: it weighs 317KB and contains all API docs, and can be found in all the target framework folders in the output folder.

@carlossanlopcarlossanlop added documentationDocumentation bug or enhancement, does not impact product or test code area-System.Speech labelsJan 29, 2025
@carlossanlopcarlossanlop requested review froma team andgewarrenJanuary 29, 2025 22:33
@carlossanlopcarlossanlop self-assigned thisJan 29, 2025
@carlossanlop
Copy link
ContributorAuthor

I think we should consider this as a candidate for backporting, as the documentation exists, but customers are not receiving it in released versions due to this bug.

@carlossanlopcarlossanlop merged commite3f3598 intodotnet:mainJan 30, 2025
86 of 88 checks passed
@carlossanlopcarlossanlop deleted the SystemSpeechDocs branchJanuary 30, 2025 16:54
grendello added a commit to grendello/runtime that referenced this pull requestJan 30, 2025
* main: (31 commits)  More native AOT Pri-1 test tree bring up (dotnet#111994)  Fix BigInteger outerloop test (dotnet#111841)  JIT: Run 3-opt once across all regions (dotnet#111989)  JIT: Check for profile consistency throughout JIT backend (dotnet#111684)  [JIT] Add legacy extended EVEX encoding and EVEX.ND/NF feature to x64 emitter backend (dotnet#108796)  [iOS][globalization] Fix IndexOf on empty strings on iOS to return -1 (dotnet#111898)  System.Speech: Use intellisense xml from dotnet-api-docs (dotnet#111983)  [mono][mini] Disable inlining if we encounter class initialization failure (dotnet#111754)  [main] Update dependencies from dotnet/roslyn (dotnet#111946)  Update dependencies fromhttps://github.com/dotnet/arcade build 20250129.2 (dotnet#111996)  Try changing the ICustomQueryInterface implementation to always return NotHandled instead of Failed to defer back to the ComWrappers impl. (dotnet#111978)  Combined dependency update (dotnet#111852)  Replace OPTIMIZE_FOR_SIZE with feature switch (dotnet#111743)  Fix failed assertion 'FPbased == FPbased2' (dotnet#111787)  Add remark to `ConditionalSelect` (dotnet#111945)  JIT: fix try region cloning when try is nested in a handler (dotnet#111975)  Use IRootFunctions in Tensor.StdDev (dotnet#110641)  Remove zlib dependencies from Docker containers (dotnet#111939)  Avoid `Unsafe.As` for `Memory<T>` and `ReadOnlyMemory<T>` conversion (dotnet#111023)  Cleanup membarrier portability (dotnet#111943)  ...
@github-actionsgithub-actionsbot locked and limited conversation to collaboratorsMar 2, 2025
Sign up for freeto subscribe to this conversation on GitHub. Already have an account?Sign in.

Reviewers

@ViktorHoferViktorHoferViktorHofer approved these changes

@gewarrengewarrengewarren approved these changes

Assignees

@carlossanlopcarlossanlop

Labels

area-System.SpeechdocumentationDocumentation bug or enhancement, does not impact product or test code

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

System.Speech is missing API documentation

3 participants

@carlossanlop@ViktorHofer@gewarren

[8]ページ先頭

©2009-2025 Movatter.jp