GtkSharp/doc
Dan Winship 622c360576 * parser/gapi2xml.pl (addFuncElems): if a struct or boxed type has
a constructor or a ref, unref, or destroy method, then it must be
	a reference type, so mark it "opaque" but then also mark all of
	its fields public and writable.

	* */*-api*.raw: Regen

	* generator/Parser.cs (ParseNamespace): make the opaque attribute
	check actually look at the value of the attribute rather than just
	checking if it's there, so that you can change a struct's opaque
	attribute from "true" to "false" via metadata and have that work.

	* generator/BoxedGen.cs (Generate): do not generate the boxed's
	"Free" method (since it's guaranteed to crash when we pass it a
	stack pointer). If "Copy" is marked deprecated, create a
	deprecated no-op for it, otherwise just skip it (since otherwise
	it will just leak memory when we copy its result onto the stack).

	* pango/Pango.metadata: deprecate Pango.Color.Copy and
	Pango.Matrix.Copy. Hide some array fields in Pango.GlyphString
	that we've never generated correctly. Tweak Pango.LayoutLine
	fields to be the same as they used to be.

	* pango/GlyphItem.custom (glyphs, item):
	* pango/GlyphString.custom (Zero, New):
	* pango/Item.custom (Zero, New):
	* pango/LayoutRun.custom (glyphs, item): add deprecated API compat

	* gdk/Gdk.metadata: undo the parser's new opaquification of
	Gdk.Font; it's been deprecated since pre-gtk# times, and no one
	should be using it, so there's no point in fixing it now. Fix up a
	few other things to match how they used to be. Fix RgbCmap's
	constructor args.

	* gdk/RgbCmap.custom (Zero, New): deprecated API compat

	* gdk/PangoAttrEmbossed.custom:
	* gdk/PangoAttrStipple.custom (Zero, New, Attr): deprecated API
	compat
	(explicit operator ...): allow casting back and forth between
	Pango.Attribute. (We can't usefully make them real subclasses of
	Pango.Attribute, because there's no way for
	Pango.Attribute.GetAttribute() to be able to dtrt with them.)

	* gtk/Gtk.metadata: deprecate Gtk.Requisition.Copy,
	Gtk.TextIter.Copy, and Gtk.TreeIter.Copy. Mark the return value of
	TextView.DefaultAttributes as "owned". Mark TargetList's fields
	private so it stays how it used to be.

	* gtk/TextAttributes.custom (Zero, New): deprecated API compat

	* gnomevfs/Gnomevfs.metadata: remove a bunch of opaque
	declarations that the parser figures out on its own now.

	* art/Art.metadata:
	* glade/Glade.metadata:
	* rsvg/Rsvg.metadata: un-mark everything the parser marked opaque
	in these libraries, because all of the structs in question would
	still be unusably broken, so the API churn would be pointless.

svn path=/trunk/gtk-sharp/; revision=48387
2005-08-15 15:15:57 +00:00
..
en * parser/gapi2xml.pl (addFuncElems): if a struct or boxed type has 2005-08-15 15:15:57 +00:00
all.xml Add a makefile and a README 2003-02-14 19:59:31 +00:00
ChangeLog add an iconview example 2005-08-14 19:50:35 +00:00
gen-finalize-docs.cs add some automatic docs for the new stuff 2005-04-22 17:20:16 +00:00
gen-gtype-ctor-docs.cs 2004-12-29 John Luke <john.luke@gmail.com> 2004-12-29 18:36:31 +00:00
gen-gtype-docs.cs add some automatic docs for the new stuff 2005-04-22 17:20:16 +00:00
gen-handlerargs-docs.cs 2004-06-25 Mike Kestner <mkestner@ximian.com> 2004-06-25 16:35:15 +00:00
gen-intptr-ctor-docs.cs 2004-12-29 John Luke <john.luke@gmail.com> 2004-12-29 18:36:31 +00:00
gen-vm-docs.cs 2005-06-22 Mike Kestner <mkestner@novell.com> 2005-06-22 18:04:17 +00:00
gtk-sharp-docs.source Add doc target 2003-04-14 22:58:01 +00:00
Makefile.am more gda/gnomedb killing 2005-08-09 20:38:06 +00:00
README small update 2005-06-02 21:55:06 +00:00
scan-deprecations.cs 2004-06-25 Mike Kestner <mkestner@ximian.com> 2004-06-25 16:35:15 +00:00

Compiling and installing the Gtk# Documentation

Compile and install monodoc
    cd monodoc/
	./autogen.sh --prefix=/usr/local
	make
	make install

Compile the documentation for gtk-sharp

    	cd gtk-sharp/doc
	make assemble
	cp gtk-sharp-docs.* `pkg-config monodoc --variable=sourcesdir`

If things are fine, you should have in the Monodoc sources directory the 
following files:

gtk-sharp-docs.source
gtk-sharp-docs.tree
gtk-sharp-docs.zip
netdocs.source
netdocs.tree
netdocs.zip

Start monodoc, by typing `monodoc'

If it doesn't run, please change the paths in the makefile and point
ASSEMBLER and BROWSER to where you put your assembler.exe and browser.exe.