aboutsummaryrefslogtreecommitdiffstats
path: root/doc/reference
diff options
context:
space:
mode:
authorAdam Hooper <adamh@src.gnome.org>2004-03-30 00:36:40 +0800
committerAdam Hooper <adamh@src.gnome.org>2004-03-30 00:36:40 +0800
commit3a4910096aaf0a3aa807f1c5c54178a11443bf50 (patch)
tree02cfda6ee8261c5f9b9a8defdec15deac6c96783 /doc/reference
parent9fb5753f5269d9ce94a0815660dfc907c6d96cdf (diff)
downloadgsoc2013-epiphany-3a4910096aaf0a3aa807f1c5c54178a11443bf50.tar
gsoc2013-epiphany-3a4910096aaf0a3aa807f1c5c54178a11443bf50.tar.gz
gsoc2013-epiphany-3a4910096aaf0a3aa807f1c5c54178a11443bf50.tar.bz2
gsoc2013-epiphany-3a4910096aaf0a3aa807f1c5c54178a11443bf50.tar.lz
gsoc2013-epiphany-3a4910096aaf0a3aa807f1c5c54178a11443bf50.tar.xz
gsoc2013-epiphany-3a4910096aaf0a3aa807f1c5c54178a11443bf50.tar.zst
gsoc2013-epiphany-3a4910096aaf0a3aa807f1c5c54178a11443bf50.zip
Documented EphyCommandManager
Diffstat (limited to 'doc/reference')
-rw-r--r--doc/reference/Makefile.am1
-rw-r--r--doc/reference/epiphany-docs.sgml1
-rw-r--r--doc/reference/epiphany-sections.txt16
-rw-r--r--doc/reference/tmpl/ephy-command-manager.sgml112
4 files changed, 129 insertions, 1 deletions
diff --git a/doc/reference/Makefile.am b/doc/reference/Makefile.am
index 0b0df505d..ff7bb9f9e 100644
--- a/doc/reference/Makefile.am
+++ b/doc/reference/Makefile.am
@@ -65,7 +65,6 @@ IGNORE_HFILES = \
ephy-zoom-action.h \
ephy-zoom-control.h \
downloader-view.h \
- ephy-command-manager.h \
ephy-download.h \
ephy-embed-dialog.h \
ephy-embed-event.h \
diff --git a/doc/reference/epiphany-docs.sgml b/doc/reference/epiphany-docs.sgml
index 1d399f151..9121ecf77 100644
--- a/doc/reference/epiphany-docs.sgml
+++ b/doc/reference/epiphany-docs.sgml
@@ -12,6 +12,7 @@
<xi:include href="xml/ephy-window.xml"/>
<xi:include href="xml/ephy-tab.xml"/>
<xi:include href="xml/ephy-embed.xml"/>
+ <xi:include href="xml/ephy-command-manager.xml"/>
<xi:include href="xml/ephy-embed-single.xml"/>
<xi:include href="xml/ephy-embed-persist.xml"/>
</chapter>
diff --git a/doc/reference/epiphany-sections.txt b/doc/reference/epiphany-sections.txt
index 398ef5c83..1ecc56bad 100644
--- a/doc/reference/epiphany-sections.txt
+++ b/doc/reference/epiphany-sections.txt
@@ -183,6 +183,22 @@ EPHY_IS_EMBED_PERSIST_CLASS
EPHY_EMBED_PERSIST_GET_CLASS
</SECTION>
+<SECTION>
+<FILE>ephy-command-manager</FILE>
+<TITLE>EphyCommandManager</TITLE>
+EphyCommandManager
+EphyCommandManagerIface
+ephy_command_manager_do_command
+ephy_command_manager_can_do_command
+<SUBSECTION Standard>
+EPHY_COMMAND_MANAGER
+EPHY_IS_COMMAND_MANAGER
+EPHY_TYPE_COMMAND_MANAGER
+ephy_command_manager_get_type
+EPHY_COMMAND_MANAGER_GET_IFACE
+EPHY_COMMAND_MANAGER_IFACE
+EPHY_IS_COMMAND_MANAGER_IFACE
+</SECTION>
diff --git a/doc/reference/tmpl/ephy-command-manager.sgml b/doc/reference/tmpl/ephy-command-manager.sgml
new file mode 100644
index 000000000..060d41615
--- /dev/null
+++ b/doc/reference/tmpl/ephy-command-manager.sgml
@@ -0,0 +1,112 @@
+<!-- ##### SECTION Title ##### -->
+EphyCommandManager
+
+<!-- ##### SECTION Short_Description ##### -->
+Performs commands, such as cut/copy/paste
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+An #EphyCommandManager is an interface to an #EphyEmbed which is used to perform
+commands, such as cut/copy/paste. To perform any command, use
+ephy_command_manager_do_command(). To test the availability of a command, use
+ephy_command_manager_can_do_command(). The availability of commands depends on
+the selection and actions previously performed in the #EphyEmbed. For instance,
+%cmd_copy is only available if text has been selected; %cmd_undo is only
+available if the user has a text input focused and has typed or erased some of
+its text.
+</para>
+<para>
+<example>
+<title>Copying selected text in an #EphyEmbed</title>
+<programlisting>#<![CDATA[include <ephy-embed.h>]]>
+#<![CDATA[include <ephy-command-manager.h>
+
+static void
+copy_selected_text (EphyEmbed *embed)
+{
+ EphyCommandManager *manager;
+
+ manager = EPHY_COMMAND_MANAGER (embed);
+ g_return_if_fail (EPHY_IS_COMMAND_MANAGER (manager));
+
+ if (!ephy_command_manager_can_do_command (manager, "cmd_copy")) return;
+
+ ephy_command_manager_do_command (manager, "cmd_copy");
+}]]>
+</programlisting>
+</example>
+</para>
+<para>
+The #EphyCommandManager interface can perform any command which is defined in
+Mozilla. However, for purposes of abstraction, only a certain subset of commands
+should be used:
+</para>
+<variablelist><title>Available Commands</title>
+<varlistentry><term>cmd_copy</term>
+<listitem><para>Copies selected text</para></listitem>
+</varlistentry>
+<varlistentry><term>cmd_cut</term>
+<listitem><para>Cuts selected text.</para></listitem>
+</varlistentry>
+<varlistentry><term>cmd_paste</term>
+<listitem><para>Pastes text from the clipboard (for example, into a text entry)
+</para></listitem>
+</varlistentry>
+<varlistentry><term>cmd_undo</term>
+<listitem><para>Undoes the last action (for example, typing text into a text
+entry</para></listitem>
+</varlistentry>
+<varlistentry><term>cmd_redo</term>
+<listitem><para>Redoes previously %undo<!-- -->ne actions (for example, in a
+text entry)</para></listitem>
+</varlistentry>
+</variablelist>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT EphyCommandManager ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT EphyCommandManagerIface ##### -->
+<para>
+
+</para>
+
+@base_iface:
+@do_command:
+@can_do_command:
+@command_changed:
+
+<!-- ##### FUNCTION ephy_command_manager_do_command ##### -->
+<para>
+
+</para>
+
+@manager:
+@command:
+
+
+<!-- ##### FUNCTION ephy_command_manager_can_do_command ##### -->
+<para>
+
+</para>
+
+@manager:
+@command:
+@Returns:
+
+
+<!-- ##### SIGNAL EphyCommandManager::command-changed ##### -->
+<para>
+
+</para>
+
+@ephycommandmanager: the object which received the signal.
+@arg1:
+