fixed minor error - using <em>.

1999-11-16  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gtk/tmpl/gtkmenubar.sgml: fixed minor error - using <em>.

	* gtk/tmpl/gtknotebook.sgml:
	* gtk/tmpl/gtklist.sgml: new sections from
	Nicolas George <george@clipper.ens.fr>, with help from
	"Bob Springett"	<bobspringett@claranet.fr>.

	* gtk/tmpl/gtkobject.sgml:
	* gtk/tmpl/gtkarg.sgml: new sections from
	David Benson <daveb@idealab.com>.

	* gtk/tmpl/gtkvbox.sgml:
	* gtk/tmpl/gtkhbox.sgml: fixed line endings.

	* gtk/tmpl/gtkvbbox.sgml: update from Lee Mallabone
	<lee0@callnetuk.com>

	* gdk/tmpl/drawing.sgml: fixed error in gdk_draw_arc() @angle2 param
	- it is relative to @angle1 rather than from the 3 o'clock position.

	* gtk/tmpl/gtkfontseldlg.sgml: changed enums to use @ fields.

	* gtk/tmpl/gtkcolorsel.sgml:
	* gtk/tmpl/gtkcolorseldlg.sgml:
	* gtk/tmpl/gtkprogress.sgml:
	* gtk/tmpl/gtkprogressbar.sgml: new sections from Tom Martone
	<tom@martoneconsulting.com>

	* gtk/tmpl/gtkclist.sgml: partially written documentation from
	Paul Schifferer <isengard@geocities.com> who won't be able to finish it

1 files changed, 209 insertions, 152 deletions

