From c7bbe2a9f6ca0b86eb53f2824a7e1c9bc519d590 Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Tue, 19 May 2015 13:14:05 +0100 Subject: [PATCH] Remove the separate Cally API reference --- .gitignore | 13 -- configure.ac | 2 - doc/reference/cally/Makefile.am | 49 ------- doc/reference/cally/cally-docs.xml.in | 145 -------------------- doc/reference/cally/cally-overview.xml | 74 ----------- doc/reference/cally/cally-sections.txt | 176 ------------------------- doc/reference/cally/cally.types | 9 -- 7 files changed, 468 deletions(-) delete mode 100644 doc/reference/cally/Makefile.am delete mode 100644 doc/reference/cally/cally-docs.xml.in delete mode 100644 doc/reference/cally/cally-overview.xml delete mode 100644 doc/reference/cally/cally-sections.txt delete mode 100644 doc/reference/cally/cally.types diff --git a/.gitignore b/.gitignore index 7f61f0f96..93406696e 100644 --- a/.gitignore +++ b/.gitignore @@ -61,19 +61,6 @@ doc/reference/clutter/*.stamp doc/reference/clutter/*.bak doc/reference/clutter/*.log doc/reference/clutter/gtkdoc-check.* -doc/reference/cally/cally-*.txt -!/doc/reference/cally/cally-sections.txt -doc/reference/cally/html -doc/reference/cally/tmpl -doc/reference/cally/xml -doc/reference/cally/cally.args -doc/reference/cally/cally.hierarchy -doc/reference/cally/cally.interfaces -doc/reference/cally/cally.prerequisites -doc/reference/cally/cally.signals -doc/reference/cally/cally-docs.xml -doc/reference/cally/*.stamp -doc/reference/cally/*.bak gtk-doc.make install-sh libtool diff --git a/configure.ac b/configure.ac index b7f0d1c39..66f59e25a 100644 --- a/configure.ac +++ b/configure.ac @@ -1199,8 +1199,6 @@ AC_CONFIG_FILES([ doc/reference/Makefile doc/reference/clutter/Makefile doc/reference/clutter/clutter-docs.xml - doc/reference/cally/Makefile - doc/reference/cally/cally-docs.xml doc/common/Makefile doc/cookbook/Makefile doc/cookbook/clutter-cookbook.xml diff --git a/doc/reference/cally/Makefile.am b/doc/reference/cally/Makefile.am deleted file mode 100644 index 3777e84d9..000000000 --- a/doc/reference/cally/Makefile.am +++ /dev/null @@ -1,49 +0,0 @@ -DOC_MODULE = cally -DOC_MAIN_SGML_FILE =$(DOC_MODULE)-docs.xml -DOC_SOURCE_DIR = $(top_srcdir)/clutter/cally $(top_builddir)/clutter/cally - -SCANGOBJ_OPTIONS = --type-init-func="clutter_base_init()" -SCAN_OPTIONS = -MKDB_OPTIONS = --output-format=xml --name-space=cally -MKTMPL_OPTIONS = -FIXXREF_OPTIONS = \ - --extra-dir=../clutter/html \ - --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/glib \ - --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gobject \ - --extra-dir=$(CAIRO_PREFIX)/share/gtk-doc/html/cairo \ - --extra-dir=$(PANGO_PREFIX)/share/gtk-doc/html/pango \ - --extra-dir=$(COGL_PREFIX)/share/gtk-doc/html/cogl - -HFILE_GLOB = $(top_srcdir)/clutter/cally/*.h -CFILE_GLOB = $(top_srcdir)/clutter/cally/*.c - -IGNORE_HFILES = \ - cally-actor-private.h \ - cally.h - -EXTRA_HFILES = - -HTML_IMAGES= - -content_files= \ - cally-overview.xml - -expand_content_files= \ - cally-overview.xml - -AM_CPPFLAGS = \ - -I$(top_srcdir) \ - -I$(top_srcdir)/clutter \ - -I$(top_builddir) \ - -I$(top_builddir)/clutter - -AM_CFLAGS = $(CLUTTER_CFLAGS) - -GTKDOC_LIBS = $(top_builddir)/clutter/libclutter-@CLUTTER_API_VERSION@.la $(CLUTTER_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 += diff --git a/doc/reference/cally/cally-docs.xml.in b/doc/reference/cally/cally-docs.xml.in deleted file mode 100644 index 65f6a878e..000000000 --- a/doc/reference/cally/cally-docs.xml.in +++ /dev/null @@ -1,145 +0,0 @@ - - -]> - - - - Cally Reference Manual - for Clutter &version; - - - 2008 - 2009 - 2010 - Igalia S.L. - - - - - 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, no Front-Cover Texts, and no Back-Cover - Texts. You may obtain a copy of the GNU Free - Documentation License from the Free Software - Foundation by visiting their Web site or by writing - to: - -
- The Free Software Foundation, Inc., - 59 Temple Place - Suite 330, - Boston, MA 02111-1307, - USA -
- - - - - - - - Cally Reference - - - Base Classes - - - - - - - - - - - - Utility API - - - - - - - - - - - Cally Actors and Objects - - - Object Hierarchy - - - - - - Object Index - - - - - - Annotations Glossary - - - - - - Index of all symbols - - - - - Index of deprecated symbols - - - - - Index of new symbols in 1.4 - - - - - Index of new symbols in 1.6 - - - - - License - - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Library General - Public License as published by the Free Software - Foundation; either version 2 of the License, or (at your option) - any later version. - - - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU Library General Public License for - more details. - - - - You may obtain a copy of the GNU Library General - Public License from the Free Software Foundation by - visiting their Web - site or by writing to: - -
- Free Software Foundation, Inc. - 59 Temple Place - Suite 330 - Boston, MA 02111-1307 - USA -
- - - - diff --git a/doc/reference/cally/cally-overview.xml b/doc/reference/cally/cally-overview.xml deleted file mode 100644 index 4be86fbab..000000000 --- a/doc/reference/cally/cally-overview.xml +++ /dev/null @@ -1,74 +0,0 @@ - - - - Alejandro - Piñeiro Iglesias - -
- apinheiro@igalia.com -
- - - - - Overview - - - - Cally (Clutter Accessibility Implementation Library) is the - Clutter implementation of the ATK interfaces. You can see as the - Clutter equivalent of GAIL, which provides accessibility support - for GTK+ and other GNOME related libraries. - - This implementation expose Clutter actors to accessibility - tools like Orca. This allows not only writing accessible user - interfaces, but also allows testing and verification frameworks - based on accessibility technologies to inspect and test a Clutter - scene graph. - - This reference manual defines the different APIs defined in - Cally. Anyway take into account that the most common use of case - Cally is transparent to the user, as the different accessibility - tools are intended to use the abstract ATK interfaces, and *not - directly* Cally, so this tools can communicate with applications - using different toolkits, like GTK+, Java, Clutter, etc. - - The purpose of this reference is allow to extend Cally - functionality in any Clutter-based widget toolkit. Clutter is more - low-level that other toolkits like GTK+, and some toolkits have - started to appear based on Clutter: MX, Shell Toolkit, Candies, - Glitter, etc. This means that it is really likely that these - libraries will require extra accessibility support. - - GAIL used a different approach, being a almost-pure-opaque - implementation of the ATK interfaces. So you can't extend it - directly. You need to use GObject and ATK mechanisms, like - run-time anonymous inheritance, to extend it. Although valid to - some custom cases, it showed to be really problematic and hacky in - wider approaches, like HAIL(Hildon Accessibility Implementation - Library). As explained, Clutter is more likely to be extended, so - these issues would arise sooner. - - Part of the accessibility support is implemented on Clutter, - like the initialization code, and the method to obtain the - accessibility object for each Clutter object. In the same way, to - make it easier, and to allow access to Clutter object private - data, it would be really likely that the accessibility support - would be implemented directly on some Clutter objects - - Check the next clutter methods for more information: - - - clutter_actor_get_accessible() - Virtual method to obtain the accessibility object of a - clutter actor - - - clutter_get_accessibility_enabled() - Method to check if accessibility is enabled. - - - - - - diff --git a/doc/reference/cally/cally-sections.txt b/doc/reference/cally/cally-sections.txt deleted file mode 100644 index 53624c011..000000000 --- a/doc/reference/cally/cally-sections.txt +++ /dev/null @@ -1,176 +0,0 @@ -
-cally-stage -CallyStage -CallyStage -CallyStageClass -cally_stage_new - -CALLY_STAGE -CALLY_IS_STAGE -CALLY_TYPE_STAGE -CALLY_STAGE_CLASS -CALLY_IS_STAGE_CLASS -CALLY_STAGE_GET_CLASS - -CallyStagePrivate -cally_stage_get_type -
- -
-cally-clone -CallyClone -CallyClone -CallyCloneClass -cally_clone_new - -CALLY_CLONE -CALLY_IS_CLONE -CALLY_TYPE_CLONE -CALLY_CLONE_CLASS -CALLY_IS_CLONE_CLASS -CALLY_CLONE_GET_CLASS - -CallyClonePrivate -cally_clone_get_type -
- -
-cally-actor -CallyActor -CallyActor -CallyActorClass -CallyActionFunc -CallyActionCallback -cally_actor_new -cally_actor_add_action -cally_actor_add_action_full -cally_actor_remove_action -cally_actor_remove_action_by_name - -CALLY_ACTOR -CALLY_IS_ACTOR -CALLY_TYPE_ACTOR -CALLY_ACTOR_CLASS -CALLY_IS_ACTOR_CLASS -CALLY_ACTOR_GET_CLASS - -CallyActorPrivate -cally_actor_get_type -
- -
-cally-text -CallyText -CallyText -CallyTextClass -cally_text_new - -CALLY_TEXT -CALLY_IS_TEXT -CALLY_TYPE_TEXT -CALLY_TEXT_CLASS -CALLY_IS_TEXT_CLASS -CALLY_TEXT_GET_CLASS - -CallyTextPrivate -cally_text_get_type -
- -
-cally-util -CallyUtil -CallyUtil -CallyUtilClass - -CALLY_UTIL -CALLY_IS_UTIL -CALLY_TYPE_UTIL -CALLY_UTIL_CLASS -CALLY_IS_UTIL_CLASS -CALLY_UTIL_GET_CLASS - -CallyUtilPrivate -cally_util_get_type -
- -
-cally-texture -CallyTexture -CallyTexture -CallyTextureClass -cally_texture_new - -CALLY_TEXTURE -CALLY_IS_TEXTURE -CALLY_TYPE_TEXTURE -CALLY_TEXTURE_CLASS -CALLY_IS_TEXTURE_CLASS -CALLY_TEXTURE_GET_CLASS - -CallyTexturePrivate -cally_texture_get_type -
- -
-cally-root -CallyRoot -CallyRoot -CallyRootClass -cally_root_new - -CALLY_ROOT -CALLY_IS_ROOT -CALLY_TYPE_ROOT -CALLY_ROOT_CLASS -CALLY_IS_ROOT_CLASS -CALLY_ROOT_GET_CLASS - -CallyRootPrivate -cally_root_get_type -
- -
-cally-group -CallyGroup -CallyGroup -CallyGroupClass -cally_group_new - -CALLY_GROUP -CALLY_IS_GROUP -CALLY_TYPE_GROUP -CALLY_GROUP_CLASS -CALLY_IS_GROUP_CLASS -CALLY_GROUP_GET_CLASS - -CallyGroupPrivate -cally_group_get_type -
- -
-cally-rectangle -CallyRectangle -CallyRectangle -CallyRectangleClass -cally_rectangle_new - -CALLY_RECTANGLE -CALLY_IS_RECTANGLE -CALLY_TYPE_RECTANGLE -CALLY_RECTANGLE_CLASS -CALLY_IS_RECTANGLE_CLASS -CALLY_RECTANGLE_GET_CLASS - -CallyRectanglePrivate -cally_rectangle_get_type -
- -
-cally -General API -cally_get_cally_initialized -cally_accessibility_init - -CALLY_ACCESSIBLE_FACTORY -CALLY_ACTOR_SET_FACTORY -
diff --git a/doc/reference/cally/cally.types b/doc/reference/cally/cally.types deleted file mode 100644 index 085efc2bb..000000000 --- a/doc/reference/cally/cally.types +++ /dev/null @@ -1,9 +0,0 @@ -cally_actor_get_type -cally_clone_get_type -cally_group_get_type -cally_rectangle_get_type -cally_root_get_type -cally_stage_get_type -cally_text_get_type -cally_texture_get_type -cally_util_get_type