* makefile: the docs target is dangerous, remove it by

default. Also, remove the -f flag, so even if we do run it, it
won't overwrite files, by default.

* en/Gtk/AccelGroup.xml: From Raphael Schmid
<raphael.schmid@gmx.de>, with edits.

svn path=/trunk/gtk-sharp/; revision=11861
This commit is contained in:
Duncan Mak 2003-02-23 09:11:59 +00:00
parent 27f0e8b758
commit 67579ea128
3 changed files with 86 additions and 50 deletions

View file

@ -1,5 +1,12 @@
2003-02-23 Duncan Mak <duncan@ximian.com> 2003-02-23 Duncan Mak <duncan@ximian.com>
* makefile: the docs target is dangerous, remove it by
default. Also, remove the -f flag, so even if we do run it, it
won't overwrite files, by default.
* en/Gtk/AccelGroup.xml: From Raphael Schmid
<raphael.schmid@gmx.de>, with edits.
* en/Gtk/DirectionType.xml: * en/Gtk/DirectionType.xml:
* en/Gtk/SelectionMode.xml: More from Hector. * en/Gtk/SelectionMode.xml: More from Hector.

View file

@ -1,5 +1,5 @@
<Type Name="AccelGroup" FullName="Gtk.AccelGroup"> <Type Name="AccelGroup" FullName="Gtk.AccelGroup">
<TypeSignature Language="C#" Value="public class AccelGroup : GLib.Object, IWrapper, IDisposable" Maintainer="auto" /> <TypeSignature Language="C#" Value="public class AccelGroup : GLib.Object, IWrapper, IDisposable" Maintainer="RJS" />
<AssemblyInfo> <AssemblyInfo>
<AssemblyName>gtk-sharp</AssemblyName> <AssemblyName>gtk-sharp</AssemblyName>
<AssemblyVersion>0.0.0.0</AssemblyVersion> <AssemblyVersion>0.0.0.0</AssemblyVersion>
@ -7,8 +7,18 @@
</AssemblyInfo> </AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement> <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
<Docs> <Docs>
<summary>To be added</summary> <summary>Groups of global keyboard accelerators for an entire Window</summary>
<remarks>To be added</remarks> <remarks>
<para>
An AccelGroup represents a group of keyboard accelerators, typically attached to a toplevel <see cref="T:Gtk.Window"/> (with <see cref="M:Gtk.Window.AddAccelGroup"/>. Usually you won't need to create a Gtk.AccelGroup directly; instead, when using <see cref="T:Gtk.ItemFactory"/>, accelerators are automatically sets up for your menus in the item factory's AccelGroup.
</para>
<para>
Note that accelerators are different from mnemonics. Accelerators are shortcuts for activating a menu item; they appear alongside the menu item they're a shortcut for. For example "Ctrl+Q" might appear alongside the "Quit" menu item. Mnemonics are shortcuts for GUI elements such as text entries or buttons; they appear as underlined characters. See <see cref="M:Gtk.Label.NewWithMnemonic"/>.
</para>
<para>
Menu items can have both accelerators and mnemonics.
</para>
</remarks>
</Docs> </Docs>
<Base> <Base>
<BaseTypeName>GLib.Object</BaseTypeName> <BaseTypeName>GLib.Object</BaseTypeName>
@ -33,10 +43,10 @@
<Parameter Name="closure" Type="System.IntPtr" /> <Parameter Name="closure" Type="System.IntPtr" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Finds the <see cref="T:Gtk.AccelGroup" /> to which <paramref name="closure"/> is connected.</summary>
<param name="closure">To be added: an object of type 'IntPtr'</param> <param name="closure">A GClosure (<see cref="T:System.IntPtr" />)</param>
<returns>To be added: an object of type 'Gtk.AccelGroup'</returns> <returns>The <see cref="T:Gtk.AccelGroup" /> to which <paramref name ="closure"/> is connected, or <see cref="langword:null" />.</returns>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Unlock"> <Member MemberName="Unlock">
@ -47,8 +57,8 @@
</ReturnValue> </ReturnValue>
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Undos the last call to <see cref="M:Gtk.AccelGroup.Lock" /> on its object.</summary>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Disconnect"> <Member MemberName="Disconnect">
@ -61,10 +71,10 @@
<Parameter Name="closure" Type="System.IntPtr" /> <Parameter Name="closure" Type="System.IntPtr" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Removes an accelerator previously installed through <see cref="M:Gtk.AccelGroup.Connect" />.</summary>
<param name="closure">To be added: an object of type 'IntPtr'</param> <param name="closure">The closure to remove from this accelerator group.</param>
<returns>To be added: an object of type 'bool'</returns> <returns><see cref="langword:true" /> if the <paramref name="closure"/> was found and got disconnected</returns>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="ConnectByPath"> <Member MemberName="ConnectByPath">
@ -78,10 +88,14 @@
<Parameter Name="closure" Type="System.IntPtr" /> <Parameter Name="closure" Type="System.IntPtr" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Installs an accelerator in this group</summary>
<param name="accel_path">To be added: an object of type 'string'</param> <param name="accel_path">Path used for determining key and modifiers.</param>
<param name="closure">To be added: an object of type 'IntPtr'</param> <param name="closure">Closure to be executed upon accelerator activation</param>
<remarks>To be added</remarks> <remarks>
<para>
Installs an accelerator in this group, using an accelerator path to look up the appropriate key and modifiers. When the group is being activated in response to a call to <see cref="M:Gtk.AccelGroup.Activate" />, <paramref name="closure"/> will be invoked if the <paramref name="accel_key"/> and <paramref name="accel_mods"/> from <see cref="M:Gtk.AccelGroup.Activate" /> match the key and modifiers for the path.
</para>
</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Find"> <Member MemberName="Find">
@ -111,11 +125,15 @@
<Parameter Name="accel_mods" Type="Gdk.ModifierType" /> <Parameter Name="accel_mods" Type="Gdk.ModifierType" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Removes an accelerator previously installed through <see cref="M:Gtk.AccelGroup.Connect (uint, Gdk.ModifierType, Gtk.AccelFlags, System.IntPt)" />.</summary>
<param name="accel_key">To be added: an object of type 'uint'</param> <param name="accel_key">Key value of the accelerator.</param>
<param name="accel_mods">To be added: an object of type 'Gdk.ModifierType'</param> <param name="accel_mods">Modifier combination of the accelerator.</param>
<returns>To be added: an object of type 'bool'</returns> <returns><see cref="langword:true" /> if there was an accelerator which could be removed, <see cref="langword:false" /> otherwise.</returns>
<remarks>To be added</remarks> <remarks>
<para>
Removes an accelerator previously installed through <see cref="M:Gtk.AccelGroup.Connect (uint, Gdk.ModifierType, Gtk.AccelFlags, System.IntPt)" />.
</para>
</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Query"> <Member MemberName="Query">
@ -130,12 +148,12 @@
<Parameter Name="n_entries" Type="System.UInt32" /> <Parameter Name="n_entries" Type="System.UInt32" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Queries an accelerator group for all entries matching by accelerator key value and modifier.</summary>
<param name="accel_key">To be added: an object of type 'uint'</param> <param name="accel_key">Key value of the accelerator.</param>
<param name="accel_mods">To be added: an object of type 'Gdk.ModifierType'</param> <param name="accel_mods">Modifier combination of the accelerator.</param>
<param name="n_entries">To be added: an object of type 'uint'</param> <param name="n_entries">Location to return the number of entries found, or <see cref="langword:null" />.</param>
<returns>To be added: an object of type 'Gtk.AccelGroupEntry'</returns> <returns>An array of n_entries <see cref="T:Gtk.AccelGroupEntry" /> elements, or <see cref="langword:null" />.</returns>
<remarks>To be added</remarks> <remarks />
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Lock"> <Member MemberName="Lock">
@ -146,8 +164,12 @@
</ReturnValue> </ReturnValue>
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Locks the given accelerator group.</summary>
<remarks>To be added</remarks> <remarks>
<para>
Locking an accelerator group prevents the accelerators contained within it to be changed during runtime. Refer to <see cref="M:Gtk.AccelMap.ChangeEntry" /> about runtime accelerator changes. If called more than once, <paramref name="accel_group"/> remains locked until <see cref="M:Gtk.AccelGroup.Unlock" /> has been called an equivalent number of times.
</para>
</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Connect"> <Member MemberName="Connect">
@ -163,12 +185,19 @@
<Parameter Name="closure" Type="System.IntPtr" /> <Parameter Name="closure" Type="System.IntPtr" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Installs an accelerator in this group.</summary>
<param name="accel_key">To be added: an object of type 'uint'</param> <param name="accel_key">Key value of the accelerator.</param>
<param name="accel_mods">To be added: an object of type 'Gdk.ModifierType'</param> <param name="accel_mods">Modifier combination of the accelerator.</param>
<param name="accel_flags">To be added: an object of type 'Gtk.AccelFlags'</param> <param name="accel_flags">A flag mask to configure this accelerator.</param>
<param name="closure">To be added: an object of type 'IntPtr'</param> <param name="closure">Closure to be executed upon accelerator activation.</param>
<remarks>To be added</remarks> <remarks>
<para>
Installs an accelerator in this group. When accel_group is being activated in response to a call to <see cref="M:Gtk.AccelGroup.Activate" />, closure will be invoked if the <paramref name="accel_key"/> and <paramref name="accel_mods"/> from <see cref="M:Gtk.AccelGroup.Activate" /> match those of this connection. The signature used for the closure is that of <see cref="M:Gtk.AccelGroup.Activate" />.
</para>
<para>
Note that, due to implementation details, a single closure can only be connected to one accelerator group.
</para>
</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Finalize"> <Member MemberName="Finalize">
@ -221,9 +250,9 @@
<ReturnValue /> <ReturnValue />
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Creates a new GtkAccelGroup.</summary>
<returns>To be added: an object of type 'Gtk.AccelGroup'</returns> <returns>A new GtkAccelGroup object.</returns>
<remarks>To be added</remarks> <remarks />
</Docs> </Docs>
</Member> </Member>
<Member MemberName="GType"> <Member MemberName="GType">
@ -244,8 +273,8 @@
<ReturnValue /> <ReturnValue />
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary></summary>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
</Members> </Members>

View file

@ -3,7 +3,7 @@ BROWSER=../../monodoc/browser/browser.exe
ASSEMBLER=../../monodoc/browser/assembler.exe ASSEMBLER=../../monodoc/browser/assembler.exe
GENERATOR=../../monodoc/generator/generator.exe GENERATOR=../../monodoc/generator/generator.exe
all: docs tree all: tree
b: b:
mono --debug $(BROWSER) mono --debug $(BROWSER)
@ -13,19 +13,19 @@ tree:
docs: glib pango atk gtk gdk gnome glade docs: glib pango atk gtk gdk gnome glade
glib: glib:
mono --debug $(GENERATOR) $(LIBDIR)/glib-sharp.dll -o en -f mono --debug $(GENERATOR) $(LIBDIR)/glib-sharp.dll -o en
pango: pango:
mono --debug $(GENERATOR) $(LIBDIR)/pango-sharp.dll -o en -f mono --debug $(GENERATOR) $(LIBDIR)/pango-sharp.dll -o en
atk: atk:
mono --debug $(GENERATOR) $(LIBDIR)/atk-sharp.dll -o en -f mono --debug $(GENERATOR) $(LIBDIR)/atk-sharp.dll -o en
gtk: gtk:
mono --debug $(GENERATOR) $(LIBDIR)/gtk-sharp.dll -o en -f mono --debug $(GENERATOR) $(LIBDIR)/gtk-sharp.dll -o en
gdk: gdk:
mono --debug $(GENERATOR) $(LIBDIR)/gdk-sharp.dll -o en -f mono --debug $(GENERATOR) $(LIBDIR)/gdk-sharp.dll -o en
gnome: gnome:
mono --debug $(GENERATOR) $(LIBDIR)/gnome-sharp.dll -o en -f mono --debug $(GENERATOR) $(LIBDIR)/gnome-sharp.dll -o en
glade: glade:
mono --debug $(GENERATOR) $(LIBDIR)/glade-sharp.dll -o en -f mono --debug $(GENERATOR) $(LIBDIR)/glade-sharp.dll -o en
clean: clean:
rm *.tree rm *.tree