Commit 9ddcb3e0 authored by Havoc Pennington's avatar Havoc Pennington Committed by Havoc Pennington
Browse files

default xscale/yscale to 0.0, not 0.5, 0.5 isn't useful

2001-09-08  Havoc Pennington  <hp@pobox.com>

	* gtk/gtkalignment.c (gtk_alignment_class_init): default
	xscale/yscale to 0.0, not 0.5, 0.5 isn't useful

	* tests/testtextbuffer.c: fix usage of gtk_text_iter_spew

	* gtk/gtktextiter.c: fix docs
	(gtk_text_iter_spew): get rid of this

	* gtk/gtklayout.c: docs

	* gtk/gtkbutton.c (gtk_button_construct_child): add an alignment
	to center image and label together, instead of having image on
	left and label centered, patch/suggestion from Jacob

	* gtk/gtkdialog.c: docs

2001-09-08  Havoc Pennington  <hp@pobox.com>

	* gtk/tmpl/gtklayout.sgml: docs

	* gdk-pixbuf/gdk-pixbuf.sgml: remove the section on compiling
	gdk-pixbuf since it isn't a standalone package anymore

	* gtk/building.sgml: section on compiling GTK itself
parent 9e1fc3a7
2001-09-08 Havoc Pennington <hp@pobox.com>
* gtk/gtkalignment.c (gtk_alignment_class_init): default
xscale/yscale to 0.0, not 0.5, 0.5 isn't useful
* tests/testtextbuffer.c: fix usage of gtk_text_iter_spew
* gtk/gtktextiter.c: fix docs
(gtk_text_iter_spew): get rid of this
* gtk/gtklayout.c: docs
* gtk/gtkbutton.c (gtk_button_construct_child): add an alignment
to center image and label together, instead of having image on
left and label centered, patch/suggestion from Jacob
* gtk/gtkdialog.c: docs
Sat Sep 8 14:19:49 2001 Jonathan Blandford <jrb@redhat.com>
* gtk/gtkliststore.c: Write documentation
......
2001-09-08 Havoc Pennington <hp@pobox.com>
* gtk/gtkalignment.c (gtk_alignment_class_init): default
xscale/yscale to 0.0, not 0.5, 0.5 isn't useful
* tests/testtextbuffer.c: fix usage of gtk_text_iter_spew
* gtk/gtktextiter.c: fix docs
(gtk_text_iter_spew): get rid of this
* gtk/gtklayout.c: docs
* gtk/gtkbutton.c (gtk_button_construct_child): add an alignment
to center image and label together, instead of having image on
left and label centered, patch/suggestion from Jacob
* gtk/gtkdialog.c: docs
Sat Sep 8 14:19:49 2001 Jonathan Blandford <jrb@redhat.com>
* gtk/gtkliststore.c: Write documentation
......
2001-09-08 Havoc Pennington <hp@pobox.com>
* gtk/gtkalignment.c (gtk_alignment_class_init): default
xscale/yscale to 0.0, not 0.5, 0.5 isn't useful
* tests/testtextbuffer.c: fix usage of gtk_text_iter_spew
* gtk/gtktextiter.c: fix docs
(gtk_text_iter_spew): get rid of this
* gtk/gtklayout.c: docs
* gtk/gtkbutton.c (gtk_button_construct_child): add an alignment
to center image and label together, instead of having image on
left and label centered, patch/suggestion from Jacob
* gtk/gtkdialog.c: docs
Sat Sep 8 14:19:49 2001 Jonathan Blandford <jrb@redhat.com>
* gtk/gtkliststore.c: Write documentation
......
2001-09-08 Havoc Pennington <hp@pobox.com>
* gtk/gtkalignment.c (gtk_alignment_class_init): default
xscale/yscale to 0.0, not 0.5, 0.5 isn't useful
* tests/testtextbuffer.c: fix usage of gtk_text_iter_spew
* gtk/gtktextiter.c: fix docs
(gtk_text_iter_spew): get rid of this
* gtk/gtklayout.c: docs
* gtk/gtkbutton.c (gtk_button_construct_child): add an alignment
to center image and label together, instead of having image on
left and label centered, patch/suggestion from Jacob
* gtk/gtkdialog.c: docs
Sat Sep 8 14:19:49 2001 Jonathan Blandford <jrb@redhat.com>
* gtk/gtkliststore.c: Write documentation
......
2001-09-08 Havoc Pennington <hp@pobox.com>
* gtk/gtkalignment.c (gtk_alignment_class_init): default
xscale/yscale to 0.0, not 0.5, 0.5 isn't useful
* tests/testtextbuffer.c: fix usage of gtk_text_iter_spew
* gtk/gtktextiter.c: fix docs
(gtk_text_iter_spew): get rid of this
* gtk/gtklayout.c: docs
* gtk/gtkbutton.c (gtk_button_construct_child): add an alignment
to center image and label together, instead of having image on
left and label centered, patch/suggestion from Jacob
* gtk/gtkdialog.c: docs
Sat Sep 8 14:19:49 2001 Jonathan Blandford <jrb@redhat.com>
* gtk/gtkliststore.c: Write documentation
......
2001-09-08 Havoc Pennington <hp@pobox.com>
* gtk/gtkalignment.c (gtk_alignment_class_init): default
xscale/yscale to 0.0, not 0.5, 0.5 isn't useful
* tests/testtextbuffer.c: fix usage of gtk_text_iter_spew
* gtk/gtktextiter.c: fix docs
(gtk_text_iter_spew): get rid of this
* gtk/gtklayout.c: docs
* gtk/gtkbutton.c (gtk_button_construct_child): add an alignment
to center image and label together, instead of having image on
left and label centered, patch/suggestion from Jacob
* gtk/gtkdialog.c: docs
Sat Sep 8 14:19:49 2001 Jonathan Blandford <jrb@redhat.com>
* gtk/gtkliststore.c: Write documentation
......
2001-09-08 Havoc Pennington <hp@pobox.com>
* gtk/gtkalignment.c (gtk_alignment_class_init): default
xscale/yscale to 0.0, not 0.5, 0.5 isn't useful
* tests/testtextbuffer.c: fix usage of gtk_text_iter_spew
* gtk/gtktextiter.c: fix docs
(gtk_text_iter_spew): get rid of this
* gtk/gtklayout.c: docs
* gtk/gtkbutton.c (gtk_button_construct_child): add an alignment
to center image and label together, instead of having image on
left and label centered, patch/suggestion from Jacob
* gtk/gtkdialog.c: docs
Sat Sep 8 14:19:49 2001 Jonathan Blandford <jrb@redhat.com>
* gtk/gtkliststore.c: Write documentation
......
2001-09-08 Havoc Pennington <hp@pobox.com>
* gtk/tmpl/gtklayout.sgml: docs
* gdk-pixbuf/gdk-pixbuf.sgml: remove the section on compiling
gdk-pixbuf since it isn't a standalone package anymore
* gtk/building.sgml: section on compiling GTK itself
2001-09-08 Havoc Pennington <hp@pobox.com>
* gtk/gtk-sections.txt: put GtkPacker back in here so it won't be
......
......@@ -38,7 +38,6 @@ HTML_IMAGES =
# Extra SGML files that are included by DOC_MAIN_SGML_FILE
content_files = \
compiling.sgml \
gdk-pixbuf.sgml \
porting-from-imlib.sgml
......
......@@ -14,7 +14,6 @@
<!entity gdk-pixbuf-gdk-pixbuf-xlib-rgb SYSTEM "sgml/gdk-pixbuf-xlib-rgb.sgml">
<!entity Porting-From-Imlib SYSTEM "porting-from-imlib.sgml">
<!entity Compiling SYSTEM "compiling.sgml">
<!entity gdk-pixbuf "<application>gdk-pixbuf</application>">
<!entity Imlib "<application>Imlib</application>">
......@@ -101,7 +100,6 @@
</reference>
&Porting-From-Imlib;
&Compiling;
<!-- License -->
......
......@@ -52,9 +52,11 @@ HTML_IMAGES =
# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE)
content_files = \
building.sgml \
compiling.sgml \
framebuffer.sgml \
objects_grouped.sgml \
resources.sgml \
text_widget.sgml \
tree_widget.sgml
......
<appendix id="compiling">
<title>Compiling the &gdk-pixbuf; library</title>
<refentry id="gtk-building" revision="6 Sept 2001">
<refmeta>
<refentrytitle>Compiling the GTK+ package</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>
<para>
This appendix describes the special options you can use while
compiling the &gdk-pixbuf; library.
</para>
<refnamediv>
<refname>Compiling the GTK+ Package</refname>
<refpurpose>
How to compile GTK+ itself
</refpurpose>
</refnamediv>
<sect1 id="building">
<title>Building the Library</title>
<refsect1 id="building">
<title>Building the Library on UNIX</title>
<para>
The &gdk-pixbuf; library uses the standard GNU build system,
On UNIX, GTK+ uses the standard GNU build system,
using <application>autoconf</application> for package
configuration and resolving portability issues,
<application>automake</application> for building makefiles
that comply with the GNU Coding Standards, and
<application>libtool</application> for building shared
libraries on multiple platforms. The normal sequence for
compiling and installing the &gdk-pixbuf; library is thus:
compiling and installing the GTK+ library is thus:
<literallayout>
<userinput>./configure</userinput>
......@@ -33,14 +39,14 @@
<command>./configure --help</command> for information about
the standard options.
</para>
</sect1>
</refsect1>
<sect1 id="extra-configuration-options">
<refsect1 id="extra-configuration-options">
<title>Extra Configuration Options</title>
<para>
In addition to the normal options, the
<command>configure</command> script in the &gdk-pixbuf;
<command>configure</command> script in the GTK+
library supports these additional arguments:
<cmdsynopsis>
......@@ -50,11 +56,20 @@
<arg>--disable-modules</arg>
<arg>--enable-modules</arg>
</group>
<group>
<arg>--with-included-loaders==LOADER1,LOADER2,...</arg>
</group>
<group>
<arg>--disable-gtk-doc</arg>
<arg>--enable-gtk-doc</arg>
</group>
<group>
<arg>--with-gdktarget=[x11|linux-fb]</arg>
</group>
<group>
<arg>--disable-shadowfb</arg>
<arg>--enable-shadowfb</arg>
</group>
</cmdsynopsis>
</para>
......@@ -63,11 +78,11 @@
<systemitem>--enable-modules</systemitem></title>
<para>
Normally &gdk-pixbuf; will try to build the image file
Normally GTK+ will try to build the GdkPixbuf image file
format loaders as little shared libraries that are loaded on
demand. The <systemitem>--disable-modules</systemitem>
argument indicates that they should all be built statically
into the &gdk-pixbuf; library instead. This is useful for
into the GTK+ library instead. This is useful for
people who need to produce statically-linked binaries. If
neither <systemitem>--disable-modules</systemitem> nor
<systemitem>--enable-modules</systemitem> is specified, then
......@@ -76,6 +91,16 @@
</para>
</formalpara>
<formalpara>
<title><systemitem>--with-included-loaders</systemitem></title>
<para>
This option allows you to specify which image loaders you
want to include; for example, you might include only the PNG
loader to create a smaller GdkPixbuf binary.
</para>
</formalpara>
<formalpara>
<title><systemitem>--disable-gtk-doc</systemitem> and
<systemitem>--enable-gtk-doc</systemitem></title>
......@@ -85,19 +110,33 @@
to auto-detect whether the
<application>gtk-doc</application> package is installed. If
it is, then it will use it to extract and build the
documentation for the &gdk-pixbuf; library. These options
documentation for the GTK+ library. These options
can be used to explicitly control whether gtk-doc should be
used or not. If it is not used, the distributed,
pre-generated HTML files will be installed instead of
building them on your machine.
</para>
</formalpara>
</sect1>
</appendix>
<!--
Local variables:
mode: sgml
sgml-parent-document: ("gdk-pixbuf.sgml" "book" "book" "")
End:
-->
<formalpara>
<title><systemitem>--with-gdktarget</systemitem></title>
<para>
Toggles between the x11 and linux-fb backends for GDK.
The default is x11.
</para>
</formalpara>
<formalpara>
<title><systemitem>--disable-shadowfb</systemitem> and
<systemitem>--enable-shadowfb</systemitem></title>
<para>
Toggles shadow framebuffer support for the linux-fb target,
if selected.
</para>
</formalpara>
</refsect1>
</refentry>
......@@ -139,6 +139,7 @@
<!entity gtk-TextWidget SYSTEM "text_widget.sgml">
<!entity gtk-TreeWidget SYSTEM "tree_widget.sgml">
<!entity gtk-Compiling SYSTEM "compiling.sgml">
<!entity gtk-Building SYSTEM "building.sgml">
<!entity gtk-Resources SYSTEM "resources.sgml">
<!entity gtk-Windows SYSTEM "windows.sgml">
<!entity gtk-Framebuffer SYSTEM "framebuffer.sgml">
......@@ -229,6 +230,7 @@ that is, GUI components such as #GtkButton or #GtkTextView.
</variablelist>
</para>
&gtk-Building;
&gtk-Compiling;
&gtk-Resources;
&gtk-Windows;
......
......@@ -2288,7 +2288,6 @@ gtk_text_iter_equal
gtk_text_iter_compare
gtk_text_iter_in_range
gtk_text_iter_order
gtk_text_iter_spew
</SECTION>
<SECTION>
......
......@@ -1705,13 +1705,6 @@ arrow.
@show_toggle_indicator: unused
@show_submenu_indicator: whether to show the arrow or not
<!-- ##### MACRO gtk_notebook_set_page ##### -->
<para>
</para>
@notebook:
@page_num:
<!-- ##### FUNCTION gtk_object_arg_get ##### -->
<para>
Private function to get an argument and argument info from an object.
......@@ -2160,6 +2153,14 @@ Creates a border around the arrows of a #GtkSpinButton. The type of border is de
@first:
@second:
<!-- ##### FUNCTION gtk_text_iter_spew ##### -->
<para>
</para>
@iter:
@desc:
<!-- ##### FUNCTION gtk_text_view_set_text_window_size ##### -->
<para>
......
......@@ -5,16 +5,18 @@ GtkHScrollbar
A horizontal scrollbar
<!-- ##### SECTION Long_Description ##### -->
<para>
The HScrollbar widget is a widget arranged horizontally creating a scroll
bar. See #GtkScrollbar for details on scrollbars. #GtkAdjustment pointers may be
added to handle the adjustment of the scrollbars or it may be left NULL in which
case one will be created you. See #GtkAdjustment for details.
The HScrollbar widget is a widget arranged horizontally creating a
scroll bar. See #GtkScrollbar for details on
scrollbars. #GtkAdjustment pointers may be added to handle the
adjustment of the scrollbars or it may be left NULL in which case one
will be created you. See #GtkAdjustment for details.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
#GtkScrollbar, #GtkScrolledWindow
</para>
<!-- ##### STRUCT GtkHScrollbar ##### -->
......
......@@ -3,15 +3,28 @@ GtkLayout
<!-- ##### SECTION Short_Description ##### -->
Infinite scrollable area containing child widgets and/or custom drawing
<!-- ##### SECTION Long_Description ##### -->
<para>
#GtkLayout is similar to #GtkDrawingArea in that it's a "blank slate"
and doesn't do anything but paint a blank background by default. It's
different in that it supports scrolling natively (you can add it to a
#GtkScrolledWindow), and it can contain child widgets, since it's a
#GtkContainer. However if you're just going to draw, a #GtkDrawingArea
is a better choice since it has lower overhead.
</para>
<para>
When handling expose events on a #GtkLayout, you must draw to
GTK_LAYOUT (layout)-&gt;bin_window, rather than to
GTK_WIDGET (layout)-&gt;window, as you would for a drawing
area.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
#GtkDrawingArea, #GtkScrolledWindow
</para>
<!-- ##### STRUCT GtkLayout ##### -->
......@@ -19,6 +32,7 @@ GtkLayout
</para>
@bin_window:
<!-- ##### FUNCTION gtk_layout_new ##### -->
<para>
......@@ -36,9 +50,11 @@ GtkLayout
</para>
@layout:
@widget:
@child_widget:
@x:
@y:
<!-- # Unused Parameters # -->
@widget:
<!-- ##### FUNCTION gtk_layout_move ##### -->
......@@ -47,9 +63,11 @@ GtkLayout
</para>
@layout:
@widget:
@child_widget:
@x:
@y:
<!-- # Unused Parameters # -->
@widget:
<!-- ##### FUNCTION gtk_layout_set_size ##### -->
......@@ -135,21 +153,21 @@ GtkLayout
<!-- ##### ARG GtkLayout:hadjustment ##### -->
<para>
Horizontal scroll adjustment, see gtk_layout_set_hadjustment()
</para>
<!-- ##### ARG GtkLayout:vadjustment ##### -->
<para>
Vertical scroll adjustment, see gtk_layout_set_vadjustment()
</para>
<!-- ##### ARG GtkLayout:width ##### -->
<para>
Layout width, see gtk_layout_set_size()
</para>
<!-- ##### ARG GtkLayout:height ##### -->
<para>
Layout height, see gtk_layout_set_size()
</para>
......@@ -132,6 +132,15 @@ Deprecated compatibility macro.
@Returns:
<!-- ##### MACRO gtk_notebook_set_page ##### -->
<para>
</para>
<!-- # Unused Parameters # -->
@notebook:
@page_num:
<!-- ##### FUNCTION gtk_notebook_next_page ##### -->
<para>
</para>
......
......@@ -495,7 +495,6 @@ This can later be composited together with other
#GtkRcStyle structures to form a #GtkStyle.
</para>
@parent_instance:
@name:
@bg_pixmap_name:
@font_desc:
......
......@@ -10,6 +10,17 @@ The #GtkScrollbar widget is an abstract base class for #GtkHScrollbar and
#GtkVScrollbar. It is not very useful in itself.
</para>
<para>
The position of the thumb in a scrollbar is controlled by the scroll
adjustments. See #GtkAdjustment for the fields in an adjustment - for
#GtkScrollbar, the "value" field represents the position of the
scrollbar, which must be between the "lower" field and "upper -
page_size." The "page_size" field represents the size of the visible
scrollable area. The "step_increment" and "page_increment" fields are
used when the user asks to step down (using the small stepper arrows)
or page down (using for example the PageDown key).
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
<variablelist>
......@@ -24,6 +35,16 @@ The #GtkScrollbar widget is an abstract base class for #GtkHScrollbar and
<listitem><para>a vertical scrollbar.</para></listitem>
</varlistentry>
<varlistentry>
<term>#GtkAdjustment</term>
<listitem><para>connects scrollbars to the widget being scrolled.</para></listitem>
</varlistentry>
<varlistentry>
<term>#GtkScrolledWindow</term>
<listitem><para>convenient widget for setting up scrolling.</para></listitem>
</varlistentry>
</variablelist>
</para>
......
......@@ -2,61 +2,86 @@
GtkScrolledWindow
<!-- ##### SECTION Short_Description ##### -->
Adds scrollbars to its child widget.
<!-- ##### SECTION Long_Description ##### -->
<para>
#GtkScrolledWindow is a #GtkBin subclass: it's a container
the accepts a single child widget. #GtkScrolledWindow adds scrollbars
to the child widget.
</para>
<para>
The scrolled window can work in two ways. Some widgets have native
scrolling support; these widgets have "slots" for #GtkAdjustment
objects. The scrolled window installs #GtkAdjustment objects in the
child window's slots using the set_scroll_adjustments_signal, found in
#GtkWidgetClass. (Conceptually, these widgets implement a "Scrollable"
interface; because GTK+ 1.2 lacks multiple inheritance, this interface
is hackily implemented as a signal in #GtkWidgetClass.)
</para>
<para>
The second way to use the scrolled window is useful with widgets that
lack the set_scroll_adjustments_signal. The #GtkViewport widget acts as
a proxy, implementing scrollability for child widgets that lack their
own scrolling capabilities.
</para>
<para>
If a widget has native scrolling abilities, it can be added to the
#GtkScrolledWindow with gtk_container_add(). If a widget does not, you
must first add the widget to a #GtkViewport, then add the GtkViewport
to the scrolled window. The convenience function
gtk_scrolled_window_add_with_viewport() does exactly this, so you can
ignore the presence of the viewport.
<para>
#GtkScrolledWindow is a #GtkBin subclass: it's a container
the accepts a single child widget. #GtkScrolledWindow adds scrollbars
to the child widget and optionally draws a beveled frame around the
child widget.
</para>
<para>
The scrolled window can work in two ways. Some widgets have native
scrolling support; these widgets have "slots" for #GtkAdjustment
objects.
<footnote><para>The scrolled window installs #GtkAdjustment objects in