Move documentation to inline comments: GtkHSeparator

This commit is contained in:
Javier Jardón 2011-04-11 22:33:38 +01:00
parent 1f9f5e8890
commit 1f50a4d011
3 changed files with 27 additions and 53 deletions

View File

@ -39,6 +39,7 @@ gtkhbox.sgml
gtkhpaned.sgml
gtkhscale.sgml
gtkhscrollbar.sgml
gtkhseparator.sgml
gtkiconview.sgml
gtkimagemenuitem.sgml
gtkimcontext.sgml

View File

@ -1,53 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkHSeparator
<!-- ##### SECTION Short_Description ##### -->
A horizontal separator
<!-- ##### SECTION Long_Description ##### -->
<para>
The #GtkHSeparator widget is a horizontal separator, used to group the
widgets within a window. It displays a horizontal line with a shadow to
make it appear sunken into the interface.
</para>
<note>
<para>
The #GtkHSeparator widget is not used as a separator within menus.
To create a separator in a menu create an empty #GtkSeparatorMenuItem
widget using gtk_separator_menu_item_new() and add it to the menu with
gtk_menu_shell_append().
</para>
</note>
<!-- ##### SECTION See_Also ##### -->
<para>
<variablelist>
<varlistentry>
<term>#GtkVSeparator</term>
<listitem><para>a vertical separator.</para></listitem>
</varlistentry>
</variablelist>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### SECTION Image ##### -->
<!-- ##### STRUCT GtkHSeparator ##### -->
<para>
The #GtkHSeparator-struct struct contains private data only, and
should be accessed using the functions below.
</para>
<!-- ##### FUNCTION gtk_hseparator_new ##### -->
<para>
Creates a new #GtkHSeparator.
</para>
@void:
@Returns: a new #GtkHSeparator.

View File

@ -30,6 +30,25 @@
#include "gtkorientable.h"
/**
* SECTION:gtkhseparator
* @Short_description: A horizontal separator
* @Title: GtkHSeparator
* @See_also: #GtkSeparator
*
* The #GtkHSeparator widget is a horizontal separator, used to group the
* widgets within a window. It displays a horizontal line with a shadow to
* make it appear sunken into the interface.
*
* <note>
* The #GtkHSeparator widget is not used as a separator within menus.
* To create a separator in a menu create an empty #GtkSeparatorMenuItem
* widget using gtk_separator_menu_item_new() and add it to the menu with
* gtk_menu_shell_append().
* </note>
*/
G_DEFINE_TYPE (GtkHSeparator, gtk_hseparator, GTK_TYPE_SEPARATOR)
static void
@ -44,6 +63,13 @@ gtk_hseparator_init (GtkHSeparator *hseparator)
GTK_ORIENTATION_HORIZONTAL);
}
/**
* gtk_hseparator_new:
*
* Creates a new #GtkHSeparator.
*
* Returns: a new #GtkHSeparator.
*/
GtkWidget *
gtk_hseparator_new (void)
{