diff --git a/doc/ChangeLog b/doc/ChangeLog index 691f20084..c9af3d609 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2005-06-22 Mike Kestner + + * gen-vm-docs.cs : some monodocer formatting changes and attr lookup + enhancements. + 2005-06-16 Mike Kestner * en/*/*.xml : run the versionator to add since elements for 2.6. diff --git a/doc/en/Atk/Object.xml b/doc/en/Atk/Object.xml index 6944ea178..c9df1924c 100644 --- a/doc/en/Atk/Object.xml +++ b/doc/en/Atk/Object.xml @@ -701,7 +701,6 @@ All UI components in an application which provide useful information or services Override this method in a subclass to provide a default handler for the event. - Constructor @@ -785,7 +784,7 @@ All UI components in an application which provide useful information or services - + Method @@ -796,9 +795,9 @@ All UI components in an application which provide useful information or services To be added. - To be added. - To be added. + Default handler for the event. + Override this method in a subclass to provide a default handler for the event. - + \ No newline at end of file diff --git a/doc/en/Gnome/Canvas.xml b/doc/en/Gnome/Canvas.xml index 1aaa40043..1524c918c 100644 --- a/doc/en/Gnome/Canvas.xml +++ b/doc/en/Gnome/Canvas.xml @@ -390,7 +390,6 @@ - Method @@ -641,7 +640,6 @@ - Constructor @@ -754,11 +752,12 @@ - + GLib.Property(Name="aa") - + + Event @@ -775,11 +774,12 @@ - + GLib.Signal(CName="draw_background") - + + Event @@ -797,11 +797,12 @@ - + GLib.Signal(CName="render_background") - + + Method @@ -859,7 +860,6 @@ Returns the native value for . - Method @@ -895,11 +895,12 @@ a Chain to this constructor if you have manually registered a native value for your subclass. - + System.Obsolete(Message=null, IsError=False) - + + Property @@ -925,7 +926,7 @@ - + Method @@ -940,7 +941,7 @@ To be added. - + Method @@ -951,9 +952,9 @@ To be added. - To be added. - To be added. + Default handler for the event. + Override this method in a subclass to provide a default handler for the event. - + \ No newline at end of file diff --git a/doc/en/Gtk/Clipboard.xml b/doc/en/Gtk/Clipboard.xml index c20d2b5fb..cf3f7dbb6 100644 --- a/doc/en/Gtk/Clipboard.xml +++ b/doc/en/Gtk/Clipboard.xml @@ -386,7 +386,6 @@ - Method @@ -479,7 +478,7 @@ - + Method @@ -489,9 +488,10 @@ - To be added. - To be added. - To be added. + An event describing the owner change. + Default handler for the event. + Override this method in a subclass to provide a default handler for the event. + diff --git a/doc/en/Gtk/FileChooserButton.xml b/doc/en/Gtk/FileChooserButton.xml index f7dc99fb2..854d1958e 100644 --- a/doc/en/Gtk/FileChooserButton.xml +++ b/doc/en/Gtk/FileChooserButton.xml @@ -461,8 +461,8 @@ - To be added. - To be added. + Default handler for the event. + Override this method in a subclass to provide a default handler for the event. @@ -473,8 +473,8 @@ - To be added. - To be added. + Default handler for the event. + Override this method in a subclass to provide a default handler for the event. @@ -485,8 +485,8 @@ - To be added. - To be added. + Default handler for the event. + Override this method in a subclass to provide a default handler for the event. @@ -497,8 +497,8 @@ - To be added. - To be added. + Default handler for the event. + Override this method in a subclass to provide a default handler for the event. @@ -694,4 +694,4 @@ - + \ No newline at end of file diff --git a/doc/gen-vm-docs.cs b/doc/gen-vm-docs.cs index acaffe4c2..dd04e9f4e 100644 --- a/doc/gen-vm-docs.cs +++ b/doc/gen-vm-docs.cs @@ -31,7 +31,6 @@ namespace GtkSharp.Docs { public static int Main (string[] args) { - string api_filename = ""; XmlDocument api_doc = new XmlDocument (); BindingFlags flags = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.DeclaredOnly; @@ -51,27 +50,20 @@ namespace GtkSharp.Docs { Hashtable sigs = new Hashtable (); - foreach (EventInfo ei in t.GetEvents (flags)) { - foreach (Attribute attr in ei.GetCustomAttributes (false)) { - if (attr.ToString () == "GLib.SignalAttribute") { - sigs [((GLib.SignalAttribute) attr).CName] = ei.Name; - break; - } - } - } + foreach (EventInfo ei in t.GetEvents (flags)) + foreach (GLib.SignalAttribute attr in ei.GetCustomAttributes (typeof (GLib.SignalAttribute), false)) + sigs [attr.CName] = ei.Name; + if (sigs.Count == 0) continue; Hashtable vms = new Hashtable (); foreach (MethodInfo mi in t.GetMethods (flags)) { - foreach (Attribute attr in mi.GetCustomAttributes (false)) { - if (attr.ToString () == "GLib.DefaultSignalHandlerAttribute") { - string conn_name = ((GLib.DefaultSignalHandlerAttribute) attr).ConnectionMethod; - if (sigs.ContainsValue (conn_name.Substring (8))) - vms [mi.Name] = conn_name.Substring (8); - break; - } + foreach (GLib.DefaultSignalHandlerAttribute attr in mi.GetCustomAttributes (typeof (GLib.DefaultSignalHandlerAttribute), false)) { + string conn_name = attr.ConnectionMethod; + if (sigs.ContainsValue (conn_name.Substring (8))) + vms [mi.Name] = conn_name.Substring (8); } } @@ -91,6 +83,7 @@ namespace GtkSharp.Docs { XPathNavigator api_nav = api_doc.CreateNavigator (); + bool dirty = false; foreach (string vm in vms.Keys) { XPathNodeIterator iter = api_nav.Select ("/Type/Members/Member[@MemberName='" + vm + "']"); @@ -100,16 +93,18 @@ namespace GtkSharp.Docs { XmlElement rem = elem ["Docs"] ["remarks"]; 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.") { summ.InnerXml = "Default handler for the event."; rem.InnerXml = "Override this method in a subclass to provide a default handler for the event."; + dirty = true; } else Console.WriteLine ("Member had docs:" + vm); } else { Console.WriteLine ("Member not found:" + vm); } - api_doc.Save (filename); + if (dirty) + api_doc.Save (filename); } } }