Codebase list amtk / 4d5eb3f
docs: write gradual-porting page Sébastien Wilmet 2 years ago
3 changed file(s) with 61 addition(s) and 0 deletion(s). Raw diff Collapse all Expand all
1212 </bookinfo>
1313
1414 <xi:include href="amtk-intro.xml"/>
15 <xi:include href="gradual-porting.xml"/>
1516
1617 <part id="api-reference">
1718 <title>Amtk API Reference</title>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
2 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
3 [
4 <!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
5 <!ENTITY % gtkdocentities SYSTEM "xml/gtkdocentities.ent">
6 %gtkdocentities;
7 ]>
8
9 <refentry id="gradual-porting">
10 <refmeta>
11 <refentrytitle>Gradual Porting</refentrytitle>
12 </refmeta>
13
14 <refnamediv>
15 <refname>Gradual Porting</refname>
16 <refpurpose>
17 Gradually porting away from <link linkend="GtkAction">GtkAction</link> and
18 <link linkend="GtkUIManager">GtkUIManager</link>.
19 </refpurpose>
20 </refnamediv>
21
22 <para>
23 Even if you don't want to use Amtk in the end, Amtk can help to gradually move
24 away from <link linkend="GtkAction">GtkAction</link> and
25 <link linkend="GtkUIManager">GtkUIManager</link>.
26 </para>
27
28 <refsect1>
29 <title>Moving gradually to <link linkend="GAction">GAction</link></title>
30 <para>
31 Amtk provides the following functions that can help:
32 </para>
33 <itemizedlist>
34 <listitem>
35 <para>
36 <link linkend="amtk-utils-bind-g-action-to-gtk-action">amtk_utils_bind_g_action_to_gtk_action()</link>
37 </para>
38 </listitem>
39 <listitem>
40 <para>
41 <link linkend="amtk-utils-create-gtk-action">amtk_utils_create_gtk_action()</link>
42 </para>
43 </listitem>
44 </itemizedlist>
45 </refsect1>
46
47 <refsect1>
48 <title>Moving gradually away from <link linkend="GtkUIManager">GtkUIManager</link></title>
49 <para>
50 For example if you have already ported a submenu, but not the whole menu,
51 you can use the
52 <link linkend="gtk-ui-manager-get-widget">gtk_ui_manager_get_widget()</link>
53 function to get a <link linkend="GtkMenuItem">GtkMenuItem</link>, and then
54 set the submenu with
55 <link linkend="gtk-menu-item-set-submenu">gtk_menu_item_set_submenu()</link>.
56 </para>
57 </refsect1>
58 </refentry>
2929 ],
3030 content_files: [
3131 'amtk-intro.xml',
32 'gradual-porting.xml',
3233 ],
3334 install: true
3435 )