[Xfce4-commits] r25905 - in xfce4-panel/trunk: . docs/API docs/API/tmpl libxfce4panel plugins/clock
Nick Schermer
nick at xfce.org
Mon Jul 9 21:51:59 CEST 2007
Author: nick
Date: 2007-07-09 19:51:58 +0000 (Mon, 09 Jul 2007)
New Revision: 25905
Added:
xfce4-panel/trunk/docs/API/tmpl/libxfce4panel-macros.sgml
Removed:
xfce4-panel/trunk/docs/API/html/
xfce4-panel/trunk/docs/API/libxfce4panel-decl-list.txt
xfce4-panel/trunk/docs/API/libxfce4panel-decl.txt
xfce4-panel/trunk/docs/API/libxfce4panel-undocumented.txt
xfce4-panel/trunk/docs/API/xml/
Modified:
xfce4-panel/trunk/ChangeLog
xfce4-panel/trunk/configure.in.in
xfce4-panel/trunk/docs/API/Makefile.am
xfce4-panel/trunk/docs/API/libxfce4panel-docs.sgml
xfce4-panel/trunk/docs/API/libxfce4panel-sections.txt
xfce4-panel/trunk/docs/API/libxfce4panel.types
xfce4-panel/trunk/docs/API/tmpl/libxfce4panel-unused.sgml
xfce4-panel/trunk/docs/API/tmpl/xfce-arrow-button.sgml
xfce4-panel/trunk/docs/API/tmpl/xfce-hvbox.sgml
xfce4-panel/trunk/docs/API/tmpl/xfce-itembar.sgml
xfce4-panel/trunk/docs/API/tmpl/xfce-panel-convenience.sgml
xfce4-panel/trunk/docs/API/tmpl/xfce-panel-enums.sgml
xfce4-panel/trunk/docs/API/tmpl/xfce-panel-external-plugin.sgml
xfce4-panel/trunk/docs/API/tmpl/xfce-panel-internal-plugin.sgml
xfce4-panel/trunk/docs/API/tmpl/xfce-panel-plugin-iface.sgml
xfce4-panel/trunk/docs/API/tmpl/xfce-panel-plugin.sgml
xfce4-panel/trunk/docs/API/tmpl/xfce-panel-window.sgml
xfce4-panel/trunk/libxfce4panel/xfce-arrow-button.c
xfce4-panel/trunk/libxfce4panel/xfce-hvbox.c
xfce4-panel/trunk/libxfce4panel/xfce-itembar.c
xfce4-panel/trunk/libxfce4panel/xfce-panel-convenience.c
xfce4-panel/trunk/libxfce4panel/xfce-panel-enums.h
xfce4-panel/trunk/libxfce4panel/xfce-panel-plugin-iface.c
xfce4-panel/trunk/plugins/clock/clock-analog.c
Log:
* libxfce4panel/*, docs/API/*: Remove the html and xml directories,
those are generated by gtk-doc, 100% symbol coverage and improve
the layout of the chapters.
Modified: xfce4-panel/trunk/ChangeLog
===================================================================
--- xfce4-panel/trunk/ChangeLog 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/ChangeLog 2007-07-09 19:51:58 UTC (rev 25905)
@@ -1,3 +1,9 @@
+2007-07-09 22:45 nick
+
+ * libxfce4panel/*, docs/API/*: Remove the html and xml directories,
+ those are generated by gtk-doc, 100% symbol coverage and improve
+ the layout of the chapters.
+
2007-07-08 12:00 nick
* plugins/clock/clock-digital.c: Allow markup and center the string.
Modified: xfce4-panel/trunk/configure.in.in
===================================================================
--- xfce4-panel/trunk/configure.in.in 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/configure.in.in 2007-07-09 19:51:58 UTC (rev 25905)
@@ -151,7 +151,7 @@
dnl ***********************************
AC_ARG_ENABLE([debug],
AC_HELP_STRING([--enable-debug=@<:@no/minimum/yes/full@:>@], [Turn on debugging @<:@default=panel_debug_default@:>@]),
- [], [enable_debug=thunar_debug_default])
+ [], [enable_debug=panel_debug_default])
AC_MSG_CHECKING([whether to enable debugging support])
if test x"$enable_debug" = x"full" -o x"$enable_debug" = x"yes"; then
dnl Print the result
Modified: xfce4-panel/trunk/docs/API/Makefile.am
===================================================================
--- xfce4-panel/trunk/docs/API/Makefile.am 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/Makefile.am 2007-07-09 19:51:58 UTC (rev 25905)
@@ -1,83 +1,61 @@
-## Process this file with automake to produce Makefile.in
+# $Id$
-# We require automake 1.6 at least.
-AUTOMAKE_OPTIONS = 1.6
+AUTOMAKE_OPTIONS = 1.8
-# This is a blank Makefile.am for using gtk-doc.
-# Copy this to your project's API docs directory and modify the variables to
-# suit your project. See the GTK+ Makefiles in gtk+/docs/reference for examples
-# of using the various options.
-
-# The name of the module, e.g. 'glib'.
+# The name of the module.
DOC_MODULE=libxfce4panel
-# The top-level SGML file. You can change this if you want to.
+# The top-level SGML file.
DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
-# The directory containing the source code. Relative to $(srcdir).
-# gtk-doc will search all .c & .h files beneath here for inline comments
-# documenting the functions and macros.
-# e.g. DOC_SOURCE_DIR=../../../gtk
+# The directory containing the source code. Relative to $(srcdir)
DOC_SOURCE_DIR=../../libxfce4panel
-# Extra options to pass to gtkdoc-scangobj. Not normally needed.
+# Extra options to pass to gtkdoc-scangobj
SCANGOBJ_OPTIONS=
-# Extra options to supply to gtkdoc-scan.
-# e.g. SCAN_OPTIONS=--deprecated-guards="GTK_DISABLE_DEPRECATED"
-SCAN_OPTIONS=
+# Extra options to supply to gtkdoc-scan
+SCAN_OPTIONS=--type-init-func="gtk_type_init(0);g_type_class_ref(G_TYPE_OBJECT)"
-# Extra options to supply to gtkdoc-mkdb.
-# e.g. MKDB_OPTIONS=--sgml-mode --output-format=xml
+# Extra options to supply to gtkdoc-mkdb
MKDB_OPTIONS=--sgml-mode --output-format=xml
-# Extra options to supply to gtkdoc-mktmpl
-# e.g. MKTMPL_OPTIONS=--only-section-tmpl
-MKTMPL_OPTIONS=
-
-# Extra options to supply to gtkdoc-fixref. Not normally needed.
-# e.g. FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html
+# Extra options to supply to gtkdoc-fixref
FIXXREF_OPTIONS=
-# Used for dependencies. The docs will be rebuilt if any of these change.
-# e.g. HFILE_GLOB=$(top_srcdir)/gtk/*.h
-# e.g. CFILE_GLOB=$(top_srcdir)/gtk/*.c
+# Used for dependencies
HFILE_GLOB=$(top_srcdir)/libxfce4panel/*.h
CFILE_GLOB=$(top_srcdir)/libxfce4panel/*.c
# Header files to ignore when scanning.
-# e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
-IGNORE_HFILES= \
- xfce-marshal.h \
- xfce-panel-external-item.h \
- xfce-panel-item-iface.h \
- xfce-panel-plugin-iface-private.h \
+IGNORE_HFILES= \
+ xfce-marshal.h \
+ xfce-panel-external-item.h \
+ xfce-panel-item-iface.h \
+ xfce-panel-plugin-iface-private.h \
xfce-panel-plugin-messages.h
# Images to copy into HTML directory.
-# e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
HTML_IMAGES=
# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
-# e.g. content_files=running.sgml building.sgml changes-2.0.sgml
-content_files=version.xml
+content_files= \
+ version.xml
-# SGML files where gtk-doc abbrevations (#GtkWidget) are expanded
-# These files must be listed here *and* in content_files
-# e.g. expand_content_files=running.sgml
-expand_content_files=
+# CFLAGS and LDFLAGS for compiling scan program. Only needed
+# if $(DOC_MODULE).types is non-empty.
+INCLUDES= \
+ -I$(top_srcdir) \
+ -I$(top_builddir) \
+ $(LIBXFCEGUI4_CFLAGS)
-# CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
-# Only needed if you are using gtkdoc-scangobj to dynamically query widget
-# signals and properties.
-# e.g. INCLUDES=-I$(top_srcdir) -I$(top_builddir) $(GTK_DEBUG_FLAGS)
-# e.g. GTKDOC_LIBS=$(top_builddir)/gtk/$(gtktargetlib)
-INCLUDES=-I$(top_srcdir) -I$(top_builddir)/libxfce4panel $(LIBXFCEGUI4_CFLAGS)
-GTKDOC_LIBS=$(top_builddir)/libxfce4panel/libxfce4panel.la $(LIBXFCEGUI4_LIBS)
+GTKDOC_LIBS= \
+ $(top_builddir)/libxfce4panel/libxfce4panel.la \
+ $(LIBXFCEGUI4_LIBS)
# This includes the standard gtk-doc make rules, copied by gtkdocize.
include $(top_srcdir)/gtk-doc.make
# Other files to distribute
-# e.g. EXTRA_DIST += version.xml.in
-EXTRA_DIST +=
+EXTRA_DIST += \
+ version.xml.in
Deleted: xfce4-panel/trunk/docs/API/libxfce4panel-decl-list.txt
Deleted: xfce4-panel/trunk/docs/API/libxfce4panel-decl.txt
Modified: xfce4-panel/trunk/docs/API/libxfce4panel-docs.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/libxfce4panel-docs.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/libxfce4panel-docs.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -1,22 +1,75 @@
-<?xml version="1.0"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
-<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+
+<!ENTITY XfcePanelMacros SYSTEM "xml/libxfce4panel-macros.xml">
+<!ENTITY StandardEnumerations SYSTEM "xml/xfce-panel-enums.xml">
+<!ENTITY RegisterPanelPlugin SYSTEM "xml/xfce-panel-plugin.xml">
+<!ENTITY XfcePanelPlugin SYSTEM "xml/xfce-panel-plugin-iface.xml">
+<!ENTITY XfceExternalPanelPlugin SYSTEM "xml/xfce-panel-external-plugin.xml">
+<!ENTITY XfceInternalPanelPlugin SYSTEM "xml/xfce-panel-internal-plugin.xml">
+<!ENTITY XfceHVBox SYSTEM "xml/xfce-hvbox.xml">
+<!ENTITY XfceArrowButton SYSTEM "xml/xfce-arrow-button.xml">
+<!ENTITY XfcePanelWindow SYSTEM "xml/xfce-panel-window.xml">
+<!ENTITY XfceItembar SYSTEM "xml/xfce-itembar.xml">
+<!ENTITY PanelConvenience SYSTEM "xml/xfce-panel-convenience.xml">
+
+<!ENTITY version SYSTEM "version.xml">
+<!ENTITY date "July 2007">
+]>
+
+<book id="index">
<bookinfo>
- <title>libxfce4panel Reference Manual</title>
+ <title>Libxfce4panel Reference Manual</title>
+ <releaseinfo>Version &version;</releaseinfo>
+ <pubdate>&date;</pubdate>
+
+ <copyright>
+ <year>2006</year>
+ <year>2007</year>
+ <holder>Jasper Huijsmans</holder>
+ <holder>Nick Schermer</holder>
+ </copyright>
+
+ <legalnotice id="legalnotice">
+ <para>
+ Permission is granted to copy, distribute and/or modify this document
+ under the terms of the GNU Free Documentation License, Version 1.1 or
+ any later version published by the Free Software Foundation; with no
+ Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
+ Texts. The complete license text is available from the <ulink
+ type="http" url="http://www.gnu.org/">Free Software Foundation</ulink>.
+ </para>
+ </legalnotice>
</bookinfo>
- <chapter>
- <title>API Reference</title>
- <xi:include href="xml/xfce-panel-plugin.xml"/>
- <xi:include href="xml/xfce-panel-plugin-iface.xml"/>
- <xi:include href="xml/xfce-panel-external-plugin.xml"/>
- <xi:include href="xml/xfce-panel-internal-plugin.xml"/>
- <xi:include href="xml/xfce-panel-convenience.xml"/>
- <xi:include href="xml/xfce-arrow-button.xml"/>
- <xi:include href="xml/xfce-panel-window.xml"/>
- <xi:include href="xml/xfce-itembar.xml"/>
- <xi:include href="xml/xfce-hvbox.xml"/>
- <xi:include href="xml/xfce-panel-enums.xml"/>
+ <chapter id="libxfce4panel-fundamentals">
+ <title>Fundamentals</title>
+
+ &XfcePanelMacros;
+ &StandardEnumerations;
</chapter>
+
+ <chapter id="libxfce4panel-panel">
+ <title>Panel Plugins</title>
+
+ &RegisterPanelPlugin;
+ &XfcePanelPlugin;
+ &XfceExternalPanelPlugin;
+ &XfceInternalPanelPlugin;
+ </chapter>
+
+ <chapter id="libxfce4panel-widgets">
+ <title>Widgets</title>
+
+ &XfceArrowButton;
+ &XfceHVBox;
+ &XfceItembar;
+ &XfcePanelWindow;
+ &PanelConvenience;
+ </chapter>
+
+ <index>
+ <title>Index</title>
+ </index>
</book>
Modified: xfce4-panel/trunk/docs/API/libxfce4panel-sections.txt
===================================================================
--- xfce4-panel/trunk/docs/API/libxfce4panel-sections.txt 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/libxfce4panel-sections.txt 2007-07-09 19:51:58 UTC (rev 25905)
@@ -1,4 +1,85 @@
+<INCLUDE>libxfce4panel/libxfce4panel.h</INCLUDE>
+
<SECTION>
+<FILE>libxfce4panel-macros</FILE>
+<TITLE>Common macros</TITLE>
+panel_slice_alloc
+panel_slice_alloc0
+panel_slice_free
+panel_slice_free1
+panel_slice_new
+panel_slice_new0
+PANEL_PARAM_READABLE
+PANEL_PARAM_READWRITE
+PANEL_PARAM_WRITABLE
+I_
+</SECTION>
+
+<SECTION>
+<FILE>xfce-panel-enums</FILE>
+<TITLE>Standard Enumerations</TITLE>
+XfceScreenPosition
+xfce_screen_position_is_horizontal
+xfce_screen_position_get_orientation
+xfce_screen_position_is_floating
+xfce_screen_position_is_top
+xfce_screen_position_is_left
+xfce_screen_position_is_right
+xfce_screen_position_is_bottom
+XfceHandleStyle
+<SUBSECTION Standard>
+XFCE_TYPE_SCREEN_POSITION
+xfce_screen_position_get_type
+XFCE_TYPE_HANDLE_STYLE
+xfce_handle_style_get_type
+</SECTION>
+
+<SECTION>
+<FILE>xfce-panel-plugin</FILE>
+<TITLE>Register Plugins</TITLE>
+XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL
+XFCE_PANEL_PLUGIN_REGISTER_INTERNAL
+XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_FULL
+XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_WITH_CHECK
+XFCE_PANEL_PLUGIN_REGISTER_INTERNAL_WITH_CHECK
+</SECTION>
+
+<SECTION>
+<FILE>xfce-panel-plugin-iface</FILE>
+<TITLE>XfcePanelPlugin</TITLE>
+XfcePanelPlugin
+XfcePanelPluginFunc
+XfcePanelPluginCheck
+XfcePanelPluginPreInit
+xfce_panel_plugin_get_name
+xfce_panel_plugin_get_id
+xfce_panel_plugin_get_display_name
+xfce_panel_plugin_get_size
+xfce_panel_plugin_get_screen_position
+xfce_panel_plugin_set_expand
+xfce_panel_plugin_get_expand
+xfce_panel_plugin_get_orientation
+xfce_panel_plugin_add_action_widget
+xfce_panel_plugin_menu_insert_item
+xfce_panel_plugin_menu_show_about
+xfce_panel_plugin_menu_show_configure
+xfce_panel_plugin_block_menu
+xfce_panel_plugin_unblock_menu
+xfce_panel_plugin_register_menu
+xfce_panel_plugin_lookup_rc_file
+xfce_panel_plugin_save_location
+xfce_panel_plugin_focus_widget
+xfce_panel_plugin_set_panel_hidden
+<SUBSECTION Standard>
+XfcePanelPluginInterface
+XFCE_PANEL_PLUGIN_GET_INTERFACE
+XFCE_PANEL_PLUGIN
+XFCE_IS_PANEL_PLUGIN
+XFCE_TYPE_PANEL_PLUGIN
+xfce_panel_plugin_get_type
+</SECTION>
+
+<SECTION>
<FILE>xfce-panel-external-plugin</FILE>
<TITLE>XfceExternalPanelPlugin</TITLE>
XfceExternalPanelPlugin
@@ -31,6 +112,41 @@
</SECTION>
<SECTION>
+<FILE>xfce-arrow-button</FILE>
+<TITLE>XfceArrowButton</TITLE>
+XfceArrowButton
+xfce_arrow_button_new
+xfce_arrow_button_set_arrow_type
+xfce_arrow_button_get_arrow_type
+<SUBSECTION Standard>
+XfceArrowButtonClass
+XFCE_ARROW_BUTTON
+XFCE_IS_ARROW_BUTTON
+XFCE_TYPE_ARROW_BUTTON
+xfce_arrow_button_get_type
+XFCE_ARROW_BUTTON_CLASS
+XFCE_IS_ARROW_BUTTON_CLASS
+XFCE_ARROW_BUTTON_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>xfce-hvbox</FILE>
+<TITLE>XfceHVBox</TITLE>
+XfceHVBox
+xfce_hvbox_new
+xfce_hvbox_set_orientation
+<SUBSECTION Standard>
+XfceHVBoxClass
+XFCE_HVBOX
+XFCE_IS_HVBOX
+XFCE_TYPE_HVBOX
+xfce_hvbox_get_type
+XFCE_HVBOX_CLASS
+XFCE_IS_HVBOX_CLASS
+XFCE_HVBOX_GET_CLASS
+</SECTION>
+
+<SECTION>
<FILE>xfce-itembar</FILE>
<TITLE>XfceItembar</TITLE>
XfceItembar
@@ -43,6 +159,7 @@
xfce_itembar_reorder_child
xfce_itembar_set_child_expand
xfce_itembar_get_child_expand
+xfce_itembar_set_allow_expand
xfce_itembar_get_n_items
xfce_itembar_get_item_index
xfce_itembar_get_nth_item
@@ -63,75 +180,6 @@
</SECTION>
<SECTION>
-<FILE>xfce-hvbox</FILE>
-<TITLE>XfceHVBox</TITLE>
-XfceHVBox
-xfce_hvbox_new
-xfce_hvbox_set_orientation
-<SUBSECTION Standard>
-XfceHVBoxClass
-XFCE_HVBOX
-XFCE_IS_HVBOX
-XFCE_TYPE_HVBOX
-xfce_hvbox_get_type
-XFCE_HVBOX_CLASS
-XFCE_IS_HVBOX_CLASS
-XFCE_HVBOX_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>xfce-panel-plugin-iface</FILE>
-<TITLE>XfcePanelPlugin</TITLE>
-XfcePanelPlugin
-XfcePanelPluginFunc
-XfcePanelPluginCheck
-xfce_panel_plugin_get_name
-xfce_panel_plugin_get_id
-xfce_panel_plugin_get_display_name
-xfce_panel_plugin_get_size
-xfce_panel_plugin_get_screen_position
-xfce_panel_plugin_set_expand
-xfce_panel_plugin_get_expand
-xfce_panel_plugin_get_orientation
-xfce_panel_plugin_add_action_widget
-xfce_panel_plugin_menu_insert_item
-xfce_panel_plugin_menu_show_about
-xfce_panel_plugin_menu_show_configure
-xfce_panel_plugin_block_menu
-xfce_panel_plugin_unblock_menu
-xfce_panel_plugin_register_menu
-xfce_panel_plugin_lookup_rc_file
-xfce_panel_plugin_save_location
-xfce_panel_plugin_focus_widget
-xfce_panel_plugin_set_panel_hidden
-<SUBSECTION Standard>
-XfcePanelPluginInterface
-XFCE_PANEL_PLUGIN_GET_INTERFACE
-XFCE_PANEL_PLUGIN
-XFCE_IS_PANEL_PLUGIN
-XFCE_TYPE_PANEL_PLUGIN
-xfce_panel_plugin_get_type
-</SECTION>
-
-<SECTION>
-<FILE>xfce-arrow-button</FILE>
-<TITLE>XfceArrowButton</TITLE>
-XfceArrowButton
-xfce_arrow_button_new
-xfce_arrow_button_set_arrow_type
-xfce_arrow_button_get_arrow_type
-<SUBSECTION Standard>
-XfceArrowButtonClass
-XFCE_ARROW_BUTTON
-XFCE_IS_ARROW_BUTTON
-XFCE_TYPE_ARROW_BUTTON
-xfce_arrow_button_get_type
-XFCE_ARROW_BUTTON_CLASS
-XFCE_IS_ARROW_BUTTON_CLASS
-XFCE_ARROW_BUTTON_GET_CLASS
-</SECTION>
-
-<SECTION>
<FILE>xfce-panel-window</FILE>
<TITLE>XfcePanelWindow</TITLE>
XfcePanelWindow
@@ -160,45 +208,9 @@
</SECTION>
<SECTION>
-<FILE>xfce-panel-enums</FILE>
-<TITLE>Standard Enumerations</TITLE>
-XfceScreenPosition
-xfce_screen_position_is_horizontal
-xfce_screen_position_get_orientation
-xfce_screen_position_is_floating
-xfce_screen_position_is_top
-xfce_screen_position_is_left
-xfce_screen_position_is_right
-xfce_screen_position_is_bottom
-XfceHandleStyle
-<SUBSECTION Standard>
-XFCE_TYPE_SCREEN_POSITION
-xfce_screen_position_get_type
-XFCE_TYPE_HANDLE_STYLE
-xfce_handle_style_get_type
-</SECTION>
-
-<SECTION>
-<FILE>xfce-panel-plugin</FILE>
-<TITLE>Writing Plugins</TITLE>
-<INCLUDE>libxfce4panel/libxfce4panel</INCLUDE>
-XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL
-XFCE_PANEL_PLUGIN_REGISTER_INTERNAL
-XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_WITH_CHECK
-XFCE_PANEL_PLUGIN_REGISTER_INTERNAL_WITH_CHECK
-</SECTION>
-
-<SECTION>
<FILE>xfce-panel-convenience</FILE>
-<TITLE>Convenience Functions</TITLE>
+<TITLE>Convenience Widgets</TITLE>
xfce_create_panel_button
xfce_create_panel_toggle_button
xfce_allow_panel_customization
-panel_slice_alloc
-panel_slice_alloc0
-panel_slice_free
-panel_slice_free1
-panel_slice_new
-panel_slice_new0
</SECTION>
-
Deleted: xfce4-panel/trunk/docs/API/libxfce4panel-undocumented.txt
Modified: xfce4-panel/trunk/docs/API/libxfce4panel.types
===================================================================
--- xfce4-panel/trunk/docs/API/libxfce4panel.types 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/libxfce4panel.types 2007-07-09 19:51:58 UTC (rev 25905)
@@ -1,17 +1,9 @@
-#include <libxfce4panel/xfce-arrow-button.h>
-#include <libxfce4panel/xfce-panel-window.h>
-#include <libxfce4panel/xfce-itembar.h>
-#include <libxfce4panel/xfce-hvbox.h>
#include <libxfce4panel/xfce-panel-plugin.h>
-#include <libxfce4panel/xfce-panel-plugin-iface.h>
-#include <libxfce4panel/xfce-panel-external-plugin.h>
-#include <libxfce4panel/xfce-panel-internal-plugin.h>
xfce_arrow_button_get_type
-xfce_panel_window_get_type
-xfce_itembar_get_type
xfce_hvbox_get_type
xfce_panel_plugin_get_type
+xfce_panel_window_get_type
+xfce_itembar_get_type
xfce_external_panel_plugin_get_type
xfce_internal_panel_plugin_get_type
-
Added: xfce4-panel/trunk/docs/API/tmpl/libxfce4panel-macros.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/libxfce4panel-macros.sgml (rev 0)
+++ xfce4-panel/trunk/docs/API/tmpl/libxfce4panel-macros.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -0,0 +1,95 @@
+<!-- ##### SECTION Title ##### -->
+Common macros
+
+<!-- ##### SECTION Short_Description ##### -->
+Macros to work glib version independent.
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+Macros for plugin writers to use new features in Glib 2.8 and 2.10 without
+breaking old versions of Glib. It is recommended to use those macros
+when possible.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### MACRO panel_slice_alloc ##### -->
+<para>
+Use g_slice_alloc is available, fallback to g_malloc.
+</para>
+
+ at block_size: the number of bytes to allocate
+
+
+<!-- ##### MACRO panel_slice_alloc0 ##### -->
+<para>
+Use g_slice_alloc0 is available, fallback to g_malloc0.
+</para>
+
+ at block_size: the number of bytes to allocate
+
+
+<!-- ##### MACRO panel_slice_free ##### -->
+<para>
+Use g_slice_free is available, fallback to g_free.
+</para>
+
+ at type: the type to allocate, typically a structure name
+ at ptr: a pointer to the block to free
+
+
+<!-- ##### MACRO panel_slice_free1 ##### -->
+<para>
+Use g_slice_free1 is available, fallback to g_free.
+</para>
+
+ at block_size: the number of bytes to allocate
+ at mem_block: a pointer to the block to free
+
+
+<!-- ##### MACRO panel_slice_new ##### -->
+<para>
+Use g_slice_new is available, fallback to g_new.
+</para>
+
+ at type: the type to allocate, typically a structure name
+
+
+<!-- ##### MACRO panel_slice_new0 ##### -->
+<para>
+Use g_slice_new0 is available, fallback to g_new0.
+</para>
+
+ at type: the type to allocate, typically a structure name
+
+
+<!-- ##### MACRO PANEL_PARAM_READABLE ##### -->
+<para>
+Alias for G_PARAM_READABLE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB
+</para>
+
+
+
+<!-- ##### MACRO PANEL_PARAM_READWRITE ##### -->
+<para>
+Alias for G_PARAM_WRITABLE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB
+</para>
+
+
+
+<!-- ##### MACRO PANEL_PARAM_WRITABLE ##### -->
+<para>
+Alias for G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB
+</para>
+
+
+<!-- ##### MACRO I_ ##### -->
+<para>
+canonical representation for @string. This can be use in functions like g_object_get_data.
+</para>
+
+ at string: a string
Modified: xfce4-panel/trunk/docs/API/tmpl/libxfce4panel-unused.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/libxfce4panel-unused.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/tmpl/libxfce4panel-unused.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -22,6 +22,33 @@
@parent_class:
+<!-- ##### SIGNAL XfceItembar::contents-changed ##### -->
+<para>
+
+</para>
+
+ at xfceitembar: the object which received the signal.
+
+<!-- ##### SIGNAL XfceItembar::orientation-changed ##### -->
+<para>
+
+</para>
+
+ at xfceitembar: the object which received the signal.
+ at arg1:
+
+<!-- ##### ARG XfceItembar:expand ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG XfceItembar:orientation ##### -->
+<para>
+
+</para>
+
+
<!-- ##### STRUCT XfceItembarClass ##### -->
<para>
@@ -35,12 +62,146 @@
@_xfce_reserved2:
@_xfce_reserved3:
+<!-- ##### SIGNAL XfcePanelPlugin::about ##### -->
+<para>
+
+</para>
+
+ at xfcepanelplugin: the object which received the signal.
+
+<!-- ##### SIGNAL XfcePanelPlugin::configure-plugin ##### -->
+<para>
+
+</para>
+
+ at xfcepanelplugin: the object which received the signal.
+
+<!-- ##### SIGNAL XfcePanelPlugin::free-data ##### -->
+<para>
+
+</para>
+
+ at xfcepanelplugin: the object which received the signal.
+
+<!-- ##### SIGNAL XfcePanelPlugin::orientation-changed ##### -->
+<para>
+
+</para>
+
+ at xfcepanelplugin: the object which received the signal.
+ at arg1:
+
+<!-- ##### SIGNAL XfcePanelPlugin::save ##### -->
+<para>
+
+</para>
+
+ at xfcepanelplugin: the object which received the signal.
+
+<!-- ##### SIGNAL XfcePanelPlugin::screen-position-changed ##### -->
+<para>
+
+</para>
+
+ at xfcepanelplugin: the object which received the signal.
+ at arg1:
+
+<!-- ##### SIGNAL XfcePanelPlugin::size-changed ##### -->
+<para>
+
+</para>
+
+ at xfcepanelplugin: the object which received the signal.
+ at arg1:
+ at Returns:
+
+<!-- ##### ARG XfcePanelPlugin:display-name ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG XfcePanelPlugin:expand ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG XfcePanelPlugin:id ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG XfcePanelPlugin:name ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG XfcePanelPlugin:screen-position ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG XfcePanelPlugin:size ##### -->
+<para>
+
+</para>
+
+
<!-- ##### STRUCT XfcePanelPluginInterface ##### -->
<para>
</para>
+<!-- ##### SIGNAL XfcePanelWindow::move ##### -->
+<para>
+
+</para>
+
+ at xfcepanelwindow: the object which received the signal.
+ at arg1:
+ at arg2:
+
+<!-- ##### SIGNAL XfcePanelWindow::move-end ##### -->
+<para>
+
+</para>
+
+ at xfcepanelwindow: the object which received the signal.
+ at arg1:
+ at arg2:
+
+<!-- ##### SIGNAL XfcePanelWindow::move-start ##### -->
+<para>
+
+</para>
+
+ at xfcepanelwindow: the object which received the signal.
+
+<!-- ##### SIGNAL XfcePanelWindow::orientation-changed ##### -->
+<para>
+
+</para>
+
+ at xfcepanelwindow: the object which received the signal.
+ at arg1:
+
+<!-- ##### ARG XfcePanelWindow:handle-style ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG XfcePanelWindow:orientation ##### -->
+<para>
+
+</para>
+
+
<!-- ##### STRUCT XfcePanelWindowClass ##### -->
<para>
Modified: xfce4-panel/trunk/docs/API/tmpl/xfce-arrow-button.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/xfce-arrow-button.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/tmpl/xfce-arrow-button.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -2,9 +2,7 @@
XfceArrowButton
<!-- ##### SECTION Short_Description ##### -->
-<para>
Toggle button with arrow.
-</para>
<!-- ##### SECTION Long_Description ##### -->
<para>
Modified: xfce4-panel/trunk/docs/API/tmpl/xfce-hvbox.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/xfce-hvbox.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/tmpl/xfce-hvbox.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -2,9 +2,7 @@
XfceHVBox
<!-- ##### SECTION Short_Description ##### -->
-<para>
Container widget with configurable orienation.
-</para>
<!-- ##### SECTION Long_Description ##### -->
<para>
@@ -22,7 +20,8 @@
<!-- ##### STRUCT XfceHVBox ##### -->
<para>
-
+The #XfceHVBox struct contains private data only, and
+should be accessed using the functions below.
</para>
@@ -31,10 +30,10 @@
</para>
- at orientation:
- at homogeneous:
- at spacing:
- at Returns:
+ at orientation:
+ at homogeneous:
+ at spacing:
+ at Returns:
<!-- ##### FUNCTION xfce_hvbox_set_orientation ##### -->
@@ -42,7 +41,7 @@
</para>
- at hvbox:
- at orientation:
+ at hvbox:
+ at orientation:
Modified: xfce4-panel/trunk/docs/API/tmpl/xfce-itembar.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/xfce-itembar.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/tmpl/xfce-itembar.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -2,14 +2,12 @@
XfceItembar
<!-- ##### SECTION Short_Description ##### -->
-<para>
Container widget with configurable orientation.
-</para>
<!-- ##### SECTION Long_Description ##### -->
<para>
#XfceItembar is a container widget that can hold multiple widgets. The
-orientation of the bar is configurable and can be changed at any time.
+orientation of the bar is configurable and can be changed at any time.
</para>
<!-- ##### SECTION See_Also ##### -->
@@ -26,32 +24,8 @@
should be accessed using the functions below.
</para>
+ at __parent__:
-<!-- ##### SIGNAL XfceItembar::contents-changed ##### -->
-<para>
-
-</para>
-
- at xfceitembar: the object which received the signal.
-
-<!-- ##### SIGNAL XfceItembar::orientation-changed ##### -->
-<para>
-
-</para>
-
- at xfceitembar: the object which received the signal.
- at arg1:
-
-<!-- ##### ARG XfceItembar:orientation ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG XfceItembar:expand ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION xfce_itembar_new ##### -->
<para>
Modified: xfce4-panel/trunk/docs/API/tmpl/xfce-panel-convenience.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/xfce-panel-convenience.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/tmpl/xfce-panel-convenience.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -2,15 +2,11 @@
Convenience Functions
<!-- ##### SECTION Short_Description ##### -->
-<para>
Special purpose widgets and utilities.
-</para>
<!-- ##### SECTION Long_Description ##### -->
-<para>
This section describes a number of functions that were created to help
developers of Xfce Panel plugins.
-</para>
<!-- ##### SECTION See_Also ##### -->
<para>
@@ -44,53 +40,3 @@
@Returns:
-<!-- ##### MACRO panel_slice_alloc ##### -->
-<para>
-
-</para>
-
- at block_size:
-
-
-<!-- ##### MACRO panel_slice_alloc0 ##### -->
-<para>
-
-</para>
-
- at block_size:
-
-
-<!-- ##### MACRO panel_slice_free ##### -->
-<para>
-
-</para>
-
- at type:
- at ptr:
-
-
-<!-- ##### MACRO panel_slice_free1 ##### -->
-<para>
-
-</para>
-
- at block_size:
- at mem_block:
-
-
-<!-- ##### MACRO panel_slice_new ##### -->
-<para>
-
-</para>
-
- at type:
-
-
-<!-- ##### MACRO panel_slice_new0 ##### -->
-<para>
-
-</para>
-
- at type:
-
-
Modified: xfce4-panel/trunk/docs/API/tmpl/xfce-panel-enums.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/xfce-panel-enums.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/tmpl/xfce-panel-enums.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -2,9 +2,7 @@
Standard Enumerations
<!-- ##### SECTION Short_Description ##### -->
-<para>
Standard enumerations used by the Xfce Panel.
-</para>
<!-- ##### SECTION Long_Description ##### -->
<para>
@@ -24,29 +22,29 @@
</para>
- at XFCE_SCREEN_POSITION_NONE:
- at XFCE_SCREEN_POSITION_NW_H:
- at XFCE_SCREEN_POSITION_N:
- at XFCE_SCREEN_POSITION_NE_H:
- at XFCE_SCREEN_POSITION_NW_V:
- at XFCE_SCREEN_POSITION_W:
- at XFCE_SCREEN_POSITION_SW_V:
- at XFCE_SCREEN_POSITION_NE_V:
- at XFCE_SCREEN_POSITION_E:
- at XFCE_SCREEN_POSITION_SE_V:
- at XFCE_SCREEN_POSITION_SW_H:
- at XFCE_SCREEN_POSITION_S:
- at XFCE_SCREEN_POSITION_SE_H:
- at XFCE_SCREEN_POSITION_FLOATING_H:
- at XFCE_SCREEN_POSITION_FLOATING_V:
+ at XFCE_SCREEN_POSITION_NONE:
+ at XFCE_SCREEN_POSITION_NW_H:
+ at XFCE_SCREEN_POSITION_N:
+ at XFCE_SCREEN_POSITION_NE_H:
+ at XFCE_SCREEN_POSITION_NW_V:
+ at XFCE_SCREEN_POSITION_W:
+ at XFCE_SCREEN_POSITION_SW_V:
+ at XFCE_SCREEN_POSITION_NE_V:
+ at XFCE_SCREEN_POSITION_E:
+ at XFCE_SCREEN_POSITION_SE_V:
+ at XFCE_SCREEN_POSITION_SW_H:
+ at XFCE_SCREEN_POSITION_S:
+ at XFCE_SCREEN_POSITION_SE_H:
+ at XFCE_SCREEN_POSITION_FLOATING_H:
+ at XFCE_SCREEN_POSITION_FLOATING_V:
<!-- ##### MACRO xfce_screen_position_is_horizontal ##### -->
<para>
</para>
- at position:
- at Returns:
+ at position:
+ at Returns:
<!-- ##### MACRO xfce_screen_position_get_orientation ##### -->
@@ -54,8 +52,8 @@
</para>
- at position:
- at Returns:
+ at position:
+ at Returns:
<!-- ##### MACRO xfce_screen_position_is_floating ##### -->
@@ -63,8 +61,8 @@
</para>
- at position:
- at Returns:
+ at position:
+ at Returns:
<!-- ##### MACRO xfce_screen_position_is_top ##### -->
@@ -72,8 +70,8 @@
</para>
- at position:
- at Returns:
+ at position:
+ at Returns:
<!-- ##### MACRO xfce_screen_position_is_left ##### -->
@@ -81,8 +79,8 @@
</para>
- at position:
- at Returns:
+ at position:
+ at Returns:
<!-- ##### MACRO xfce_screen_position_is_right ##### -->
@@ -90,8 +88,8 @@
</para>
- at position:
- at Returns:
+ at position:
+ at Returns:
<!-- ##### MACRO xfce_screen_position_is_bottom ##### -->
@@ -99,8 +97,8 @@
</para>
- at position:
- at Returns:
+ at position:
+ at Returns:
<!-- ##### ENUM XfceHandleStyle ##### -->
@@ -108,8 +106,8 @@
</para>
- at XFCE_HANDLE_STYLE_NONE:
- at XFCE_HANDLE_STYLE_BOTH:
- at XFCE_HANDLE_STYLE_START:
- at XFCE_HANDLE_STYLE_END:
+ at XFCE_HANDLE_STYLE_NONE:
+ at XFCE_HANDLE_STYLE_BOTH:
+ at XFCE_HANDLE_STYLE_START:
+ at XFCE_HANDLE_STYLE_END:
Modified: xfce4-panel/trunk/docs/API/tmpl/xfce-panel-external-plugin.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/xfce-panel-external-plugin.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/tmpl/xfce-panel-external-plugin.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -2,9 +2,7 @@
XfceExternalPanelPlugin
<!-- ##### SECTION Short_Description ##### -->
-<para>
External plugin widget.
-</para>
<!-- ##### SECTION Long_Description ##### -->
<para>
@@ -23,10 +21,11 @@
<!-- ##### STRUCT XfceExternalPanelPlugin ##### -->
<para>
The #XfceExternalPanelPlugin-struct struct contains private data only, and
-should be accessed using the functions for the
+should be accessed using the functions for the
<link linkend="XfcePanelPlugin">XfcePanelPlugin Interface</link>.
</para>
+ at parent:
<!-- ##### FUNCTION xfce_external_panel_plugin_new ##### -->
<para>
Modified: xfce4-panel/trunk/docs/API/tmpl/xfce-panel-internal-plugin.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/xfce-panel-internal-plugin.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/tmpl/xfce-panel-internal-plugin.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -2,9 +2,7 @@
XfceInternalPanelPlugin
<!-- ##### SECTION Short_Description ##### -->
-<para>
Internal panel plugin.
-</para>
<!-- ##### SECTION Long_Description ##### -->
<para>
@@ -23,10 +21,11 @@
<!-- ##### STRUCT XfceInternalPanelPlugin ##### -->
<para>
The #XfceInternalPanelPlugin-struct struct contains private data only, and
-should be accessed using the functions for the
+should be accessed using the functions for the
<link linkend="XfcePanelPlugin">XfcePanelPlugin Interface</link>.
</para>
+ at parent:
<!-- ##### FUNCTION xfce_internal_panel_plugin_new ##### -->
<para>
Modified: xfce4-panel/trunk/docs/API/tmpl/xfce-panel-plugin-iface.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/xfce-panel-plugin-iface.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/tmpl/xfce-panel-plugin-iface.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -2,9 +2,7 @@
XfcePanelPlugin
<!-- ##### SECTION Short_Description ##### -->
-<para>
Panel plugin interface.
-</para>
<!-- ##### SECTION Long_Description ##### -->
<para>
@@ -15,7 +13,7 @@
<!-- ##### SECTION See_Also ##### -->
<para>
-<link linkend="libxfce4panel-Writing-Plugins">Writing Plugins</link>
+<link linkend="libxfce4panel-Register-Plugins">Register Plugins</link>
</para>
<!-- ##### SECTION Stability_Level ##### -->
@@ -28,89 +26,6 @@
</para>
-<!-- ##### SIGNAL XfcePanelPlugin::about ##### -->
-<para>
-
-</para>
-
- at xfcepanelplugin: the object which received the signal.
-
-<!-- ##### SIGNAL XfcePanelPlugin::configure-plugin ##### -->
-<para>
-
-</para>
-
- at xfcepanelplugin: the object which received the signal.
-
-<!-- ##### SIGNAL XfcePanelPlugin::free-data ##### -->
-<para>
-
-</para>
-
- at xfcepanelplugin: the object which received the signal.
-
-<!-- ##### SIGNAL XfcePanelPlugin::orientation-changed ##### -->
-<para>
-
-</para>
-
- at xfcepanelplugin: the object which received the signal.
- at arg1:
-
-<!-- ##### SIGNAL XfcePanelPlugin::save ##### -->
-<para>
-
-</para>
-
- at xfcepanelplugin: the object which received the signal.
-
-<!-- ##### SIGNAL XfcePanelPlugin::screen-position-changed ##### -->
-<para>
-
-</para>
-
- at xfcepanelplugin: the object which received the signal.
- at arg1:
-
-<!-- ##### SIGNAL XfcePanelPlugin::size-changed ##### -->
-<para>
-
-</para>
-
- at xfcepanelplugin: the object which received the signal.
- at arg1:
- at Returns:
-
-<!-- ##### ARG XfcePanelPlugin:display-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG XfcePanelPlugin:expand ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG XfcePanelPlugin:id ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG XfcePanelPlugin:name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG XfcePanelPlugin:screen-position ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG XfcePanelPlugin:size ##### -->
-<para>
-
-</para>
-
<!-- ##### USER_FUNCTION XfcePanelPluginFunc ##### -->
<para>
Modified: xfce4-panel/trunk/docs/API/tmpl/xfce-panel-plugin.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/xfce-panel-plugin.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/tmpl/xfce-panel-plugin.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -1,14 +1,14 @@
<!-- ##### SECTION Title ##### -->
-Writing Plugins
+Register Plugins
<!-- ##### SECTION Short_Description ##### -->
-<para>
-Information for plugin writers
-</para>
+Macros to register a plugin with the Xfce Panel
<!-- ##### SECTION Long_Description ##### -->
<para>
-Macros to register a plugin with the Xfce Panel.
+Each plugin needs a macro to register with the panel. Since a plugin
+can be internal or external, you have to choose the appropriate macro
+from the 4 below.
</para>
<!-- ##### SECTION See_Also ##### -->
Modified: xfce4-panel/trunk/docs/API/tmpl/xfce-panel-window.sgml
===================================================================
--- xfce4-panel/trunk/docs/API/tmpl/xfce-panel-window.sgml 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/docs/API/tmpl/xfce-panel-window.sgml 2007-07-09 19:51:58 UTC (rev 25905)
@@ -2,9 +2,7 @@
XfcePanelWindow
<!-- ##### SECTION Short_Description ##### -->
-<para>
A toplevel borderless window with optional move handles.
-</para>
<!-- ##### SECTION Long_Description ##### -->
<para>
@@ -26,50 +24,8 @@
should be accessed using the functions below.
</para>
+ at window:
-<!-- ##### SIGNAL XfcePanelWindow::move ##### -->
-<para>
-
-</para>
-
- at xfcepanelwindow: the object which received the signal.
- at arg1:
- at arg2:
-
-<!-- ##### SIGNAL XfcePanelWindow::move-end ##### -->
-<para>
-
-</para>
-
- at xfcepanelwindow: the object which received the signal.
- at arg1:
- at arg2:
-
-<!-- ##### SIGNAL XfcePanelWindow::move-start ##### -->
-<para>
-
-</para>
-
- at xfcepanelwindow: the object which received the signal.
-
-<!-- ##### SIGNAL XfcePanelWindow::orientation-changed ##### -->
-<para>
-
-</para>
-
- at xfcepanelwindow: the object which received the signal.
- at arg1:
-
-<!-- ##### ARG XfcePanelWindow:handle-style ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG XfcePanelWindow:orientation ##### -->
-<para>
-
-</para>
-
<!-- ##### USER_FUNCTION XfcePanelWindowMoveFunc ##### -->
<para>
Modified: xfce4-panel/trunk/libxfce4panel/xfce-arrow-button.c
===================================================================
--- xfce4-panel/trunk/libxfce4panel/xfce-arrow-button.c 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/libxfce4panel/xfce-arrow-button.c 2007-07-09 19:51:58 UTC (rev 25905)
@@ -279,20 +279,22 @@
* xfce_arrow_button_new:
* @type : #GtkArrowType for the arrow button
*
- * Returns: newly created #XfceArrowButton widget.
+ * Creates a new #XfceArrowButton widget.
+ *
+ * Returns: The newly created #XfceArrowButton widget.
**/
GtkWidget *
xfce_arrow_button_new (GtkArrowType type)
{
- return g_object_new (XFCE_TYPE_ARROW_BUTTON, "arrow_type", type, NULL);
+ return g_object_new (XFCE_TYPE_ARROW_BUTTON, "arrow-type", type, NULL);
}
/**
* xfce_arrow_button_set_arrow_type:
- * @button : an #XfceArrowButton
- * @type : new #GtkArrowType to set
+ * @button : a #XfceArrowButton
+ * @type : a valid #GtkArrowType
*
* Sets the arrow type for @button.
**/
@@ -315,8 +317,10 @@
/**
* xfce_arrow_button_get_arrow_type:
- * @button : an #XfceArrowButton
+ * @button : a #XfceArrowButton
*
+ * Returns the value of the ::arrow-type property.
+ *
* Returns: the #GtkArrowType of @button.
**/
GtkArrowType
Modified: xfce4-panel/trunk/libxfce4panel/xfce-hvbox.c
===================================================================
--- xfce4-panel/trunk/libxfce4panel/xfce-hvbox.c 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/libxfce4panel/xfce-hvbox.c 2007-07-09 19:51:58 UTC (rev 25905)
@@ -134,7 +134,7 @@
/**
* xfce_hvbox_new:
- * @orienation : Orientation of the #XfceHVBox
+ * @orientation : Orientation of the #XfceHVBox
* @homogeneous : whether all children should be allocated the same size
* @spacing : spacing between #XfceHVBox children
*
Modified: xfce4-panel/trunk/libxfce4panel/xfce-itembar.c
===================================================================
--- xfce4-panel/trunk/libxfce4panel/xfce-itembar.c 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/libxfce4panel/xfce-itembar.c 2007-07-09 19:51:58 UTC (rev 25905)
@@ -471,7 +471,7 @@
/* - get size request for all items
* - get number of expanding items
* - determine space available for expanding items
- * - determine largest width of expanding items
+ * - determine largest width of expanding items
*/
for (l = priv->children, i = 0; l != NULL; l = l->next, i++)
{
@@ -535,7 +535,7 @@
max_expand = 0;
- /* - remove bigger items from expand list
+ /* - remove bigger items from expand list
* - recalculate n_expand, total_expand and max_expand
*/
for (i = 0; i < n_total; ++i)
@@ -1023,6 +1023,8 @@
* xfce_itembar_new:
* @orientation : #GtkOrientation for new itembar.
*
+ * Creates a new #XfceItembar widget.
+ *
* Returns: new #XfceItembar widget with @orientation.
**/
GtkWidget *
@@ -1036,7 +1038,8 @@
/**
* xfce_itembar_set_allow_expand:
- * @allow : %TRUE when the expansion is allowed.
+ * @itembar: a #XfceItembar
+ * @allow : %TRUE when the expansion is allowed.
*
* Set whether the 'expand' child property is honored.
*
@@ -1060,8 +1063,10 @@
/**
* xfce_itembar_get_orientation:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
*
+ * Return the orientation of the #XfceItembar.
+ *
* Returns: #GtkOrienation of @itembar.
**/
GtkOrientation
@@ -1080,7 +1085,7 @@
/**
* xfce_itembar_set_orientation:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
* @orientation : new #GtkOrientation
*
* Set the orienation of @itembar.
@@ -1112,7 +1117,7 @@
/**
* xfce_itembar_insert:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
* @item : #GtkWidget to insert
* @position : position for @item
*
@@ -1148,7 +1153,7 @@
/**
* xfce_itembar_append:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
* @item : #GtkWidget to add
*
* Add a new item at the end of @itembar.
@@ -1164,7 +1169,7 @@
/**
* xfce_itembar_prepend:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
* @item : #GtkWidget to add
*
* Add a new item at the start of @itembar.
@@ -1180,7 +1185,7 @@
/**
* xfce_itembar_reorder_child:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
* @item : a child #GtkWidget of @itembar
* @position : new index for @item
*
@@ -1225,9 +1230,12 @@
/**
* xfce_itembar_get_child_expand:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
* @item : a child #GtkWidget of @itembar
*
+ * Return if the #GtkWidget in the #XfceItembar expands when the panel
+ * is resized.
+ *
* Returns: %TRUE if @item will expand when the size of @itembar increases,
* otherwise %FALSE.
**/
@@ -1260,7 +1268,7 @@
/**
* xfce_itembar_set_child_expand:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
* @item : a child #GtkWidget of @itembar
* @expand : whether to expand the item
*
@@ -1298,8 +1306,10 @@
/**
* xfce_itembar_get_n_items:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
*
+ * Return the number of items on a #XfceItembar.
+ *
* Returns: the number of items on @itembar.
**/
gint
@@ -1318,9 +1328,11 @@
/**
* xfce_itembar_get_item_index:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
* @item : a child #GtkWidget of @itembar
*
+ * The index if the child #GtkWidget in a #XfceItembar.
+ *
* Returns: the index of @item or -1 if @itembar does not contain @item.
**/
gint
@@ -1354,9 +1366,12 @@
/**
* xfce_itembar_get_nth_item:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
* @n : a position on the itembar
*
+ * Return the #GtkWidget inside the #XfceItembar with the @n<!-- -->'s
+ * index.
+ *
* Returns: the @n<!-- -->'s item on @itembar, or %NULL if the
* itembar does not contain an @n<!-- -->'th item.
**/
@@ -1386,7 +1401,7 @@
/**
* xfce_itembar_raise_event_window:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
*
* Raise the event window of @itembar. This causes all events, like
* mouse clicks or key presses to be send to the itembar and not to
@@ -1413,7 +1428,7 @@
/**
* xfce_itembar_lower_event_window:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
*
* Lower the event window of @itembar. This causes all events, like
* mouse clicks or key presses to be send to the items, before reaching the
@@ -1440,8 +1455,10 @@
/**
* xfce_itembar_event_window_is_raised:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
*
+ * Whether the event window of the #XfceItembar is raised.
+ *
* Returns: %TRUE if event window is raised.
**/
gboolean
@@ -1460,10 +1477,13 @@
/**
* xfce_itembar_get_item_at_point:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
* @x : x coordinate relative to the itembar window
* @y : y coordinate relative to the itembar window
*
+ * Return the #GtkWidget in the #XfceItembar that is below the (x,y)
+ * coordinate.
+ *
* Returns: a #GtkWidget or %NULL.
**/
GtkWidget *
@@ -1504,7 +1524,7 @@
/**
* xfce_itembar_get_drop_index:
- * @itembar : an #XfceItembar
+ * @itembar : a #XfceItembar
* @x : x coordinate of a point on the itembar
* @y : y coordinate of a point on the itembar
*
Modified: xfce4-panel/trunk/libxfce4panel/xfce-panel-convenience.c
===================================================================
--- xfce4-panel/trunk/libxfce4panel/xfce-panel-convenience.c 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/libxfce4panel/xfce-panel-convenience.c 2007-07-09 19:51:58 UTC (rev 25905)
@@ -53,7 +53,7 @@
/**
- * xfce_create_panel_button:
+ * xfce_create_panel_toggle_button:
*
* Create regular #GtkToggleButton with a few properties set to be useful in
* Xfce panel: Flat (%GTK_RELIEF_NONE), no focus on click and minimal padding.
Modified: xfce4-panel/trunk/libxfce4panel/xfce-panel-enums.h
===================================================================
--- xfce4-panel/trunk/libxfce4panel/xfce-panel-enums.h 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/libxfce4panel/xfce-panel-enums.h 2007-07-09 19:51:58 UTC (rev 25905)
@@ -77,9 +77,11 @@
XfceScreenPosition;
/**
- * xfce_screen_position_is_horizontal
+ * xfce_screen_position_is_horizontal:
* @position : the #XfceScreenPosition
*
+ * Whether the current #XfceScreenPosition is horizontal.
+ *
* Returns: %TRUE if horizontal, %FALSE otherwise
**/
#define xfce_screen_position_is_horizontal(position) \
@@ -88,9 +90,11 @@
position <= XFCE_SCREEN_POSITION_FLOATING_H))
/**
- * xfce_screen_position_get_orientation
+ * xfce_screen_position_get_orientation:
* @position : the #XfceScreenPosition
*
+ * Converts the current #XfceScreenPosition into a #GtkOrientation.
+ *
* Returns: the #GtkOrientation corresponding to @position.
**/
#define xfce_screen_position_get_orientation(position) \
@@ -98,9 +102,11 @@
GTK_ORIENTATION_HORIZONTAL : GTK_ORIENTATION_VERTICAL)
/**
- * xfce_screen_position_is_floating
+ * xfce_screen_position_is_floating:
* @position : the #XfceScreenPosition
*
+ * Whether the current #XfceScreenPosition is floating on the screen.
+ *
* Returns: %TRUE if floating, %FALSE otherwise.
**/
#define xfce_screen_position_is_floating(position) \
@@ -108,9 +114,12 @@
position == XFCE_SCREEN_POSITION_NONE)
/**
- * xfce_screen_position_is_top
+ * xfce_screen_position_is_top:
* @position : the #XfceScreenPosition
*
+ * Whether the current #XfceScreenPosition is above of the center of
+ * the screen.
+ *
* Returns: %TRUE if on the top of the screen, %FALSE otherwise
**/
#define xfce_screen_position_is_top(position) \
@@ -118,9 +127,12 @@
position <= XFCE_SCREEN_POSITION_NE_H)
/**
- * xfce_screen_position_is_left
+ * xfce_screen_position_is_left:
* @position : the #XfceScreenPosition
*
+ * Whether the current #XfceScreenPosition is left of the center of
+ * the screen.
+ *
* Returns: %TRUE if on the left of the screen, %FALSE otherwise
**/
#define xfce_screen_position_is_left(position) \
@@ -128,9 +140,12 @@
position <= XFCE_SCREEN_POSITION_SW_V)
/**
- * xfce_screen_position_is_right
+ * xfce_screen_position_is_right:
* @position : the #XfceScreenPosition
*
+ * Whether the current #XfceScreenPosition is right of the center of
+ * the screen.
+ *
* Returns: %TRUE if on the right of the screen, %FALSE otherwise
**/
#define xfce_screen_position_is_right(position) \
@@ -138,9 +153,12 @@
position <= XFCE_SCREEN_POSITION_SE_V)
/**
- * xfce_screen_position_is_bottom
+ * xfce_screen_position_is_bottom:
* @position : the #XfceScreenPosition
*
+ * Whether the current #XfceScreenPosition is below of the center of
+ * the screen.
+ *
* Returns: %TRUE if on the bottom of the screen, %FALSE otherwise
**/
#define xfce_screen_position_is_bottom(position) \
Modified: xfce4-panel/trunk/libxfce4panel/xfce-panel-plugin-iface.c
===================================================================
--- xfce4-panel/trunk/libxfce4panel/xfce-panel-plugin-iface.c 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/libxfce4panel/xfce-panel-plugin-iface.c 2007-07-09 19:51:58 UTC (rev 25905)
@@ -296,7 +296,7 @@
/**
* _xfce_panel_plugin_signal_screen_position
- * @plugin : an #XfcePanelPlugin
+ * @plugin : a #XfcePanelPlugin
* @position : the new #XfceScreenPosition of the panel.
*
* Should be called by implementations of the interface.
@@ -315,7 +315,7 @@
/**
* _xfce_panel_plugin_signal_orientation
- * @plugin : an #XfcePanelPlugin
+ * @plugin : a #XfcePanelPlugin
* @orientation : the new #GtkOrientation of the panel.
*
* Should be called by implementations of the interface.
@@ -334,7 +334,7 @@
/**
* _xfce_panel_plugin_signal_size
- * @plugin : an #XfcePanelPlugin
+ * @plugin : a #XfcePanelPlugin
* @size : the new size of the panel.
*
* Should be called by implementations of the interface.
@@ -358,7 +358,7 @@
/**
* _xfce_panel_plugin_signal_free_data
- * @plugin : an #XfcePanelPlugin
+ * @plugin : a #XfcePanelPlugin
*
* Should be called by implementations of the interface.
**/
@@ -374,7 +374,7 @@
/**
* _xfce_panel_plugin_signal_save
- * @plugin : an #XfcePanelPlugin
+ * @plugin : a #XfcePanelPlugin
*
* Should be called by implementations of the interface.
**/
@@ -390,7 +390,7 @@
/**
* xfce_panel_plugin_signal_about
- * @plugin : an #XfcePanelPlugin
+ * @plugin : a #XfcePanelPlugin
*
* Should be called by implementations of the interface.
**/
@@ -406,7 +406,7 @@
/**
* _xfce_panel_plugin_signal_configure
- * @plugin : an #XfcePanelPlugin
+ * @plugin : a #XfcePanelPlugin
*
* Should be called by implementations of the interface.
**/
@@ -422,7 +422,7 @@
/**
* xfce_panel_plugin_get_name
- * @plugin : an #XfcePanelPlugin
+ * @plugin : a #XfcePanelPlugin
*
* The plugin name identifies a plugin type and therefore must be unique.
*
@@ -443,11 +443,11 @@
/**
- * xfce_panel_plugin_get_id
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_get_id:
+ * @plugin : a #XfcePanelPlugin
*
* The plugin id is a unique identifier string that is given to every instance
- * of a panel plugin.
+ * of a panel plugin. The returned string must be free using g_free().
*
* Returns: the plugin id.
**/
@@ -466,8 +466,8 @@
/**
- * xfce_panel_plugin_get_display_name
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_get_display_name:
+ * @plugin : a #XfcePanelPlugin
*
* The display name is the (translated) plugin name that can be used in a user
* interface, e.g. a dialog or a menu.
@@ -490,8 +490,10 @@
/**
* xfce_panel_plugin_get_size
- * @plugin : an #XfcePanelPlugin
+ * @plugin : a #XfcePanelPlugin
*
+ * The size of the panel that the plugin is part of.
+ *
* Returns: the current panel size.
**/
gint
@@ -510,8 +512,10 @@
/**
* xfce_panel_plugin_get_screen_position
- * @plugin : an #XfcePanelPlugin
+ * @plugin : a #XfcePanelPlugin
*
+ * The #XfceScreenPosition of the panel that the plugin is part of.
+ *
* Returns: the current #XfceScreenPosition of the panel.
**/
XfceScreenPosition
@@ -520,7 +524,7 @@
XfceScreenPosition screen_position;
_panel_return_val_if_fail (XFCE_IS_PANEL_PLUGIN (plugin),
- XFCE_SCREEN_POSITION_S);
+ XFCE_SCREEN_POSITION_S);
g_object_get (G_OBJECT (plugin), I_("screen-position"), &screen_position,
NULL);
@@ -531,10 +535,12 @@
/**
- * xfce_panel_plugin_get_expand
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_get_expand:
+ * @plugin : a #XfcePanelPlugin
*
- * Returns: whether the plugin will expand when the panel width increases.
+ * Return if this plugin will expand when the panel width increases.
+ *
+ * Returns: %TRUE when it will expand.
**/
gboolean
xfce_panel_plugin_get_expand (XfcePanelPlugin *plugin)
@@ -551,9 +557,11 @@
/**
- * xfce_panel_plugin_get_orientation
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_get_orientation:
+ * @plugin : a #XfcePanelPlugin
*
+ * Return the #GtkOrientation of the panel that the plugin is part of.
+ *
* Returns: the current #GtkOrientation of the panel.
**/
GtkOrientation
@@ -573,8 +581,8 @@
/**
- * _xfce_panel_plugin_remove_confirm
- * @plugin : an #XfcePanelPlugin
+ * _xfce_panel_plugin_remove_confirm:
+ * @plugin : a #XfcePanelPlugin
*
* Ask the plugin to be removed.
**/
@@ -619,8 +627,8 @@
/**
- * _xfce_panel_plugin_remove
- * @plugin : an #XfcePanelPlugin
+ * _xfce_panel_plugin_remove:
+ * @plugin : a #XfcePanelPlugin
*
* Remove the plugin from the panel.
**/
@@ -633,8 +641,8 @@
/**
- * xfce_panel_plugin_set_expand
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_set_expand:
+ * @plugin : a #XfcePanelPlugin
* @expand : whether to expand the plugin
*
* Sets whether to expand the plugin when the width of the panel increases.
@@ -649,8 +657,8 @@
/**
- * _xfce_panel_plugin_customize_panel
- * @plugin : an #XfcePanelPlugin
+ * _xfce_panel_plugin_customize_panel:
+ * @plugin : a #XfcePanelPlugin
*
* Ask the panel to show the settings dialog.
**/
@@ -663,8 +671,8 @@
/**
- * xfce_panel_plugin_customize_items
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_customize_items:
+ * @plugin : a #XfcePanelPlugin
*
* Ask the panel to show the settings dialog, with the 'Add Items' tab shown.
**/
@@ -677,8 +685,8 @@
/**
- * _xfce_panel_plugin_move
- * @plugin : an #XfcePanelPlugin
+ * _xfce_panel_plugin_move:
+ * @plugin : a #XfcePanelPlugin
*
* Ask the panel to start a move operation.
**/
@@ -691,8 +699,8 @@
/**
- * xfce_panel_plugin_register_menu
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_register_menu:
+ * @plugin : a #XfcePanelPlugin
* @menu : a #GtkMenu that will be opened
*
* Register an open menu. This will make sure the panel will properly handle
@@ -708,8 +716,8 @@
/**
- * xfce_panel_plugin_focus_widget
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_focus_widget:
+ * @plugin : a #XfcePanelPlugin
* @widget : widget to focus
*
* Grab the focus on @widget. Asks the panel to allow focus on its items and
@@ -727,8 +735,8 @@
/**
- * xfce_panel_plugin_set_panel_hidden
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_set_panel_hidden:
+ * @plugin : a #XfcePanelPlugin
* @hidden : %FALSE to unhide, %TRUE to hide the panel
*
* Ask the panel to hide or unhide. This only has effect when autohide is
@@ -782,12 +790,6 @@
-/**
- * _xfce_panel_plugin_create_menu
- * @plugin : an #XfcePanelPlugin
- *
- * This should only be called by implementors of the panel plugin interface.
- **/
void
_xfce_panel_plugin_create_menu (XfcePanelPlugin *plugin)
{
@@ -922,8 +924,8 @@
/**
- * _xfce_panel_plugin_popup_menu
- * @plugin : an #XfcePanelPlugin
+ * _xfce_panel_plugin_popup_menu:
+ * @plugin : a #XfcePanelPlugin
*
* Shows the right-click menu.
**/
@@ -998,8 +1000,8 @@
/**
- * xfce_panel_plugin_add_action_widget
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_add_action_widget:
+ * @plugin : a #XfcePanelPlugin
* @widget : a #GtkWidget that receives mouse events
*
* Attach the plugin menu to this widget. Plugin writers should call this
@@ -1024,8 +1026,8 @@
/**
- * xfce_panel_plugin_menu_insert_item
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_menu_insert_item:
+ * @plugin : a #XfcePanelPlugin
* @item : the menu item to add
*
* Insert custom menu item.
@@ -1057,8 +1059,8 @@
/**
- * xfce_panel_plugin_menu_show_about
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_menu_show_about:
+ * @plugin : a #XfcePanelPlugin
*
* Show the 'About' item in the menu. Clicking on the menu item will emit
* the "about" signal.
@@ -1086,8 +1088,8 @@
/**
- * xfce_panel_plugin_menu_show_configure
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_menu_show_configure:
+ * @plugin : a #XfcePanelPlugin
*
* Show the 'Configure' item in the menu. Clicking on the menu item will emit
* the "configure-plugin" signal.
@@ -1119,8 +1121,8 @@
/**
- * xfce_panel_plugin_block_menu
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_block_menu:
+ * @plugin : a #XfcePanelPlugin
*
* Temporarily block the menu from being shown. This can be used by plugin
* writers when the configuration dialog is active.
@@ -1139,8 +1141,8 @@
/**
- * xfce_panel_plugin_unblock_menu
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_unblock_menu:
+ * @plugin : a #XfcePanelPlugin
*
* Don't block the menu from being shown.
*
@@ -1155,8 +1157,8 @@
/**
- * xfce_panel_plugin_lookup_rc_file
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_lookup_rc_file:
+ * @plugin : a #XfcePanelPlugin
*
* Looks up unique filename associated with @plugin in standard configuration
* locations. Uses xfce_resource_lookup() ginternally.
@@ -1188,8 +1190,8 @@
/**
- * xfce_panel_plugin_save_location
- * @plugin : an #XfcePanelPlugin
+ * xfce_panel_plugin_save_location:
+ * @plugin : a #XfcePanelPlugin
* @create : whether the file should be created
*
* Unique file location that can be used to store configuration information.
@@ -1222,13 +1224,6 @@
-/**
- * _xfce_panel_plugin_set_sensitive
- * @plugin : an #XfcePanelPlugin
- * @sensitive : whether to make the widget sensitive
- *
- * This should only be called by plugin implementations.
- **/
void
_xfce_panel_plugin_set_sensitive (XfcePanelPlugin *plugin,
gboolean sensitive)
Modified: xfce4-panel/trunk/plugins/clock/clock-analog.c
===================================================================
--- xfce4-panel/trunk/plugins/clock/clock-analog.c 2007-07-09 13:01:57 UTC (rev 25904)
+++ xfce4-panel/trunk/plugins/clock/clock-analog.c 2007-07-09 19:51:58 UTC (rev 25905)
@@ -35,7 +35,7 @@
#include "clock-analog.h"
#ifndef M_PI
-#define M_PI 3.141592654
+#define M_PI 3.14159265358979323846
#endif
#define CLOCK_SCALE 0.1
More information about the Xfce4-commits
mailing list