diff --git a/docs/reference/gtk/tmpl/gtknotebook.sgml b/docs/reference/gtk/tmpl/gtknotebook.sgml
index e4930dbb8a..df5086d721 100644
--- a/docs/reference/gtk/tmpl/gtknotebook.sgml
+++ b/docs/reference/gtk/tmpl/gtknotebook.sgml
@@ -2,16 +2,24 @@
 GtkNotebook
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Set of pages with bookmarks.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+The #GtkNotebook widget is a #GtkContainer whose children are pages that
+can be accessed through bookmarks. The pages are displayed all at the same
+place. <!-- TODO: talk about the menu -->
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
-
+<variablelist>
+<varlistentry>
+<term>#GtkContainer</term>
+<listitem><para>For functions that apply to every #GtkContainer
+(like #GtkList).</para></listitem>
+</varlistentry>
+</variablelist>
 </para>
 
 <!-- ##### STRUCT GtkNotebook ##### -->
@@ -19,10 +27,33 @@ GtkNotebook
 
 </para>
 
+@container: the parent class object
+@cur_page: the currently displayed page
+@children: a GList with the children of the notebook; belonging to
+#GtkNotebookPage
+@first_tab: 
+@focus_tab: 
+@menu: 
+@panel: 
+@timer: 
+@tab_hborder: 
+@tab_vborder: 
+@show_tabs: 
+@homogeneous: 
+@show_border: 
+@tab_pos: 
+@scrollable: 
+@in_child: 
+@click_child: 
+@button: 
+@need_timer: 
+@child_has_focus: 
+@have_visible_child: 
 
 <!-- ##### MACRO GTK_NOTEBOOK_PAGE ##### -->
 <para>
-
+Extracts the contents of the current element of #GList @_glist_ as a
+#GtkNotebookPage.
 </para>
 
 @_glist_: 
@@ -30,12 +61,13 @@ GtkNotebook
 
 <!-- ##### STRUCT GtkNotebookPage ##### -->
 <para>
-
+The #GtkNotebookPage structure is used to store the pages of a notebook. It
+is not an object.
 </para>
 
-@child: 
-@tab_label: 
-@menu_label: 
+@child: the contents of the page
+@tab_label: the label shown in the bookmark
+@menu_label: the label shown in the popup menu
 @default_menu: 
 @default_tab: 
 @expand: 
@@ -46,380 +78,405 @@ GtkNotebook
 
 <!-- ##### FUNCTION gtk_notebook_new ##### -->
 <para>
-
+Creates a new #GtkNotebook widget
 </para>
 
-@Returns: 
+@Returns: the newly created G=#GtkNotebook
 
 
 <!-- ##### FUNCTION gtk_notebook_append_page ##### -->
 <para>
-
+Appends to @notebook a page whose content is @child, and whose bookmark is
+@tab_label.
 </para>
 
-@notebook: 
-@child: 
-@tab_label: 
+@notebook: the notebook widget
+@child: the content of the new page
+@tab_label: the bookmark for the page
 
 
 <!-- ##### FUNCTION gtk_notebook_append_page_menu ##### -->
 <para>
-
+Appends to @notebook a page whose content is @child, whose bookmark is
+@tab_label, and whose menu label is @menu_label.
 </para>
 
-@notebook: 
-@child: 
-@tab_label: 
-@menu_label: 
+@notebook: the notebook widget
+@child: the content of the new page
+@tab_label: the bookmark of the page
+@menu_label: the menu label of the page
 
 
 <!-- ##### FUNCTION gtk_notebook_prepend_page ##### -->
 <para>
-
+Prepends to @notebook a page whose content is @child, whose bookmark is
+@tab_label, and whose menu label is @menu_label.
 </para>
 
-@notebook: 
-@child: 
-@tab_label: 
+@notebook: the notebook widget
+@child: the content of the new page
+@tab_label: the bookmark of the page
 
 
 <!-- ##### FUNCTION gtk_notebook_prepend_page_menu ##### -->
 <para>
-
+Appends to @notebook a page whose content is @child, whose bookmark is
+@tab_label, and whose menu label is @menu_label.
 </para>
 
-@notebook: 
-@child: 
-@tab_label: 
-@menu_label: 
+@notebook: the notebook widget
+@child: the content of the new page
+@tab_label: the bookmark of the page
+@menu_label: the menu label of the page
 
 
 <!-- ##### FUNCTION gtk_notebook_insert_page ##### -->
 <para>
-
+Inserts in @notebook a new page whose content is @child, and whose
+bookmark is @tab_label. The page is inserted just
+before the page number @position, starting with 0. If @position is out of
+bounds, it is assumed to be the current number of pages.
 </para>
 
-@notebook: 
-@child: 
-@tab_label: 
-@position: 
+@notebook: the notebook widget
+@child: the content of the new page
+@tab_label: the bookmark of the page
+@position: the position to insert the page
 
 
 <!-- ##### FUNCTION gtk_notebook_insert_page_menu ##### -->
 <para>
-
+Inserts in @notebook a new page whose content is @child, whose bookmark is
+@tab_label, and whose menu label is @menu_label. The page is inserted just
+before the page number @position, starting with 0. If @position is out of
+bounds, it is assumed to be the current number of pages.
 </para>
 
-@notebook: 
-@child: 
-@tab_label: 
-@menu_label: 
-@position: 
+@notebook: the notebook widget
+@child: the content of the new page 
+@tab_label: the bookmark of the page
+@menu_label: the menu label of the page
+@position: the position to insert the page
 
 
 <!-- ##### FUNCTION gtk_notebook_remove_page ##### -->
 <para>
-
+Removes the page @page_num form @notebook. Pages are numbered starting at
+zero. Negative values stand for the last page; too large values are
+ignored.
 </para>
 
-@notebook: 
-@page_num: 
+@notebook: the notebook widget
+@page_num: the page number
 
 
 <!-- ##### MACRO gtk_notebook_current_page ##### -->
 <para>
-
+??? I don't see such a macro in gtknotebook.h (v1.2.3).
 </para>
 
 
 
 <!-- ##### FUNCTION gtk_notebook_page_num ##### -->
 <para>
-
+Returns the page number of @child in @notebook.
 </para>
 
-@notebook: 
-@child: 
-@Returns: 
+@notebook: the notebook widget
+@child: the child
+@Returns: the page number, or -1 if @child is not in @notebook
 
 
 <!-- ##### FUNCTION gtk_notebook_set_page ##### -->
 <para>
-
+Switches to the page number @page_num. Negative values stand for the last
+page; too large values are ignored.
 </para>
 
-@notebook: 
-@page_num: 
+@notebook: the notebook widget
+@page_num: the page number
 
 
 <!-- ##### FUNCTION gtk_notebook_next_page ##### -->
 <para>
-
+Switches to the next page. Nothing happens if the current page is the last
+page.
 </para>
 
-@notebook: 
+@notebook: the notebook widget.
 
 
 <!-- ##### FUNCTION gtk_notebook_prev_page ##### -->
 <para>
-
+Switches to the previous page. Nothing happens if the current page is the
+first page.
 </para>
 
-@notebook: 
+@notebook: the notebook widget
 
 
 <!-- ##### FUNCTION gtk_notebook_reorder_child ##### -->
 <para>
-
+Moves the page @child, so that it appears in position @position. Out of
+bounds @position will be clamped.
 </para>
 
-@notebook: 
-@child: 
-@position: 
+@notebook: the notebook widget
+@child: the child to deplace
+@position: the new position
 
 
 <!-- ##### FUNCTION gtk_notebook_set_tab_pos ##### -->
 <para>
-
+Sets the position of the bookmarks.
 </para>
 
-@notebook: 
-@pos: 
+@notebook: the notebook widget
+@pos: the position
 
 
 <!-- ##### FUNCTION gtk_notebook_set_show_tabs ##### -->
 <para>
-
+Sets whether to show the bookmarks or not.
 </para>
 
-@notebook: 
-@show_tabs: 
+@notebook: the notebook widget
+@show_tabs: a boolean value
 
 
 <!-- ##### FUNCTION gtk_notebook_set_show_border ##### -->
 <para>
-
+Sets whether to show the border of the notebook or not. Bookmarks are in the
+border.
 </para>
 
-@notebook: 
-@show_border: 
+@notebook: the notebook widget
+@show_border: a boolean value
 
 
 <!-- ##### FUNCTION gtk_notebook_set_scrollable ##### -->
 <para>
-
+Sets whether the bookmarks area may be scrollable or not if there are too
+many bookmarks to fit in the allocated area.
 </para>
 
-@notebook: 
-@scrollable: 
+@notebook: the notebook widget
+@scrollable: a boolean value
 
 
 <!-- ##### FUNCTION gtk_notebook_set_tab_border ##### -->
 <para>
+Sets whether there should be a border around the bookmarks or not.
+</para>
+
+@notebook: the notebook widget
+@border_width: a boolean value
+
+
+<!-- ##### FUNCTION gtk_notebook_set_tab_hborder ##### -->
+<para>
+Sets whether the tabs should have a horizontal border.
+</para>
 
+@notebook: the notebook widget
+@tab_hborder: a boolean value
+
+
+<!-- ##### FUNCTION gtk_notebook_set_tab_vborder ##### -->
+<para>
+Sets whether the tabs should have a vertical border.
 </para>
 
-@notebook: 
-@border_width: 
+@notebook: the notebook widget
+@tab_vborder: a boolean value
 
 
 <!-- ##### FUNCTION gtk_notebook_popup_enable ##### -->
 <para>
-
+Enables the popup menu: if the user clicks with the right mouse button on
+the bookmarks, a menu with all the pages will be popped up.
 </para>
 
-@notebook: 
+@notebook: the notebook widget
 
 
 <!-- ##### FUNCTION gtk_notebook_popup_disable ##### -->
 <para>
-
+Disables the popup menu
 </para>
 
-@notebook: 
+@notebook: the notebook widget
 
 
 <!-- ##### FUNCTION gtk_notebook_get_current_page ##### -->
 <para>
-
+Returns the page number of the current page.
 </para>
 
-@notebook: 
-@Returns: 
+@notebook: the notebook widget
+@Returns: the page number
 
 
 <!-- ##### FUNCTION gtk_notebook_get_menu_label ##### -->
 <para>
-
+Returns the menu label of the page @child. NULL is returned if @child is not
+in @notebook or NULL if it has the default menu label.
 </para>
 
-@notebook: 
-@child: 
-@Returns: 
+@notebook: the notebook widget
+@child: the page
+@Returns: the menu label
 
 
 <!-- ##### FUNCTION gtk_notebook_get_nth_page ##### -->
 <para>
-
+Returns the content of the page number @page_num, or NULL if @page_num is
+out of bounds.
 </para>
 
-@notebook: 
-@page_num: 
-@Returns: 
+@notebook: the notebook widget
+@page_num: the page number
+@Returns: the content of the page
 
 
 <!-- ##### FUNCTION gtk_notebook_get_tab_label ##### -->
 <para>
-
+Returns the menu tab of the page @child. NULL is returned if @child is not
+in @notebook or NULL if it has the default tab label.
 </para>
 
-@notebook: 
-@child: 
-@Returns: 
+@notebook: the notebook widget
+@child: the page
+@Returns: the tab label
 
 
 <!-- ##### FUNCTION gtk_notebook_query_tab_label_packing ##### -->
 <para>
-
+Looks for the packing attributes of the bookmarks of @child.
 </para>
 
-@notebook: 
-@child: 
-@expand: 
-@fill: 
-@pack_type: 
+@notebook: the notebook widget
+@child: the page
+@expand: a pointer to return the expand value (or NULL) 
+@fill: a pointer to return the fill value (or NULL)
+@pack_type: a pointer to return the pack_type (or NULL)
 
 
 <!-- ##### FUNCTION gtk_notebook_set_homogeneous_tabs ##### -->
 <para>
-
+Sets whether the tabs must have all the same size or not.
 </para>
 
-@notebook: 
-@homogeneous: 
+@notebook: the notebook widget
+@homogeneous: a boolean value
 
 
 <!-- ##### FUNCTION gtk_notebook_set_menu_label ##### -->
 <para>
-
+Changes the menu label of @child. Nothing happens if @child is not in
+@notebook.
 </para>
 
-@notebook: 
-@child: 
-@menu_label: 
+@notebook: the notebook widget
+@child: the page
+@menu_label: the menu label, or NULL for default
 
 
 <!-- ##### FUNCTION gtk_notebook_set_menu_label_text ##### -->
 <para>
-
+Creates a new label and sets it as the menu label of @child.
 </para>
 
-@notebook: 
-@child: 
-@menu_text: 
-
-
-<!-- ##### FUNCTION gtk_notebook_set_tab_hborder ##### -->
-<para>
-
-</para>
-
-@notebook: 
-@tab_hborder: 
+@notebook: the notebook widget
+@child: the page
+@menu_text: the label text
 
 
 <!-- ##### FUNCTION gtk_notebook_set_tab_label ##### -->
 <para>
-
+Changes the bookmark label of @child. Nothing happens if @child is not in
+@notebook.
 </para>
 
-@notebook: 
-@child: 
-@tab_label: 
+@notebook: the notebook widget
+@child: the page
+@tab_label: the bookmark label, or NULL for default
 
 
 <!-- ##### FUNCTION gtk_notebook_set_tab_label_packing ##### -->
 <para>
-
+Sets the packing parameters for the bookmark of @child. See
+#GtkBoxPackStart for the exact meanings.
 </para>
 
-@notebook: 
-@child: 
-@expand: 
-@fill: 
-@pack_type: 
+@notebook: the notebook widget
+@child: the child widget
+@expand: whether to expand the bookmark or not
+@fill: whether the bookmark should fill the allocated area or not
+@pack_type: the position of the bookmark
 
 
 <!-- ##### FUNCTION gtk_notebook_set_tab_label_text ##### -->
 <para>
-
+Creates a new label and sets it as the bookmark label of @child.
 </para>
 
-@notebook: 
-@child: 
-@tab_text: 
-
-
-<!-- ##### FUNCTION gtk_notebook_set_tab_vborder ##### -->
-<para>
-
-</para>
-
-@notebook: 
-@tab_vborder: 
+@notebook: the notebook widget
+@child: the page
+@tab_text: the label text
 
 
 <!-- ##### SIGNAL GtkNotebook::switch-page ##### -->
 <para>
-
+Emitted when the user or a function changes the current page.
 </para>
 
 @notebook: the object which received the signal.
-@page: 
-@page_num: 
+@page: the new current page
+@page_num: the index of the page
 
 <!-- ##### ARG GtkNotebook:page ##### -->
 <para>
-
+The current page
 </para>
 
 <!-- ##### ARG GtkNotebook:tab_pos ##### -->
 <para>
-
+The position of the bookmarks
 </para>
 
 <!-- ##### ARG GtkNotebook:tab_border ##### -->
 <para>
-
+Whether the bookmarks have a border or not
 </para>
 
 <!-- ##### ARG GtkNotebook:tab_hborder ##### -->
 <para>
-
+Whether the bookmarks have a horizontal border or not
 </para>
 
 <!-- ##### ARG GtkNotebook:tab_vborder ##### -->
 <para>
-
+Whether the bookmarks have a vertical border or not
 </para>
 
 <!-- ##### ARG GtkNotebook:show_tabs ##### -->
 <para>
-
+Whether to show the bookmarks or not
 </para>
 
 <!-- ##### ARG GtkNotebook:show_border ##### -->
 <para>
-
+Whether to show the border or not
 </para>
 
 <!-- ##### ARG GtkNotebook:scrollable ##### -->
 <para>
-
+Whether the bookmarks should be scrollable or not
 </para>
 
 <!-- ##### ARG GtkNotebook:enable_popup ##### -->
 <para>
-
+Whether the popup menu is enabled or not
 </para>