X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=docs%2Freference%2Fgtk%2Ftmpl%2Fgtkrc.sgml;h=305bc63e36fec8b0da189c9d0119afccb052964e;hb=7447ef0fc24dc046b92b55e75c02ff0725b85680;hp=3fd1be54176435b81ab8e8e81cce11b3a453d02e;hpb=51ddf0e1c9280faf020a916974f2535ed3f5f14f;p=~andy%2Fgtk
diff --git a/docs/reference/gtk/tmpl/gtkrc.sgml b/docs/reference/gtk/tmpl/gtkrc.sgml
index 3fd1be541..305bc63e3 100644
--- a/docs/reference/gtk/tmpl/gtkrc.sgml
+++ b/docs/reference/gtk/tmpl/gtkrc.sgml
@@ -16,14 +16,13 @@ at runtime.
An application can cause GTK+ to parse a specific RC
file by calling gtk_rc_parse(). In addition to this,
certain files will be read at the end of gtk_init().
-Unless modified, the files looked for will be
-<SYSCONFDIR>/gtk-2.0/gtkrc
-and .gtkrc-2.0 in the users home directory.
-(<SYSCONFDIR> defaults to
+Unless modified, the files looked for will be
+<SYSCONFDIR>/gtk-2.0/gtkrc
+and .gtkrc-3.0 in the users home directory.
+(<SYSCONFDIR> defaults to
/usr/local/etc. It can be changed with the
- or options when
-configuring GTK+.) Note that although the filenames contain the version
-number 2.0, all 2.x versions of GTK+ look for these files.
+ or options when
+configuring GTK+.)
The set of these default files
@@ -35,11 +34,11 @@ can be set to a #G_SEARCHPATH_SEPARATOR_S-separated list of files
in order to overwrite the set of default files at runtime.
-For each RC file, in addition to the file itself, GTK+ will look for
-a locale-specific file that will be parsed after the main file.
+For each RC file, in addition to the file itself, GTK+ will look for
+a locale-specific file that will be parsed after the main file.
For instance, if LANG is set to ja_JP.ujis,
-when loading the default file ~/.gtkrc then GTK+ looks
-for ~/.gtkrc.ja_JP and ~/.gtkrc.ja,
+when loading the default file ~/.gtkrc then GTK+ looks
+for ~/.gtkrc.ja_JP and ~/.gtkrc.ja,
and parses the first of those that exists.
@@ -57,29 +56,29 @@ of such a statement:
widget "mywindow.*.GtkEntry" style "my-entry-class"
-attaches the style "my-entry-class" to all
-widgets whose widget path matches the
-pattern"mywindow.*.GtkEntry".
-That is, all #GtkEntry widgets which are part of a #GtkWindow named
+attaches the style "my-entry-class" to all
+widgets whose widget path matches the
+pattern"mywindow.*.GtkEntry".
+That is, all #GtkEntry widgets which are part of a #GtkWindow named
"mywindow".
-The patterns here are given in the standard shell glob syntax.
-The "?" wildcard matches any character, while
-"*" matches zero or more of any character.
+The patterns here are given in the standard shell glob syntax.
+The "?" wildcard matches any character, while
+"*" matches zero or more of any character.
The three types of matching are against the widget path, the
-class path and the class hierarchy. Both the
-widget path and the class path consist of a "."
-separated list of all the parents of the widget and the widget itself
-from outermost to innermost. The difference is that in the widget path,
-the name assigned by gtk_widget_set_name() is used if present, otherwise
-the class name of the widget, while for the class path, the class name is
+class path and the class hierarchy. Both the
+widget path and the class path consist of a "."
+separated list of all the parents of the widget and the widget itself
+from outermost to innermost. The difference is that in the widget path,
+the name assigned by gtk_widget_set_name() is used if present, otherwise
+the class name of the widget, while for the class path, the class name is
always used.
Since GTK+ 2.10,widget_class paths can also contain
-<classname> substrings, which are matching
+<classname> substrings, which are matching
the class with the given name and any derived classes. For instance,
widget_class "*<GtkMenuItem>.GtkLabel" style "my-style"
@@ -87,14 +86,14 @@ widget_class "*<GtkMenuItem>.GtkLabel" style "my-style"
will match #GtkLabel widgets which are contained in any kind of menu item.
-So, if you have a #GtkEntry named "myentry", inside of a
+So, if you have a #GtkEntry named "myentry", inside of a
horizontal box in a window named "mywindow", then the
widget path is: "mywindow.GtkHBox.myentry"
while the class path is: "GtkWindow.GtkHBox.GtkEntry".
Matching against class is a little different. The pattern match is done
-against all class names in the widgets class hierarchy (not the layout
+against all class names in the widgets class hierarchy (not the layout
hierarchy) in sequence, so the pattern:
class "GtkButton" style "my-style"
@@ -737,6 +736,9 @@ same as for styles.
+
+
+
The #GtkRcStyle structure is used to represent a set
@@ -822,6 +824,7 @@ specific portions of a RC file.
+@void:
@Returns:
@@ -845,45 +848,6 @@ specific portions of a RC file.
@Returns:
-
-
-Adds a #GtkRcStyle that will be looked up by a match against
-the widget's pathname. This is equivalent to a:
- widget PATTERN style STYLE
-statement in a RC file.
-
-
-@rc_style: the #GtkRcStyle to use for widgets matching @pattern
-@pattern: the pattern
-@Deprecated: Use gtk_rc_parse_string() with a suitable string instead.
-
-
-
-
-Adds a #GtkRcStyle that will be looked up by a match against
-the widget's class pathname. This is equivalent to a:
-widget_class PATTERN style STYLE
-statement in a RC file.
-
-
-@rc_style: the #GtkRcStyle to use for widgets matching @pattern
-@pattern: the pattern
-@Deprecated: Use gtk_rc_parse_string() with a suitable string instead.
-
-
-
-
-Adds a #GtkRcStyle that will be looked up by a matching against
-the class hierarchy of the widget. This is equivalent to a:
-class PATTERN style STYLE
-statement in a RC file.
-
-
-@rc_style: the #GtkRcStyle to use for widgets deriving from @pattern
-@pattern: the pattern
-@Deprecated: Use gtk_rc_parse_string() with a suitable string instead.
-
-
Parses a given resource file.
@@ -905,6 +869,7 @@ Parses resource information directly from a string.
+@void:
@Returns:
@@ -937,6 +902,7 @@ Parses resource information directly from a string.
+@void:
@Returns:
@@ -1018,6 +984,7 @@ otherwise %NULL.
+@void:
@Returns:
@@ -1026,6 +993,7 @@ otherwise %NULL.
+@void:
@Returns:
@@ -1034,6 +1002,7 @@ otherwise %NULL.
+@void:
@Returns:
@@ -1044,6 +1013,7 @@ be installed. (GTK+ does not actually use this directory
itself.)
+@void:
@Returns: The directory (must be freed with g_free()).
@@ -1053,6 +1023,7 @@ Creates a new #GtkRcStyle with no fields set and
a reference count of 1.
+@void:
@Returns: the newly-created #GtkRcStyle
@@ -1065,22 +1036,3 @@ a reference count of 1.
@Returns:
-
-
-Increments the reference count of a #GtkRcStyle.
-
-
-@rc_style: a #GtkRcStyle
-@Deprecated: Use g_object_ref() instead
-
-
-
-
-Decrements the reference count of a #GtkRcStyle and
-frees if the result is 0.
-
-
-@rc_style: a #GtkRcStyle
-@Deprecated: Use g_object_unref() instead
-
-