Repository navigation
[src] Ignore CS1573 in certain cases. - #21941
Conversation
CS1573 is raised when some, but not all, parameters in a method have xml comments. The generated code can trigger this when an api definition has a method with documented parameters, and then the generator creates a method with additional parameters (which won't have xml comments).
|
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
π [CI Build] Test results πTest resultsβ All tests passed on VSTS: test results. π All 111 tests passed π Tests countsβ
cecil: All 1 tests passed. Html Report (VSDrops) Download Pipeline on Agent |
| var extensionProperties = optionalInstanceProperties.Concat (requiredInstanceProperties.Where (v => IsRequired (v, out var generateExtensionMethod) && generateExtensionMethod)); | ||
|
|
||
| // disable CS1573, which can happen when the original member in the api definition has xml comments and we copy that xml comment into the generated interface - because we may add parameters to method signatures, and the new parameters won't have an xml comment. | ||
| print ("#pragma warning disable CS1573"); // Parameter 'This' has no matching param tag in the XML comment for '...' (but other parameters do) |
There was a problem hiding this comment.
Does it make sense to inject a comment as to why this is being disabled?
There was a problem hiding this comment.
I don't think most people look at the code we generate, so probably not worth it.
β [CI Build] Build passed (Build packages) βPipeline on Agent |
β [CI Build] Build passed (Detect API changes) βPipeline on Agent |
β [CI Build] Build passed (Build macOS tests) βPipeline on Agent |
π» [CI Build] Windows Integration Tests passed π»β All Windows Integration Tests passed. Pipeline on Agent |
π» [CI Build] Tests on macOS M1 - Mac Monterey (12) passed π»β All tests on macOS M1 - Mac Monterey (12) passed. Pipeline on Agent |
π» [CI Build] Tests on macOS M1 - Mac Ventura (13) passed π»β All tests on macOS M1 - Mac Ventura (13) passed. Pipeline on Agent |
π» [CI Build] Tests on macOS arm64 - Mac Sequoia (15) passed π»β All tests on macOS arm64 - Mac Sequoia (15) passed. Pipeline on Agent |
β API diff for current PR / commit.NET ( No breaking changes )β API diff vs stable (Breaking changes).NET ( β Breaking changes β )βΉοΈ Generator diffGenerator Diff: vsdrops (html) vsdrops (raw diff) gist (raw diff) - Please review changes) Pipeline on Agent |
π» [CI Build] Tests on macOS X64 - Mac Sonoma (14) passed π»β All tests on macOS X64 - Mac Sonoma (14) passed. Pipeline on Agent |
CS1573 is raised when some, but not all, parameters in a method have xml
comments.
The generated code can trigger this when an api definition has a method with
documented parameters, and then the generator creates a method with additional
parameters (which won't have xml comments).