AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

Fix typos in pkg-config invokations. (#72476)

Browse Source 
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
	invokations.  (#72476)

	Fixes for #72478:

	* gtk/tmpl/gtkprogressbar.sgml: Add note about new GtkProgressBar
	API to introduction.

	* gtk/gtk-sections.txt: Reorder GtkProgressBar functions to move
	undeprecated API to top.
This commit is contained in:
Matthias Clasen 2002-02-26 00:44:36 +00:00
parent c0c90c9e58
commit 14a2eb7884
11 changed files with 156 additions and 97 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
ChangeLog
View File

@ -1,3 +1,8 @@
2002-02-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
invokations. (#72476)
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com> Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode * gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode

5
ChangeLog.pre-2-0
View File

@ -1,3 +1,8 @@
2002-02-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
invokations. (#72476)
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com> Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode * gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode

5
ChangeLog.pre-2-10
View File

@ -1,3 +1,8 @@
2002-02-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
invokations. (#72476)
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com> Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode * gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode

5
ChangeLog.pre-2-2
View File

@ -1,3 +1,8 @@
2002-02-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
invokations. (#72476)
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com> Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode * gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode

5
ChangeLog.pre-2-4
View File

@ -1,3 +1,8 @@
2002-02-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
invokations. (#72476)
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com> Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode * gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode

5
ChangeLog.pre-2-6
View File

@ -1,3 +1,8 @@
2002-02-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
invokations. (#72476)
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com> Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode * gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode

5
ChangeLog.pre-2-8
View File

@ -1,3 +1,8 @@
2002-02-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
invokations. (#72476)
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com> Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode * gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode

10
docs/reference/ChangeLog
View File

@ -1,3 +1,13 @@
2002-02-26 Matthias Clasen <maclas@gmx.de>
Fixes for #72478:
* gtk/tmpl/gtkprogressbar.sgml: Add note about new GtkProgressBar
API to introduction.
* gtk/gtk-sections.txt: Reorder GtkProgressBar functions to move
undeprecated API to top.
Sat Feb 23 23:39:14 2002 Owen Taylor <otaylor@redhat.com> Sat Feb 23 23:39:14 2002 Owen Taylor <otaylor@redhat.com>
* gtk/tmpl/gtktreemodel.sgml: Document gtk_tree_path_new_root(), * gtk/tmpl/gtktreemodel.sgml: Document gtk_tree_path_new_root(),

10
docs/reference/gtk/gtk-sections.txt
View File

@ -1878,23 +1878,23 @@ gtk_progress_get_type
<FILE>gtkprogressbar</FILE> <FILE>gtkprogressbar</FILE>
<TITLE>GtkProgressBar</TITLE> <TITLE>GtkProgressBar</TITLE>
GtkProgressBar GtkProgressBar
GtkProgressBarStyle
GtkProgressBarOrientation
gtk_progress_bar_new gtk_progress_bar_new
gtk_progress_bar_pulse gtk_progress_bar_pulse
gtk_progress_bar_set_text gtk_progress_bar_set_text
gtk_progress_bar_set_fraction gtk_progress_bar_set_fraction
gtk_progress_bar_set_pulse_step gtk_progress_bar_set_pulse_step
gtk_progress_bar_set_orientation
GtkProgressBarOrientation
gtk_progress_bar_get_text
gtk_progress_bar_get_fraction gtk_progress_bar_get_fraction
gtk_progress_bar_get_pulse_step gtk_progress_bar_get_pulse_step
gtk_progress_bar_get_text gtk_progress_bar_get_orientation
gtk_progress_bar_new_with_adjustment gtk_progress_bar_new_with_adjustment
gtk_progress_bar_set_bar_style gtk_progress_bar_set_bar_style
GtkProgressBarStyle
gtk_progress_bar_set_discrete_blocks gtk_progress_bar_set_discrete_blocks
gtk_progress_bar_set_activity_step gtk_progress_bar_set_activity_step
gtk_progress_bar_set_activity_blocks gtk_progress_bar_set_activity_blocks
gtk_progress_bar_set_orientation
gtk_progress_bar_get_orientation
gtk_progress_bar_update gtk_progress_bar_update
<SUBSECTION Standard> <SUBSECTION Standard>
GTK_PROGRESS_BAR GTK_PROGRESS_BAR

188
docs/reference/gtk/tmpl/gtkprogressbar.sgml
View File

@ -18,24 +18,38 @@ When an application can determine how much work needs to take place
progress, it can use the #GtkProgressBar in percentage mode and the user progress, it can use the #GtkProgressBar in percentage mode and the user
sees a growing bar indicating the percentage of the work that has sees a growing bar indicating the percentage of the work that has
been completed. In this mode, the application is required to call been completed. In this mode, the application is required to call
either the gtk_progress_set_percentage() or gtk_progress_set_value() gtk_progress_bar_set_fraction() periodically to update the progress bar.
functions periodically to update the progress bar.
</para> </para>
<para> <para>
When an application has no accurate way of knowing the amount of work When an application has no accurate way of knowing the amount of work
to do, it can use the #GtkProgressBar in activity mode. In this mode to do, it can use the #GtkProgressBar in activity mode, which shows activity
the progress bar shows activity by a block moving back and forth within by a block moving back and forth within the progress area. In this mode,
the progress area. the application is required to call gtk_progress_bar_pulse() perodically
to update the progress bar.
</para> </para>
<para> <para>
There is quite a bit of flexibility provided to control the appearance There is quite a bit of flexibility provided to control the appearance
of the #GtkProgressBar. Functions are provided to control the of the #GtkProgressBar. Functions are provided to control the
orientation of the bar, optional text which can be displayed along with orientation of the bar, optional text can be displayed along with
the bar, and the style in which the bar grows. the bar, and the step size used in activity mode can be set.
</para> </para>
<note>
<para>
The #GtkProgressBar/#GtkProgress API in GTK 1.2 was bloated, needlessly complex
and hard to use properly. Therefore #GtkProgress has been deprecated
completely and the #GtkProgressBar API has been reduced to the following 9
functions: gtk_progress_bar_new(), gtk_progress_bar_pulse(), gtk_progress_bar_set_text(),
gtk_progress_bar_set_fraction(), gtk_progress_bar_set_pulse_step(),
gtk_progress_bar_set_orientation(), gtk_progress_bar_get_text(),
gtk_progress_bar_get_fraction(), gtk_progress_bar_get_pulse_step(). These have
been grouped at the beginning of this section, followed by a large chunk of
deprecated 1.2 compatibility functions.
</para>
</note>
<!-- ##### SECTION See_Also ##### --> <!-- ##### SECTION See_Also ##### -->
<para> <para>
@ -48,67 +62,6 @@ and should be accessed using the functions below.
</para> </para>
<!-- ##### ENUM GtkProgressBarStyle ##### -->
<para>
An enumeration representing the styles for drawing the progress bar.
<informaltable pgwide=1 frame="none" role="enum">
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
<tbody>
<row>
<entry>GTK_PROGRESS_CONTINUOUS</entry>
<entry>The progress bar grows in a smooth, continuous manner.</entry>
</row>
<row>
<entry>GTK_PROGRESS_DISCRETE</entry>
<entry>The progress bar grows in discrete, visible blocks.</entry>
</row>
</tbody></tgroup></informaltable>
</para>
@GTK_PROGRESS_CONTINUOUS:
@GTK_PROGRESS_DISCRETE:
<!-- ##### ENUM GtkProgressBarOrientation ##### -->
<para>
An enumeration representing possible orientations and growth
directions for the visible progress bar.
<informaltable pgwide=1 frame="none" role="enum">
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
<tbody>
<row>
<entry>GTK_PROGRESS_LEFT_TO_RIGHT</entry>
<entry>A horizontal progress bar growing from left to right.</entry>
</row>
<row>
<entry>GTK_PROGRESS_RIGHT_TO_LEFT</entry>
<entry>A horizontal progress bar growing from right to left.</entry>
</row>
<row>
<entry>GTK_PROGRESS_BOTTOM_TO_TOP</entry>
<entry>A vertical progress bar growing from bottom to top.</entry>
</row>
<row>
<entry>GTK_PROGRESS_TOP_TO_BOTTOM</entry>
<entry>A vertical progress bar growing from top to bottom.</entry>
</row>
</tbody></tgroup></informaltable>
</para>
@GTK_PROGRESS_LEFT_TO_RIGHT:
@GTK_PROGRESS_RIGHT_TO_LEFT:
@GTK_PROGRESS_BOTTOM_TO_TOP:
@GTK_PROGRESS_TOP_TO_BOTTOM:
<!-- ##### FUNCTION gtk_progress_bar_new ##### --> <!-- ##### FUNCTION gtk_progress_bar_new ##### -->
<para> <para>
Creates a new #GtkProgressBar. Creates a new #GtkProgressBar.
@ -152,6 +105,61 @@ Creates a new #GtkProgressBar.
@fraction: @fraction:
<!-- ##### FUNCTION gtk_progress_bar_set_orientation ##### -->
<para>
</para>
@pbar:
@orientation:
<!-- ##### ENUM GtkProgressBarOrientation ##### -->
<para>
An enumeration representing possible orientations and growth
directions for the visible progress bar.
<informaltable pgwide=1 frame="none" role="enum">
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
<tbody>
<row>
<entry>GTK_PROGRESS_LEFT_TO_RIGHT</entry>
<entry>A horizontal progress bar growing from left to right.</entry>
</row>
<row>
<entry>GTK_PROGRESS_RIGHT_TO_LEFT</entry>
<entry>A horizontal progress bar growing from right to left.</entry>
</row>
<row>
<entry>GTK_PROGRESS_BOTTOM_TO_TOP</entry>
<entry>A vertical progress bar growing from bottom to top.</entry>
</row>
<row>
<entry>GTK_PROGRESS_TOP_TO_BOTTOM</entry>
<entry>A vertical progress bar growing from top to bottom.</entry>
</row>
</tbody></tgroup></informaltable>
</para>
@GTK_PROGRESS_LEFT_TO_RIGHT:
@GTK_PROGRESS_RIGHT_TO_LEFT:
@GTK_PROGRESS_BOTTOM_TO_TOP:
@GTK_PROGRESS_TOP_TO_BOTTOM:
<!-- ##### FUNCTION gtk_progress_bar_get_text ##### -->
<para>
</para>
@pbar:
@Returns:
<!-- ##### FUNCTION gtk_progress_bar_get_fraction ##### --> <!-- ##### FUNCTION gtk_progress_bar_get_fraction ##### -->
<para> <para>
@ -170,7 +178,7 @@ Creates a new #GtkProgressBar.
@Returns: @Returns:
<!-- ##### FUNCTION gtk_progress_bar_get_text ##### --> <!-- ##### FUNCTION gtk_progress_bar_get_orientation ##### -->
<para> <para>
</para> </para>
@ -198,6 +206,30 @@ Sets the style of the #GtkProgressBar. The default style is
@style: a #GtkProgressBarStyle value indicating the desired style. @style: a #GtkProgressBarStyle value indicating the desired style.
<!-- ##### ENUM GtkProgressBarStyle ##### -->
<para>
An enumeration representing the styles for drawing the progress bar.
<informaltable pgwide=1 frame="none" role="enum">
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
<tbody>
<row>
<entry>GTK_PROGRESS_CONTINUOUS</entry>
<entry>The progress bar grows in a smooth, continuous manner.</entry>
</row>
<row>
<entry>GTK_PROGRESS_DISCRETE</entry>
<entry>The progress bar grows in discrete, visible blocks.</entry>
</row>
</tbody></tgroup></informaltable>
</para>
@GTK_PROGRESS_CONTINUOUS:
@GTK_PROGRESS_DISCRETE:
<!-- ##### FUNCTION gtk_progress_bar_set_discrete_blocks ##### --> <!-- ##### FUNCTION gtk_progress_bar_set_discrete_blocks ##### -->
<para> <para>
Sets the number of blocks that the progress bar is divided into Sets the number of blocks that the progress bar is divided into
@ -230,24 +262,6 @@ mode. Larger numbers make the visible block smaller.
@blocks: number of blocks which can fit within the progress bar area. @blocks: number of blocks which can fit within the progress bar area.
<!-- ##### FUNCTION gtk_progress_bar_set_orientation ##### -->
<para>
</para>
@pbar:
@orientation:
<!-- ##### FUNCTION gtk_progress_bar_get_orientation ##### -->
<para>
</para>
@pbar:
@Returns:
<!-- ##### FUNCTION gtk_progress_bar_update ##### --> <!-- ##### FUNCTION gtk_progress_bar_update ##### -->
<para> <para>
This function is deprecated. Please use gtk_progress_set_value() or This function is deprecated. Please use gtk_progress_set_value() or

10
docs/tutorial/gtk-tut.sgml
View File

@ -5,7 +5,7 @@
<book id="gtk-tut"> <book id="gtk-tut">
<bookinfo> <bookinfo>
<date>February 20, 2002</date> <date>February 25, 2002</date>
<title>GTK+ 2.0 Tutorial</title> <title>GTK+ 2.0 Tutorial</title>
<authorgroup> <authorgroup>
<author> <author>
@ -191,7 +191,7 @@ int main( int argc,
<para>You can compile the above program with gcc using:</para> <para>You can compile the above program with gcc using:</para>
<para><literallayout> <para><literallayout>
<literal>gcc base.c -o base `pkg-config --cflags --libs gtk-2.0`</literal> <literal>gcc base.c -o base `pkg-config --cflags --libs gtk+-2.0`</literal>
</literallayout></para> </literallayout></para>
<para>The meaning of the unusual compilation options is explained below in <para>The meaning of the unusual compilation options is explained below in
@ -395,8 +395,8 @@ int main( int argc,
<para>To compile use:</para> <para>To compile use:</para>
<para><literallayout> <para><literallayout>
<literal>gcc -Wall -g helloworld.c -o helloworld `pkg-config --cflags gtk-2.0` \</literal> <literal>gcc -Wall -g helloworld.c -o helloworld `pkg-config --cflags gtk+-2.0` \</literal>
<literal> `pkg-config --libs gtk-2.0`</literal> <literal> `pkg-config --libs gtk+-2.0`</literal>
</literallayout></para> </literallayout></para>
<para>This uses the program <literal>pkg-config</literal>, which can be obtained from <para>This uses the program <literal>pkg-config</literal>, which can be obtained from
@ -2682,7 +2682,7 @@ struct _GtkAdjustment
<para>If you don't like to poke directly at struct internals like a <para>If you don't like to poke directly at struct internals like a
<emphasis>real</emphasis> C programmer, you can use the following accessor to <emphasis>real</emphasis> C programmer, you can use the following accessor to
inspect the <literal>value</literal> of an adjustment: inspect the <literal>value</literal> of an adjustment:</para>
<programlisting role="C"> <programlisting role="C">
gdouble gtk_adjustment_get_value( GtkAdjustment *adjustment); gdouble gtk_adjustment_get_value( GtkAdjustment *adjustment);