From 3e4881d3c1fd154678edbd7ac5401961015fb187 Mon Sep 17 00:00:00 2001
From: Mike Kestner <mkestner@gmail.com>
Date: Fri, 2 Mar 2007 18:05:38 +0000
Subject: [PATCH] unstub parameters and reduce spew

svn path=/trunk/gtk-sharp/; revision=73645
---
 doc/gen-gtype-ctor-docs.cs  | 17 +++++------------
 doc/gen-gtype-docs.cs       | 13 +++----------
 doc/gen-intptr-ctor-docs.cs | 17 +++++------------
 3 files changed, 13 insertions(+), 34 deletions(-)

diff --git a/doc/gen-gtype-ctor-docs.cs b/doc/gen-gtype-ctor-docs.cs
index fb8af09dc..700d8b4e7 100644
--- a/doc/gen-gtype-ctor-docs.cs
+++ b/doc/gen-gtype-ctor-docs.cs
@@ -63,7 +63,6 @@ namespace GtkSharp.Docs
 						Stream stream = File.OpenRead (filename);
 						api_doc.Load (stream);
 						stream.Close ();
-						Console.WriteLine ("opened:" + filename);
 					}
 					catch (XmlException e)
 					{
@@ -79,23 +78,17 @@ namespace GtkSharp.Docs
 						XmlElement elem = ((IHasXmlNode)iter.Current).GetNode ().ParentNode.ParentNode as XmlElement;
 						XmlElement summ = elem ["Docs"] ["summary"];
 						XmlElement rem = elem ["Docs"] ["remarks"];
+						XmlElement param = elem ["Docs"] ["param"];
 						string summary = summ.InnerXml;
 						string remarks = rem.InnerXml;
 						if (summary == "To be added." && remarks == "To be added.")
 						{
-							summ.InnerXml = "Protected Constructor.";
-							rem.InnerXml = "Chain to this constructor if you have manually registered a native <see cref=\"T:GLib.GType\" /> value for your subclass.";
-						}
-						else
-						{
-							Console.WriteLine ("Member had docs: .ctor (GType)");
+							Console.WriteLine (filename + ": Documenting ctor(GType)");
+							summ.InnerXml = "Obsolete Protected Constructor.";
+							rem.InnerXml = "Do not use.  Replaced by <see cref=\"M:GLib.Object.CreateNativeObject\" /> which registers native types automatically.  Subclasses should chain to the IntPtr constructor passing <see cref=\"M:System.IntPtr.Zero\" /> and call CreateNativeObject instead of using this constructor.  This constructor is provided for backward compatibility if you have manually registered a native <see cref=\"T:GLib.GType\" /> value for your subclass.";
+							param.InnerXml = "Native type value.";
 						}
 					}
-					else
-					{
-						Console.WriteLine ("Member not found: .ctor (GType)");
-					}
-
 					api_doc.Save (filename);
 				}
 			}
diff --git a/doc/gen-gtype-docs.cs b/doc/gen-gtype-docs.cs
index 6a1924274..dbe5875de 100644
--- a/doc/gen-gtype-docs.cs
+++ b/doc/gen-gtype-docs.cs
@@ -62,7 +62,6 @@ namespace GtkSharp.Docs
 						Stream stream = File.OpenRead (filename);
 						api_doc.Load (stream);
 						stream.Close ();
-						Console.WriteLine ("opened:" + filename);
 					}
 					catch (XmlException e)
 					{
@@ -78,23 +77,17 @@ namespace GtkSharp.Docs
 						XmlElement elem = ((IHasXmlNode)iter.Current).GetNode () as XmlElement;
 						XmlElement summ = elem ["Docs"] ["summary"];
 						XmlElement rem = elem ["Docs"] ["remarks"];
+						XmlElement val = elem ["Docs"] ["value"];
 						string summary = summ.InnerXml;
 						string remarks = rem.InnerXml;
 						if (summary == "To be added." && remarks == "To be added.")
 						{
+							Console.WriteLine (filename + ": documenting GType property");
 							summ.InnerXml = "GType Property.";
 							rem.InnerXml = "Returns the native <see cref=\"T:GLib.GType\" /> value for <see cref=\"T:" + t + "\" />.";
-						}
-						else
-						{
-							Console.WriteLine ("Member had docs: GType");
+							val.InnerXml = "The native <see cref=\"T:GLib.GType\" /> value.";
 						}
 					}
-					else
-					{
-						Console.WriteLine ("Member not found: GType");
-					}
-
 					api_doc.Save (filename);
 				}
 			}
diff --git a/doc/gen-intptr-ctor-docs.cs b/doc/gen-intptr-ctor-docs.cs
index e1ab8d5bb..d0e8e6ade 100644
--- a/doc/gen-intptr-ctor-docs.cs
+++ b/doc/gen-intptr-ctor-docs.cs
@@ -62,7 +62,6 @@ namespace GtkSharp.Docs
 						Stream stream = File.OpenRead (filename);
 						api_doc.Load (stream);
 						stream.Close ();
-						Console.WriteLine ("opened:" + filename);
 					}
 					catch (XmlException e)
 					{
@@ -78,23 +77,17 @@ namespace GtkSharp.Docs
 						XmlElement elem = ((IHasXmlNode)iter.Current).GetNode ().ParentNode.ParentNode as XmlElement;
 						XmlElement summ = elem ["Docs"] ["summary"];
 						XmlElement rem = elem ["Docs"] ["remarks"];
+						XmlElement param = elem ["Docs"] ["param"];
 						string summary = summ.InnerXml;
 						string remarks = rem.InnerXml;
-						if (summary == "To be added" && remarks == "To be added")
+						if (summary == "To be added." && remarks == "To be added.")
 						{
+							Console.WriteLine (filename + ": documenting IntPtr ctor");
 							summ.InnerXml = "Internal constructor";
-							rem.InnerXml = "This is not typically used by C# code.";
-						}
-						else
-						{
-							Console.WriteLine ("Member had docs: .ctor (IntPtr)");
+							rem.InnerXml = "This is not typically used by C# code.  Exposed primarily for use by language bindings to wrap native object instances.";
+							param.InnerXml = "Native object pointer.";
 						}
 					}
-					else
-					{
-						Console.WriteLine ("Member not found: .ctor (IntPtr)");
-					}
-
 					api_doc.Save (filename);
 				}
 			}