GtkSharp/doc/gen-gtype-docs.cs
John Luke 70635096fa 2004-12-29 John Luke <john.luke@gmail.com>
* gen-intptr-ctor-docs.cs: docs for Type (IntPtr) ctor
        * gen-gtype-ctor-docs.cs: docs for Type (GType) ctor
        * gen-finalize-docs.cs: docs Finalize methods
        * gen-gtype-docs.cs: docs GType properties, based off
        of gen-vm-docs.cs
        * en/*.xml: run these 4 tools for all the assemblies


svn path=/trunk/gtk-sharp/; revision=38159
2004-12-29 18:36:31 +00:00

209 lines
5.3 KiB
C#

// gen-gtype-docs.cs - Generate documentation for GType property.
//
// Author: John Luke <john.luke@gmail.com>
//
// Copyright (c) 2004 Novell, Inc.
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of version 2 of the GNU General Public
// License as published by the Free Software Foundation.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// General Public License for more details.
//
// You should have received a copy of the GNU General Public
// License along with this program; if not, write to the
// Free Software Foundation, Inc., 59 Temple Place - Suite 330,
// Boston, MA 02111-1307, USA.
namespace GtkSharp.Docs
{
using System;
using System.Collections;
using System.IO;
using System.Reflection;
using System.Xml;
using System.Xml.XPath;
public class GenGtypeDocs
{
public static int Main (string[] args)
{
XmlDocument api_doc = new XmlDocument ();
foreach (string arg in args)
{
Assembly assembly;
try
{
assembly = Assembly.LoadFile (arg);
}
catch (XmlException e)
{
Console.WriteLine (e);
return 1;
}
foreach (Type t in assembly.GetTypes ())
{
if (!t.IsSubclassOf (typeof (GLib.Object)))
continue;
PropertyInfo pi = t.GetProperty ("GType");
if (pi == null)
continue;
string filename = "en/" + t.Namespace + "/" + t.Name + ".xml";
try
{
Stream stream = File.OpenRead (filename);
api_doc.Load (stream);
stream.Close ();
Console.WriteLine ("opened:" + filename);
}
catch (XmlException e)
{
Console.WriteLine (e);
return 1;
}
XPathNavigator api_nav = api_doc.CreateNavigator ();
XPathNodeIterator iter = api_nav.Select ("/Type/Members/Member[@MemberName='GType']");
if (iter.MoveNext ())
{
XmlElement elem = ((IHasXmlNode)iter.Current).GetNode () as XmlElement;
XmlElement summ = elem ["Docs"] ["summary"];
XmlElement rem = elem ["Docs"] ["remarks"];
string summary = summ.InnerXml;
string remarks = rem.InnerXml;
if (summary == "To be added" && remarks == "To be added")
{
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");
}
}
else
{
Console.WriteLine ("Member not found: GType");
}
api_doc.Save (filename);
}
}
return 0;
}
}
}
// gen-gtype-docs.cs - Generate documentation for GType property.
//
// Author: John Luke <john.luke@gmail.com>
//
// Copyright (c) 2004 Novell, Inc.
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of version 2 of the GNU General Public
// License as published by the Free Software Foundation.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// General Public License for more details.
//
// You should have received a copy of the GNU General Public
// License along with this program; if not, write to the
// Free Software Foundation, Inc., 59 Temple Place - Suite 330,
// Boston, MA 02111-1307, USA.
namespace GtkSharp.Docs
{
using System;
using System.Collections;
using System.IO;
using System.Reflection;
using System.Xml;
using System.Xml.XPath;
public class GenGtypeDocs
{
public static int Main (string[] args)
{
XmlDocument api_doc = new XmlDocument ();
foreach (string arg in args)
{
Assembly assembly;
try
{
assembly = Assembly.LoadFile (arg);
}
catch (XmlException e)
{
Console.WriteLine (e);
return 1;
}
foreach (Type t in assembly.GetTypes ())
{
if (!t.IsSubclassOf (typeof (GLib.Object)))
continue;
PropertyInfo pi = t.GetProperty ("GType");
if (pi == null)
continue;
string filename = "en/" + t.Namespace + "/" + t.Name + ".xml";
try
{
Stream stream = File.OpenRead (filename);
api_doc.Load (stream);
stream.Close ();
Console.WriteLine ("opened:" + filename);
}
catch (XmlException e)
{
Console.WriteLine (e);
return 1;
}
XPathNavigator api_nav = api_doc.CreateNavigator ();
XPathNodeIterator iter = api_nav.Select ("/Type/Members/Member[@MemberName='GType']");
if (iter.MoveNext ())
{
XmlElement elem = ((IHasXmlNode)iter.Current).GetNode () as XmlElement;
XmlElement summ = elem ["Docs"] ["summary"];
XmlElement rem = elem ["Docs"] ["remarks"];
string summary = summ.InnerXml;
string remarks = rem.InnerXml;
if (summary == "To be added" && remarks == "To be added")
{
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");
}
}
else
{
Console.WriteLine ("Member not found: GType");
}
api_doc.Save (filename);
}
}
return 0;
}
}
}