[Xfce4-commits] <exo:exo-helper-overhaul> Update docs.

Nick Schermer nick at xfce.org
Wed Aug 26 18:44:08 CEST 2009


Updating branch refs/heads/exo-helper-overhaul
         to 41b0c2a5d33f51195f0a01d9154b099f0a9cdc61 (commit)
       from d28a218994ae1b7ca3553a864a1ab28312141ab2 (commit)

commit 41b0c2a5d33f51195f0a01d9154b099f0a9cdc61
Author: Nick Schermer <nick at xfce.org>
Date:   Wed Aug 26 18:42:01 2009 +0200

    Update docs.

 docs/reference/exo-docs.sgml                |    2 -
 docs/reference/exo-sections.txt             |   11 +----
 docs/reference/tmpl/exo-execute.sgml        |    7 +--
 docs/reference/tmpl/exo-gtk-extensions.sgml |    8 +++
 docs/reference/tmpl/exo-url.sgml            |   76 ---------------------------
 5 files changed, 12 insertions(+), 92 deletions(-)

diff --git a/docs/reference/exo-docs.sgml b/docs/reference/exo-docs.sgml
index 144d735..1483285 100644
--- a/docs/reference/exo-docs.sgml
+++ b/docs/reference/exo-docs.sgml
@@ -22,7 +22,6 @@
 <!ENTITY exo-execute SYSTEM "xml/exo-execute.xml">
 <!ENTITY exo-mount-point SYSTEM "xml/exo-mount-point.xml">
 <!ENTITY exo-string SYSTEM "xml/exo-string.xml">
-<!ENTITY exo-url SYSTEM "xml/exo-url.xml">
 <!ENTITY exo-utils SYSTEM "xml/exo-utils.xml">
 <!ENTITY exo-hal SYSTEM "xml/exo-hal.xml">
 <!ENTITY exo-xsession-client SYSTEM "xml/exo-xsession-client.xml">
@@ -301,7 +300,6 @@
     &exo-execute;
     &exo-mount-point;
     &exo-string;
-    &exo-url;
     &exo-utils;
     &exo-hal;
     &exo-xsession-client;
diff --git a/docs/reference/exo-sections.txt b/docs/reference/exo-sections.txt
index 4624b34..95f96d2 100644
--- a/docs/reference/exo-sections.txt
+++ b/docs/reference/exo-sections.txt
@@ -391,6 +391,7 @@ exo_g_value_transform_negate
 <TITLE>Extensions to Gtk</TITLE>
 exo_gtk_object_destroy_later
 exo_gtk_file_chooser_add_thumbnail_preview
+exo_gtk_url_about_dialog_hook
 </SECTION>
 
 <SECTION>
@@ -458,16 +459,6 @@ I_
 </SECTION>
 
 <SECTION>
-<FILE>exo-url</FILE>
-<TITLE>Opening URLs</TITLE>
-ExoUrlError
-EXO_URL_ERROR
-exo_url_show
-exo_url_show_on_screen
-exo_url_about_dialog_hook
-</SECTION>
-
-<SECTION>
 <FILE>exo-utils</FILE>
 <TITLE>Miscellaneous Utility Functions</TITLE>
 exo_noop
diff --git a/docs/reference/tmpl/exo-execute.sgml b/docs/reference/tmpl/exo-execute.sgml
index 41c01d6..07bc030 100644
--- a/docs/reference/tmpl/exo-execute.sgml
+++ b/docs/reference/tmpl/exo-execute.sgml
@@ -15,10 +15,9 @@ Execute preferred applications
 </para>
 <para>
   On the other hand if you need to display an URL (i.e. you want to point
-  the user to the website of your application), you should use exo_url_show()
-  or exo_url_show_on_screen() from the <link
-  linkend="exo-Opening-URLs">exo-url</link> module instead, as they will
-  try to automatically determine the appropriate viewer for a given URL.
+  the user to the website of your application), you should use gtk_show_uri()
+  instead, as it will try to automatically determine the appropriate
+  viewer for a given URI.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/tmpl/exo-gtk-extensions.sgml b/docs/reference/tmpl/exo-gtk-extensions.sgml
index efe8e54..8ac7b30 100644
--- a/docs/reference/tmpl/exo-gtk-extensions.sgml
+++ b/docs/reference/tmpl/exo-gtk-extensions.sgml
@@ -39,3 +39,11 @@ Stable
 @chooser: 
 
 
+<!-- ##### FUNCTION exo_gtk_url_about_dialog_hook ##### -->
+<para>
+
+</para>
+
+ at about_dialog:
+ at link:
+ at user_data:
diff --git a/docs/reference/tmpl/exo-url.sgml b/docs/reference/tmpl/exo-url.sgml
deleted file mode 100644
index 02f91c0..0000000
--- a/docs/reference/tmpl/exo-url.sgml
+++ /dev/null
@@ -1,76 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Opening URLs
-
-<!-- ##### SECTION Short_Description ##### -->
-Display URLs using appropriate viewers
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-  Xfce users can configure which applications they wish to use for certain task,
-  for example they can select their preferred web browser and mail reader from
-  the <guilabel>Preferred Applications</guilabel> dialog. This module provides a
-  means for applications to display an URL without having to worry about which
-  viewer is going to ultimately handle the job.
-</para>
-<para>
-  One of the most popular use cases for this module is to provide the ability to
-  open links from a <link linkend="GtkAboutDialog">GtkAboutDialog</link>. Therefore
-  a convenience hook is provided for this use case, see the documentation of
-  exo_url_about_dialog_hook() for details.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-  <link linkend="exo-Executing-Applications">Executing Applications</link>
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-Stable
-
-<!-- ##### ENUM ExoUrlError ##### -->
-<para>
-
-</para>
-
- at EXO_URL_ERROR_NOT_SUPPORTED: 
-
-<!-- ##### MACRO EXO_URL_ERROR ##### -->
-<para>
-  The domain of errors raised by this module.
-</para>
-
-
-
-<!-- ##### FUNCTION exo_url_show ##### -->
-<para>
-
-</para>
-
- at url: 
- at envp: 
- at error: 
- at Returns: 
-
-
-<!-- ##### FUNCTION exo_url_show_on_screen ##### -->
-<para>
-
-</para>
-
- at url: 
- at envp: 
- at screen: 
- at error: 
- at Returns: 
-
-
-<!-- ##### FUNCTION exo_url_about_dialog_hook ##### -->
-<para>
-
-</para>
-
- at about_dialog: 
- at link: 
- at user_data: 
-
-



More information about the Xfce4-commits mailing list