Created On:  01 September 2011

Problem:

When creating XML comments for a method in a Visual COBOL source program using the characters "*" followed by ">>", the comment is displayed in Intellisense when the method is referenced from within a program that resides in the same project as the source containing the comment but if the source is in a different project than the referencing program then the comment is being ignored.

Why is this and how can I get it to work?

Resolution:

There is an option under Solution Explorer Project Properties > COBOL Tab > Advanced Options called XML documentation file. If you check this and provide a filename in which to store the comments then it will work correctly from within different projects. This must be turned on in the project containing the source with the comment in it.
Incident #2535275