|
In new development I've selected to use .NET 2005 and of its features the one leveraged most in moving old code is the XML Commenting from which I hope to product documentation. I've found a problem on the C++/CLI side that I hope someone can help with -- whenever I have a method with a parameter such as array<char> ^ the documenting for that method does not display in Object Browser. As an example of this problem add the following declarations then compile a .NET Class Library -- add the Class Library as a reference in a C# project and browse in Object Browser. The top method will display correctly while the bottom will not display at all. ///<summary>///<para>Test Demonstrating XML Documentation Bug.</para> ///<para>This method will document properly and display accordingly from Object Browser.</para> ///</summary> ///<remarks> ///<para>Testing parameters System::String ^strVal vs. array<char> ^strVal</para> ///</remarks> System::Void Test(System::String ^strVal) {}; ///<summary> ///<para>Test Demonstrating XML Documentation Bug.</para> ///<para>This method will document properly and display accordingly from Object Browser.</para> ///</summary> ///<remarks> ///<para>Testing parameters System::String ^strVal vs. array<char> ^strVal</para> ///</remarks> System::Void Test(array<char> ^strVal) {}; |
XML Documentation Comments
Hot Topic
- create C++ DLL to be used by C# ?
- Linking-Error with VSC++ 8.0
- How to compile C++ function to be used by C# ?
- C++ calling C# Dll -> EEFileLoadException in debugger but works correctly if I just run from windows directly.
- How to show the activities and actions of program to user????
- Project : error PRJ0002 : Error result -1073741515
- CString::Format issue
- VS 2005 Beta 2: Deprecated UpdateRegistryClass declared in DECLARE_REGISTRY macro - any workarounds?
- ListView Control displays blank images
- Edit ListView Subitems
XML Documentation Comments
Pimpom
Thanks!
Soon the owners should be taking a look. The link should display some of the updates once folks start looking into it.
Thanks, Ayman Shoukry VC++ TeamMo_Fya
Twice I entered the bug but do not get any tracking information.
I guess I could enter a bug about the lack of tracking but then I wouldn't be able to track that bug since the bug is about a lack of tracking ability
Ken Culp
I believe I have found the other one you have logged previously:
http://lab.msdn.microsoft.com/ProductFeedback/viewFeedback.aspx feedbackid=f51486ba-dcb7-46f8-ba2b-e4c4737820b7
Thanks, Ayman Shoukry VC++ TeamStephanie Barulic
Could you log a bug at http://lab.msdn.microsoft.com/productfeedback/default.aspx. Please reply back with the bug link so that other can follow its status.
Thanks, Ayman Shoukry VC++ TeamVikas Bindra
fifteen years I have been developing with windows and have never been through the bug reporting procedures -- suppose either I have been fortunate or just lazy.
Kidding aside, yes I can provide the link if there is a way I search on my user id as having poted the bug. Search results should provide the link -- I will give that a try.
Found it...here you go
http://lab.msdn.microsoft.com/productfeedback/viewfeedback.aspx feedbackid=e628ce38-f8ec-45f1-aa2b-bfe7a57f9e4a
norax
Could you post the bug link that you entered Also, do you recall the title or the name you used when you opened it I can track it internally in our bug database.
Thanks, Ayman Shoukry VC++ TeamLengo
Yup that is it. I do hope this is resolved soon. I am relying very much on the ability to create documentation for intellisense/object browser and currently am reworking all instances of arrays or object handles in methods to be references.