XML Comment Screwed - Possibly a bug in VB??

Hi,

Just busily coding away and removed a procedure from my code and all of a sudden an error came up miles away from the location of the piece of code I removed and it relates to the XML comment inserted at the top of the procedure.

I had this happen once before and I couldn't fathom why it was complaining, the XML comment is like this:

''' <summary>
''' If the Bonds flag is set in the security record we have at least one Bond & Floating Charge
''' This routine locates the bonds that are linked to the Security Record and adds them as sub nodes to
''' the main Bonds node.
''' </summary>
''' <param name="ParentNode"></param>
''' <remarks></remarks>

This gives an error:

"Warning 1 XML documentation parse error: Whitespace is not allowed at this location. XML comment will be ignored. "

I then discovered if I remove the "&" ampersand symbol the error message goes away???

Is this a "by design" thing or is this a bug in the XML comments??

Siv


.

Relevant Pages

  • Re: XML Comment Screwed - Possibly a bug in VB??
    ... the systems just warns that the XML doc will be broken ... ''' If the Bonds flag is set in the security record we have at least ... ''' This routine locates the bonds that are linked to the Security ... Record and adds them as sub nodes to ...
    (microsoft.public.dotnet.languages.vb)
  • Re: XML Comment Screwed - Possibly a bug in VB??
    ... internal workings of XML. ... being that if another VB user like me who doesn't know why this "warning" ... perhaps tighten up the warning messages so that the warning message can ... ''' If the Bonds flag is set in the security record we have at ...
    (microsoft.public.dotnet.languages.vb)
  • Re: XML Comment Screwed - Possibly a bug in VB??
    ... I didn't come here to be scolded for not understanding the internal workings of XML. ... My hope being that if another VB user like me who doesn't know why this "warning" comes up and doesn't know how to get past it will read my post and get a resolution to the problem. ... I also hoped that one of the developers from Microsoft may become aware of it and perhaps tighten up the warning messages so that the warning message can be a bit more focused on what is really upsetting it. ... ''' If the Bonds flag is set in the security record we have at least one Bond & Floating Charge ...
    (microsoft.public.dotnet.languages.vb)
  • Re: XML Comment Screwed - Possibly a bug in VB??
    ... documentation is in fact true XML that has a use on its own and can even be ... warning and not an error. ... ''' This routine locates the bonds that are linked to the Security ... Record and adds them as sub nodes to ...
    (microsoft.public.dotnet.languages.vb)
  • Re: XML Comment Screwed - Possibly a bug in VB??
    ... I guess that a lot of coders are not aware of the fact that the documentation is in fact true XML that has a use on its own and can even be used in externall reporting and tracking tools such as Ghostdoc, ... a warning and not an error. ... ''' If the Bonds flag is set in the security record we have at least one Bond & Floating Charge ... ''' This routine locates the bonds that are linked to the Security Record and adds them as sub nodes to ...
    (microsoft.public.dotnet.languages.vb)