[Mono-list] monodoc - updater.exe

Giuseppe Greco gius.greco@bluewin.ch
Mon, 14 Jul 2003 08:01:50 +0200


Hi,

I've given a look at the XML file generated by
updater.exe, and I've noted that properties are
documented like this:

<Member MemberName="MyProp">
  <MemberSignature Language="C#" Value="public int BufferSize { set; get;
};" />
  <MemberType>Property</MemberType>
  <ReturnValue>
    <ReturnType>System.Int32</ReturnType>
  </ReturnValue>
  <Parameters>
    <Parameter Name="value" Type="System.Int32" />
  </Parameters>
  <Docs>
    <summary>To be added</summary>
    <param name="value">a <see cref="T:System.Int32" /></param>
    <returns>a <see cref="T:System.Int32" /></returns>
    <remarks>To be added</remarks>
  </Docs>
</Member>

Why does not updater.exe generate a <value> tag pair instead
of the <param> and <returns> tags? Here 's an example:

<Member MemberName="MyProp">
  ...
  <Docs>
    <summary>To be added</summary>
    <value>a <see cref="T:System.Int32" /></value>
    <remarks>To be added</remarks>
  </Docs>
</Member>

Gius_.