[gtk+] Add a migration chapter for label links
- From: Matthias Clasen <matthiasc src gnome org>
- To: svn-commits-list gnome org
- Subject: [gtk+] Add a migration chapter for label links
- Date: Mon, 11 May 2009 02:09:00 -0400 (EDT)
commit 2f60e18c700dca53ef2b64085880ae3c71f50f5f
Author: Matthias Clasen <mclasen redhat com>
Date: Mon May 11 02:08:32 2009 -0400
Add a migration chapter for label links
---
docs/reference/gtk/Makefile.am | 11 +++++----
docs/reference/gtk/gtk-docs.sgml | 5 ++++
docs/reference/gtk/gtk-sections.txt | 1 +
docs/reference/gtk/migrating-GtkLabel-links.sgml | 26 ++++++++++++++++++++++
4 files changed, 38 insertions(+), 5 deletions(-)
diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am
index d7ffd71..72aed73 100644
--- a/docs/reference/gtk/Makefile.am
+++ b/docs/reference/gtk/Makefile.am
@@ -129,17 +129,18 @@ content_files = \
drawing-model.xml \
glossary.xml \
migrating-checklist.sgml \
+ migrating-GtkAboutDialog.sgml \
migrating-GtkAction.sgml \
+ migrating-GtkAssistant.sgml \
+ migrating-GtkBuilder.sgml \
+ migrating-GtkColorButton.sgml \
migrating-GtkComboBox.sgml \
migrating-GtkEntry-icons.sgml \
migrating-GtkFileChooser.sgml \
migrating-GtkIconView.sgml \
- migrating-GtkAboutDialog.sgml \
- migrating-GtkColorButton.sgml \
- migrating-GtkAssistant.sgml \
- migrating-GtkRecentChooser.sgml \
+ migrating-GtkLabel-links.sgml \
migrating-GtkLinkButton.sgml \
- migrating-GtkBuilder.sgml \
+ migrating-GtkRecentChooser.sgml \
migrating-GtkTooltip.sgml \
objects_grouped.sgml \
osx.sgml \
diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml
index 9701510..0d27e5f 100644
--- a/docs/reference/gtk/gtk-docs.sgml
+++ b/docs/reference/gtk/gtk-docs.sgml
@@ -432,6 +432,7 @@ that is, GUI components such as #GtkButton or #GtkTextView.
<xi:include href="xml/migrating-GtkBuilder.sgml" />
<xi:include href="xml/migrating-GtkTooltip.sgml" />
<xi:include href="xml/migrating-GtkEntry-icons.sgml" />
+ <xi:include href="xml/migrating-GtkLabel-links.sgml" />
</part>
<part>
@@ -483,4 +484,8 @@ that is, GUI components such as #GtkButton or #GtkTextView.
<title>Index of new symbols in 2.16</title>
<xi:include href="xml/api-index-2.16.xml"><xi:fallback /></xi:include>
</index>
+ <index id="api-index-2-18" role="2.18">
+ <title>Index of new symbols in 2.18</title>
+ <xi:include href="xml/api-index-2.18.xml"><xi:fallback /></xi:include>
+ </index>
</book>
diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt
index 72051c2..d300ea6 100644
--- a/docs/reference/gtk/gtk-sections.txt
+++ b/docs/reference/gtk/gtk-sections.txt
@@ -2274,6 +2274,7 @@ gtk_label_set_use_markup
gtk_label_set_use_underline
gtk_label_set_single_line_mode
gtk_label_set_angle
+gtk_label_get_current_uri
<SUBSECTION Standard>
GTK_LABEL
GTK_IS_LABEL
diff --git a/docs/reference/gtk/migrating-GtkLabel-links.sgml b/docs/reference/gtk/migrating-GtkLabel-links.sgml
new file mode 100644
index 0000000..3a94694
--- /dev/null
+++ b/docs/reference/gtk/migrating-GtkLabel-links.sgml
@@ -0,0 +1,26 @@
+<?xml version="1.0"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<chapter id="gtk-migrating-label-links">
+
+ <title>Migrating from SexyUrlLabel to GtkLabel</title>
+
+ <para>
+ GTK+ 2.18 supports showing links inside a #GtkLabel, similar to
+ SexyUrlLabel. Porting from SexyUrlLabel to GtkLabel is relatively
+ straightforward. GtkLabel accepts links in the markup using the
+ same HTML <tag>a</tag> notation that SexyUrlLabel uses. In addition
+ to the href attribute, GtkLabel accepts a title attribute that
+ is displayed as a tooltip on the link. Instead of
+ sexy_url_label_set_markup(), just call gtk_label_set_markup().
+ </para>
+ <para>
+ One difference between the two APIs is that the ::url-activated signal
+ from SexyUrlLabel has been replaced by the #GtkLabel::activate-link
+ signal. The activated URI is no longer passed as an argument to the
+ signal handler. Instead, call gtk_label_get_current_uri() to obtain it.
+ However, the need for connecting to this signal is greatly reduced,
+ since GtkLabel has a default handler that calls gtk_show_uri().
+ </para>
+</chapter>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]