Improve the documentation

svn path=/trunk/gtk-sharp/; revision=39362
This commit is contained in:
Miguel de Icaza 2005-01-22 22:42:44 +00:00
parent 67e7fc486b
commit a310c8747b

View file

@ -88,9 +88,9 @@
<returns>a <see cref="T:System.Collections.Hashtable" /></returns> <returns>a <see cref="T:System.Collections.Hashtable" /></returns>
<remarks> <remarks>
This property is obsolete and should not be used unless you explicitly retain a reference to the This property is obsolete and should not be used unless you explicitly retain a reference to the
<see cref="T:GLib.Object"/>. Otherwise the Data hashtable will be lost when the Garbage Collector <see cref="T:GLib.Object" />. Otherwise the Data hashtable will be lost when the Garbage Collector
releases your managed object wrapper. There are much better alternatives to this anyway. Consider releases your managed object wrapper. There are much better alternatives to this anyway. Consider
using a Hashtable on your class that is keyed by <see cref="T:GLib.Object"/> or a subclass with using a Hashtable on your class that is keyed by <see cref="T:GLib.Object" /> or a subclass with
an object property for the data you want to store instead. There are many better ways to accompish an object property for the data you want to store instead. There are many better ways to accompish
the role of this property. the role of this property.
</remarks> </remarks>
@ -185,9 +185,15 @@
</Parameters> </Parameters>
<Docs> <Docs>
<summary>Creates a new <see cref="T:GLib.Object" /> instance, using the GLib-provided type.</summary> <summary>Creates a new <see cref="T:GLib.Object" /> instance, using the GLib-provided type.</summary>
<param name="gtype">a <see cref="T:GLib.GType" /></param> <param name="gtype">The <see cref="T:GLib.GType" /> to register with the GLib type system.</param>
<returns>a <see cref="T:GLib.Object" /></returns> <returns>a <see cref="T:GLib.Object" /></returns>
<remarks>This is a constructor used by derivative types of <see cref="T:GLib.Object" /> that would have their own GLib.GType assigned to it. This is not typically used by C# code.</remarks> <remarks>
<para>This is a constructor used by derivative types of <see cref="T:GLib.Object" /> that would have their own GLib.GType assigned to it. This is not typically used by C# code.
</para>
<para>
This is typically used to construct a new object that must be registered with the C-based GObject type system. An <see cref="T:GLib.GType" /> is usually registered from the static constructor for the class.
</para>
</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="TypeName"> <Member MemberName="TypeName">
@ -335,10 +341,10 @@
<Parameter Name="vals" Type="GLib.Value[]" /> <Parameter Name="vals" Type="GLib.Value[]" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>Creates the GObject underlying a managed <see cref="T:GLib.Object"/> subclass</summary> <summary>Creates the GObject underlying a managed <see cref="T:GLib.Object" /> subclass</summary>
<param name="names">an array of (GObject) property names</param> <param name="names">an array of (GObject) property names</param>
<param name="vals">the values for the properties identified by <paramref name="names"/></param> <param name="vals">the values for the properties identified by <paramref name="names" /></param>
<remarks>This is the method used by managed <see cref="T:GLib.Object"/> subclasses (as opposed to classes that are just wrappers around C-based objects) to create their underlying GObject. It will be invoked for you automatically by when you chain to your subclass's base class constructor.</remarks> <remarks>This is the method used by managed <see cref="T:GLib.Object" /> subclasses (as opposed to classes that are just wrappers around C-based objects) to create their underlying GObject. It will be invoked for you automatically by when you chain to your subclass's base class constructor.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="GetProperty"> <Member MemberName="GetProperty">
@ -382,10 +388,17 @@
<Parameter Name="raw" Type="System.IntPtr" /> <Parameter Name="raw" Type="System.IntPtr" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Constructs the object from a C-based pointer to the GLib object.</summary>
<param name="raw">a <see cref="T:System.IntPtr" /></param> <param name="raw">The pointer to the native C object.</param>
<returns>a <see cref="T:GLib.Object" /></returns> <returns>a <see cref="T:GLib.Object" /></returns>
<remarks>To be added</remarks> <remarks>
<para>
This constructor is used to associate a C-based GLib object with its equivalent object in the managed world.
</para>
<para>
This method is called by the generated classes by the Gtk# framework.
</para>
</remarks>
</Docs> </Docs>
</Member> </Member>
</Members> </Members>