summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/RELEASE-HOWTO27
-rw-r--r--docs/reference/ChangeLog4
-rw-r--r--docs/reference/gdk-pixbuf/gdk-pixbuf-csource.164
-rw-r--r--docs/reference/gdk/tmpl/dnd.sgml9
-rw-r--r--docs/reference/gtk/tmpl/gtk-unused.sgml9
-rw-r--r--docs/reference/gtk/tmpl/gtkaboutdialog.sgml5
-rw-r--r--docs/reference/gtk/tmpl/gtkaction.sgml23
-rw-r--r--docs/reference/gtk/tmpl/gtkactiongroup.sgml10
-rw-r--r--docs/reference/gtk/tmpl/gtkcombobox.sgml23
-rw-r--r--docs/reference/gtk/tmpl/gtkentry.sgml27
-rw-r--r--docs/reference/gtk/tmpl/gtkfilechooser.sgml18
-rw-r--r--docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml2
-rw-r--r--docs/reference/gtk/tmpl/gtktextview.sgml7
-rw-r--r--docs/reference/gtk/tmpl/gtktreeview.sgml23
14 files changed, 197 insertions, 54 deletions
diff --git a/docs/RELEASE-HOWTO b/docs/RELEASE-HOWTO
index 9f6c6ae85..b029f91c4 100644
--- a/docs/RELEASE-HOWTO
+++ b/docs/RELEASE-HOWTO
@@ -19,24 +19,27 @@ Without those packages make distcheck will *not* pass.
3) Verify that the version in configure.in has been bumped after the last
release. (Note that this is critical, a slip-up here will cause the soname
to change).
-4) Add === Released 2.x.y === at the top of all ChangeLog files
-5) make distcheck
-6) Fix broken stuff found by 5) repeat
-7) cvs commit; you'll have a bunch of po file changes, and maybe some
+4) Make sure that make check is happy (If you don't do it here, make distcheck
+will also catch it, but it is kind of disheartening to see make distcheck fail
+due to an extraneous symbol after watching it build the docs for an hour...)
+5) Add === Released 2.x.y === at the top of all ChangeLog files
+6) make distcheck
+7) Fix broken stuff found by 5) repeat
+8) cvs commit; you'll have a bunch of po file changes, and maybe some
doc changes too (NOTE: be sure to use cvs with compression, else you'll
end up waiting for a long time :).
-8) If 7) fails because someone else committed inbetween, curse, cvs up,
+9) If 7) fails because someone else committed inbetween, curse, cvs up,
fix conflicts and go to 5)
-9) type 'cvs tag GTK_2_x_y' in the toplevel directory
-10) You now have the tarball, and the CVS tag, now upload the tarball to
+10) type 'cvs tag GTK_2_x_y' in the toplevel directory
+11) You now have the tarball, and the CVS tag, now upload the tarball to
gnome.org and gtk.org
-11) Go to the gnome-announce list archives, find the last announce message,
+12) Go to the gnome-announce list archives, find the last announce message,
create a new message in the same form, replacing version numbers, commentary
at the top about "what this release is about" and the Summary of changes.
-12) Send it to gnome-announce-list, gtk-list, gtk-app-devel-list and
+13) Send it to gnome-announce-list, gtk-list, gtk-app-devel-list and
gtk-devel-list. Set reply-to to gnome-hackers.
-13) Bump the version number in configure.in.
-14) Create a new milestone in bugzilla and move the remaining bugs from the
+14) Bump the version number in configure.in.
+15) Create a new milestone in bugzilla and move the remaining bugs from the
2.x.y milestone over to the new one.
-15) Add a link to the release announcement to www.gtk.org which lives in
+16) Add a link to the release announcement to www.gtk.org which lives in
the gtk-web cvs module.
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index f568b06dd..920a67568 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,7 @@
+2004-08-25 Matthias Clasen <mclasen@redhat.com>
+
+ * === Released 2.5.2 ===
+
2004-08-24 Matthias Clasen <mclasen@redhat.com>
* gdk-pixbuf/gdk-pixbuf-csource.xml: Document bugs of
diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf-csource.1 b/docs/reference/gdk-pixbuf/gdk-pixbuf-csource.1
index 9f36e4b2e..a98fde75e 100644
--- a/docs/reference/gdk-pixbuf/gdk-pixbuf-csource.1
+++ b/docs/reference/gdk-pixbuf/gdk-pixbuf-csource.1
@@ -21,77 +21,81 @@
.SH NAME
gdk-pixbuf-csource \- C code generation utility for GdkPixbuf images
.SH "SYNOPSIS"
-
-.nf
-\fBgdk-pixbuf-csource\fR [options] [image]
-.fi
-
-.nf
-\fBgdk-pixbuf-csource\fR [options] --build-list [[name] [image]...]
-.fi
+.ad l
+.hy 0
+.HP 19
+\fBgdk\-pixbuf\-csource\fR [options] [image]
+.ad
+.hy
+.ad l
+.hy 0
+.HP 19
+\fBgdk\-pixbuf\-csource\fR [options] \-\-build\-list [[name]\ [image]...]
+.ad
+.hy
.SH "DESCRIPTION"
.PP
- \fBgdk-pixbuf-csource\fR is a small utility that generates C code containing images, useful for compiling images directly into programs\&.
+ \fBgdk\-pixbuf\-csource\fR is a small utility that generates C code containing images, useful for compiling images directly into programs\&.
.SH "INVOCATION"
.PP
- \fBgdk-pixbuf-csource\fR either takes as input one image file name to generate code for, or, using the \fB--build-list\fR option, a list of (\fIname\fR, \fIimage\fR) pairs to generate code for a list of images into named variables\&.
+ \fBgdk\-pixbuf\-csource\fR either takes as input one image file name to generate code for, or, using the \fB\-\-build\-list\fR option, a list of (\fIname\fR, \fIimage\fR) pairs to generate code for a list of images into named variables\&.
.SS "Options"
.TP
-\fB--stream\fR
+\fB\-\-stream\fR
Generate pixbuf data stream (a single string containing a serialized GdkPixdata structure in network byte order)\&.
.TP
-\fB--struct\fR
-Generate GdkPixdata structure (needs the GdkPixdata structure definition from \fIgdk-pixdata\&.h\fR)\&.
+\fB\-\-struct\fR
+Generate GdkPixdata structure (needs the GdkPixdata structure definition from \fIgdk\-pixdata\&.h\fR)\&.
.TP
-\fB--macros\fR
+\fB\-\-macros\fR
Generate *_ROWSTRIDE, *_WIDTH, *_HEIGHT, *_BYTES_PER_PIXEL and *_RLE_PIXEL_DATA or *_PIXEL_DATA macro definitions for the image\&.
.TP
-\fB--rle\fR
-Enables run-length encoding for the generated pixel data (default)\&.
+\fB\-\-rle\fR
+Enables run\-length encoding for the generated pixel data (default)\&.
.TP
-\fB--raw\fR
-Disables run-length encoding for the generated pixel data\&.
+\fB\-\-raw\fR
+Disables run\-length encoding for the generated pixel data\&.
.TP
-\fB--extern\fR
+\fB\-\-extern\fR
Generate extern symbols\&.
.TP
-\fB--static\fR
+\fB\-\-static\fR
Generate static symbols (default)\&.
.TP
-\fB--decoder\fR
-Provide a *_RUN_LENGTH_DECODE(image_buf, rle_data, size, bpp) macro definition to decode run-length encoded image data\&.
+\fB\-\-decoder\fR
+Provide a *_RUN_LENGTH_DECODE(image_buf, rle_data, size, bpp) macro definition to decode run\-length encoded image data\&.
.TP
-\fB--name=identifier\fR
-Specifies the identifier name (prefix) for the generated variables or macros (useful only if \fB--build-list\fR was not specified)\&.
+\fB\-\-name=identifier\fR
+Specifies the identifier name (prefix) for the generated variables or macros (useful only if \fB\-\-build\-list\fR was not specified)\&.
.TP
-\fB--build-list\fR
+\fB\-\-build\-list\fR
Enables (\fIname\fR, \fIimage\fR) pair parsing mode\&.
.TP
-\fB-h\fR, \fB--help\fR
+\fB\-h\fR, \fB\-\-help\fR
Print brief help and exit\&.
.TP
-\fB-v\fR, \fB--version\fR
+\fB\-v\fR, \fB\-\-version\fR
Print version and exit\&.
.TP
-\fB--g-fatal-warnings\fR
+\fB\-\-g\-fatal\-warnings\fR
Make warnings fatal (causes the program to abort)\&.
.SH "SEE ALSO"
@@ -102,12 +106,12 @@ The GdkPixbuf documentation, shipped with the Gtk+ distribution, available from
.SH "BUGS"
.PP
-None known yet\&.
+The runlength encoder gets out of sync with the pixel boundaries, since it includes the rowstride padding in the encoded stream\&. Furthermore, it generates pixbufs with suboptimal rowstride in some cases\&.
.SH "AUTHOR"
.PP
- \fBgdk-pixbuf-csource\fR was written by Tim Janik <timj@gtk\&.org>\&.
+ \fBgdk\-pixbuf\-csource\fR was written by Tim Janik <timj@gtk\&.org>\&.
.PP
This manual page was provided by Tim Janik <timj@gtk\&.org>\&.
diff --git a/docs/reference/gdk/tmpl/dnd.sgml b/docs/reference/gdk/tmpl/dnd.sgml
index d0e9b2aef..4dfdcc051 100644
--- a/docs/reference/gdk/tmpl/dnd.sgml
+++ b/docs/reference/gdk/tmpl/dnd.sgml
@@ -213,3 +213,12 @@ should do with the dropped data.
@time_:
+<!-- ##### FUNCTION gdk_drag_drop_succeeded ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
diff --git a/docs/reference/gtk/tmpl/gtk-unused.sgml b/docs/reference/gtk/tmpl/gtk-unused.sgml
index 70a79fa3d..285c8ed9e 100644
--- a/docs/reference/gtk/tmpl/gtk-unused.sgml
+++ b/docs/reference/gtk/tmpl/gtk-unused.sgml
@@ -1639,6 +1639,15 @@ If the window shrinks automatically when widgets within it shrink.
@notify_data:
@notify_func:
+<!-- ##### FUNCTION gtk_action_group_translate_string ##### -->
+<para>
+
+</para>
+
+@action_group:
+@string:
+@Returns:
+
<!-- ##### FUNCTION gtk_arg_copy ##### -->
<para>
It will either copy data into an existing argument or allocate a new argument
diff --git a/docs/reference/gtk/tmpl/gtkaboutdialog.sgml b/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
index 57925aa09..b5677acc8 100644
--- a/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
@@ -265,6 +265,7 @@ link is activated.
@about: the #GtkAboutDialog in which the link was activated
@link: the URL or email address to whiche the activated link points
+@data:
<!-- ##### FUNCTION gtk_about_dialog_set_email_hook ##### -->
@@ -273,6 +274,8 @@ link is activated.
</para>
@func:
+@data:
+@destroy:
@Returns:
@@ -282,6 +285,8 @@ link is activated.
</para>
@func:
+@data:
+@destroy:
@Returns:
diff --git a/docs/reference/gtk/tmpl/gtkaction.sgml b/docs/reference/gtk/tmpl/gtkaction.sgml
index fb425ead8..0ce3f627d 100644
--- a/docs/reference/gtk/tmpl/gtkaction.sgml
+++ b/docs/reference/gtk/tmpl/gtkaction.sgml
@@ -117,6 +117,11 @@ and should not be accessed directly.
</para>
+<!-- ##### ARG GtkAction:visible-overflown ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkAction:visible-vertical ##### -->
<para>
@@ -161,6 +166,15 @@ and should not be accessed directly.
@Returns:
+<!-- ##### FUNCTION gtk_action_set_sensitive ##### -->
+<para>
+
+</para>
+
+@action:
+@sensitive:
+
+
<!-- ##### FUNCTION gtk_action_is_visible ##### -->
<para>
@@ -179,6 +193,15 @@ and should not be accessed directly.
@Returns:
+<!-- ##### FUNCTION gtk_action_set_visible ##### -->
+<para>
+
+</para>
+
+@action:
+@visible:
+
+
<!-- ##### FUNCTION gtk_action_activate ##### -->
<para>
diff --git a/docs/reference/gtk/tmpl/gtkactiongroup.sgml b/docs/reference/gtk/tmpl/gtkactiongroup.sgml
index e364a932e..6ec1b5fea 100644
--- a/docs/reference/gtk/tmpl/gtkactiongroup.sgml
+++ b/docs/reference/gtk/tmpl/gtkactiongroup.sgml
@@ -332,13 +332,3 @@ gtk_action_group_add_radio_actions() to construct groups of radio actions.
@domain:
-<!-- ##### FUNCTION gtk_action_group_translate_string ##### -->
-<para>
-
-</para>
-
-@action_group:
-@string:
-@Returns:
-
-
diff --git a/docs/reference/gtk/tmpl/gtkcombobox.sgml b/docs/reference/gtk/tmpl/gtkcombobox.sgml
index d98e091bf..d06e873a5 100644
--- a/docs/reference/gtk/tmpl/gtkcombobox.sgml
+++ b/docs/reference/gtk/tmpl/gtkcombobox.sgml
@@ -42,6 +42,11 @@ a widget used to choose from a list of items.
</para>
+<!-- ##### ARG GtkComboBox:focus-on-click ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkComboBox:has-frame ##### -->
<para>
@@ -314,3 +319,21 @@ a widget used to choose from a list of items.
@Returns:
+<!-- ##### FUNCTION gtk_combo_box_set_focus_on_click ##### -->
+<para>
+
+</para>
+
+@combo:
+@focus_on_click:
+
+
+<!-- ##### FUNCTION gtk_combo_box_get_focus_on_click ##### -->
+<para>
+
+</para>
+
+@combo:
+@Returns:
+
+
diff --git a/docs/reference/gtk/tmpl/gtkentry.sgml b/docs/reference/gtk/tmpl/gtkentry.sgml
index 92204167f..61976ba52 100644
--- a/docs/reference/gtk/tmpl/gtkentry.sgml
+++ b/docs/reference/gtk/tmpl/gtkentry.sgml
@@ -38,6 +38,13 @@ The #GtkEntry-struct struct contains only private data.
@entry: the object which received the signal.
+<!-- ##### SIGNAL GtkEntry::backspace ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+
<!-- ##### SIGNAL GtkEntry::copy-clipboard ##### -->
<para>
@@ -395,6 +402,26 @@ use gtk_editable_set_editable() instead.
@y:
+<!-- ##### FUNCTION gtk_entry_layout_index_to_text_index ##### -->
+<para>
+
+</para>
+
+@entry:
+@layout_index:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_entry_text_index_to_layout_index ##### -->
+<para>
+
+</para>
+
+@entry:
+@text_index:
+@Returns:
+
+
<!-- ##### FUNCTION gtk_entry_get_max_length ##### -->
<para>
diff --git a/docs/reference/gtk/tmpl/gtkfilechooser.sgml b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
index 177e91aea..0272a9b7c 100644
--- a/docs/reference/gtk/tmpl/gtkfilechooser.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
@@ -550,6 +550,24 @@ class "GtkFileChooserDefault" binding "my-own-gtkfilechooser-bindings"
@Returns:
+<!-- ##### FUNCTION gtk_file_chooser_set_show_hidden ##### -->
+<para>
+
+</para>
+
+@chooser:
+@show_hidden:
+
+
+<!-- ##### FUNCTION gtk_file_chooser_get_show_hidden ##### -->
+<para>
+
+</para>
+
+@chooser:
+@Returns:
+
+
<!-- ##### FUNCTION gtk_file_chooser_set_current_name ##### -->
<para>
diff --git a/docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml b/docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml
index 9cbcee6f2..cd24bfe33 100644
--- a/docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml
@@ -9,13 +9,11 @@ GtkFileChooserButton
</para>
-
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
-
<!-- ##### STRUCT GtkFileChooserButton ##### -->
<para>
diff --git a/docs/reference/gtk/tmpl/gtktextview.sgml b/docs/reference/gtk/tmpl/gtktextview.sgml
index bfbebedba..9cd8bd053 100644
--- a/docs/reference/gtk/tmpl/gtktextview.sgml
+++ b/docs/reference/gtk/tmpl/gtktextview.sgml
@@ -26,6 +26,13 @@ types related to the text widget and how they work together.
</para>
+<!-- ##### SIGNAL GtkTextView::backspace ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+
<!-- ##### SIGNAL GtkTextView::copy-clipboard ##### -->
<para>
diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml
index a1095d034..7cad5580d 100644
--- a/docs/reference/gtk/tmpl/gtktreeview.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeview.sgml
@@ -191,6 +191,11 @@ linkend="GtkTreeModel">GtkTreeModel</link> interface.
</para>
+<!-- ##### ARG GtkTreeView:hover-expand ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkTreeView:hover-selection ##### -->
<para>
@@ -989,6 +994,24 @@ has some similarity to strcmp() returning 0 for equal strings.
@hover:
+<!-- ##### FUNCTION gtk_tree_view_get_hover_expand ##### -->
+<para>
+
+</para>
+
+@tree_view:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_tree_view_set_hover_expand ##### -->
+<para>
+
+</para>
+
+@tree_view:
+@expand:
+
+
<!-- ##### USER_FUNCTION GtkTreeDestroyCountFunc ##### -->
<para>