ATK

ATK (Accessibility Toolkit) is an open source and free comand-line software that has been designed from the ground up to act as an accessibility library for the GNOME desktop environment.

Included compoenents

It comprises of a collection of accessibility interfaces that are implemented by various other applications and toolkits. You can use the ATK interfaces to allow accessibility tools to have full control over running apps.

The AtkNoOpObjectFactory, AtkObjectFactory, AtkRegistry and Versioning macros utilities are includes, as well as the AtkGObjectAccessible, AtkHyperlink, AtkNoOpObject, AtkPlug and AtkSocket custom accessible objects.

Additionally, it includes the AtkObject base accessibility object, AtkUtil for toolkit and event support, AtkRange, AtkRelation, AtkRelationSet, AtkState and AtkStateSet basic accessible data types, and a wide range of ATK Interfaces.

Getting started with ATK

To configure ATK, run the ./configure script, then 'make' and 'make install'. If you are installing into a location where you don't have write permissions, you'll have to become root before running 'make install'.

General information about building ATK and related libraries can be found at http://developer.gnome.org/doc/API/2.0/gtk/gtk-building.html. To compile a CVS version of atk on your system, you will need to take several steps to setup the tree for compilation.

You can do all these steps at once by running the “cvsroot/atk# ./autogen.sh” command, without quotes. Basically this does the following for you ‘cvsroot/atk# aclocal; automake; autoconf’. The aforementioned commands create the ‘configure’ script, which can be run in cvsroot/atk to create all the Makefiles.

Before running autogen.sh or configure, make sure you have libtool in your path. Note that autogen.sh runs configure for you. If you wish to pass options like --prefix=/usr to configure you can give those options to autogen.sh and they will be passed on to configure.

What is new in this release:

• Add ScrollTo and ScrollToPoint methods to AtkComponent
• Build:
• Require a more recent version fo Meson, 0.46.0
• Misc:
• Documentation, introspection, and versioning fixes

What is new in version :

• Build: meson on Windows, tracked by Bug 785802 (not fully fixed yet):
• Force-include msvc_recommended_pragmas.h on MSVC
• tests: Fix build on pre-C99
• meson: Build .rc file on Windows
• Translations
• Ask Hjorth Larsen (da)

What is new in version 2.26.0:

• Build: meson on Windows, tracked by Bug 785802 (not fully fixed yet):
• Force-include msvc_recommended_pragmas.h on MSVC
• tests: Fix build on pre-C99
• meson: Build .rc file on Windows
• Translations
• Ask Hjorth Larsen (da)

What is new in version 2.25.2:

• Bugfixing:
• Bug 781715: Crash under atk_gobject_accessible_dispose()
• Build (general/autotools):
• Add ATK_UNAVAILABLE macro
• Use template files for the ATK enumerations
• Convert atkversion.h.in to UTF-8 encoding
• Include the marshallers header, not the source
• Add buildir to the docs directories
• Update deprecation warnings symbols
• Simplify GObject dependency discovery
• Build (meson):
• Bug 782871: Add meson build system
• Dist the Meson files
• Use the appropriate soversion
• Use the appropriate GETTEXT_PACKAGE
• Install atk.h
• Only depend on generated header
• Build (win32):
• win32: Fix replacing items in files with UTF-8 content
• Cleaning:
• Remove atk.spec.in
• Remove uninstalled pkg-config file
• Remove unused script for bundling ATK on Windows
• Remove ChangeLog
• Remove local introspection.m4
• Docs:
• Modernise the API reference:
• Use XInclude
• Stop using SGML mode with XML files
• Drop version.xml and use the gtk-doc package entities
• Update the README mentioning Meson, Ninja, and cleaning a little
• Remove empty overrides file
• Gobject introspection:
• Mark unbindable functions as 'skip
• Misc:
• Update git ignore file
• New Relations and Roles:
• Bug 748384: Add ATK_ROLE_FOOTNOTE
• Bug 781587: Add error-message, error-for, details and details-for-relation
• Translation support:
• Update po/Makevars (copyright and bug address)
• Translations:
• Yuras Shumovich (be)

What is new in version 2.24.0:

• Build, MSVC:
• Support Visual Studio 2017
• Translations:
• Ask Hjorth Larsen (da), Jordi Mas (ca)

What is new in version 2.23.4:

• Build, MSVC:
• Remove atk-install.props's on re-generation
• Makefile.msvcproj, Makefile-newvs.am: Update from GLib
• Move files to win32
• Docs:
• Fix typo
• Bug 772236: change id of the atkobject chapter needed case-insensitive filesystems
• Misc:
• Use Unicode apostrophe in a translatable string
• Contributors:
• Murray Cumming, Piotr Drag, Alejandro Pineiro Iglesias,
• Translations:
• gogo (hr), Jordi Mas (ca), Fabio Tomat (fur)

What is new in version 2.22.0:

• Add more options to XGETTEXT_OPTIONS in po/Makevars
• Translations:
• Piotr Drag (po), David King (en_GB)

What is new in version 2.20.0 / 2.22.0 Beta:

• Bug 764883: Add some missing argument (out) annotations
• Add Language headers to po files
• MSVC/win32:
• MSVC Builds: Add a Common Autotools Module for Introspection (Bug 764983)
• MSVC Builds: Generate the Introspection Build Commands (Bug 764983)
• Clean up atk-introspection-msvc.mak
• Visual Studio builds: Include version info in property sheets
• Visual Studio builds: Generate atk.pc
• Visual Studio 2008 builds: Ensure pc file is generated before "install"
• Visual Studio builds: Make .pc generation more flexible
• build/win32/pc_base.py: Allow custom options
• build/win32/atkpc.py: Fix dependent package string
• Translations:
• GNOME Translation Robot (gd), Cedric Valmary (oc)

What is new in version 2.16.0 / 2.18 Beta 1:

• Documentation:
• Replace mentions of 'state-changed' with 'state-change'.
• Fixed some tiny typos
• Build/win32 improvements:
• Use Pattern Rules on build/Makefile-newvs.am
• Tidying and cleaning .vcxproj.filters generation
• Fixes Bug 748176: out-of-tree distcheck fails in build/win32
• Removed GCC requirement
• "install" Projects renamed to "atk-install"
• Misc: set proper file permission to source files
• Translations:
• Pedro Albuquerque (pt), Daniel Martinez (an)

What is new in version 2.16.0:

• Bug 746459: Fix a couple of GTK-Doc comment blocks
• Visual Studio support
• Speed Up Release Builds
• Fix and improve .pdb Generation.
• "Install" .pdb Files
• Translations:
• Josef Andersson (sv), Jiri GrA¶nroos (fi), Baurzhan Muftakhidinov (kk), Samir Ribic (bs), Zahari Yurukov (bg)

What is new in version 2.15.4:

• AtkRole:
• Bug 742806: Add new roles for fractions, roots, subscripts, and superscripts

What is new in version 2.15.3:

• AtkState:
• Bug 665598: Add ATK_STATE_READ_ONLY
• Bugfixing:
• Unref STATE_TYPE class ref after using it at state_type_get_name
• AtkTable: Added missing ":" on one gi annotation
• Translations:
• Muhammet Kara (tr)

What is new in version 2.15.2:

• AtkState:
• Bug 739981: Add ATK_ROLE_STATIC and clarify ATK_ROLE_TEXT
• Bug 740152: Document the deprecation of ATK_STATE_ARMED
• Documentation:
• Bug 740044: Fix some unclear language regarding ATK_STATE_ACTIVE
• Bug 740066: Improve documentation related to AtkState and AtkStateSet
• Extend atk_focus_tracker_notify deprecation documentation
• Remove some in-code documentation, that is already part of the docs
• Translations:
• Anders Jonsson (sv)

What is new in version 2.15.1:

• Bug 407539: Add ATK_STATE_HAS_TOOLTIP
• Documentation:
• Updated README file
• Bug 737602: Update documentation to reflect an additional use case for STATE_INDETERMINATE

What is new in version 2.14.0:

• Translations: DuAan Kazik (sk), Maria Mavridou (el), Yuri Myasoedov (ru)

What is new in version 2.11.6:

• AtkText:
• Bug 723292: Getting the localized role name fails for ATK_ROLE_EDITBAR
• Bug 653293: text-insert and text-remove are again detailed signals. Document it.
• Translations:
• Aurimas AŒernius (lt), Marek AŒernockA½ (cs), Tong Hui (zh_CN), Chao-Hsiung Liao (zh_HK)

What is new in version 2.11.5:

• MSVC Builds: Rework Introspection Build and other miscellaneous fixes
• Translations: Yosef Or Boczko (he), Dimitris Spingos (el), Peter Vagner (sk)

What is new in version 2.11.4:

• AtkRole:
• Bug 720065: add roles for description lists
• Deprecations:
• Bug 476674: deprecate table properties that depend on the row/column number
• Bug 652798: kill AtkMisc
• Deprecate connect/remove_property_change_handler
• Deprecate atk_role_register
• Documentation:
• Bug 644747: improve documentation for AtkObject::property-change
• Improved AtkUtil documentation
• Updated new symbols sections on documentation
• Not using GTK-Doc tag "Virtual" anymore, as is deprecated
• Building:
• Bug 644756: remove atkintl.h in favour of gi18n-lib.h from glib
• Bug 652965: include atk-enum-types.h on atk.h
• Fixed some gobject-introspection warnings
• Replace INCLUDES for AM_CPPFLAGS to silence automake deprecation warnings.
• Visual C++ Studio files:
• Add a PlatformToolsetTag on gengir MSVC Project
• Split the Property Sheets
• Update Visual C++ 2008 "install" phase
• Bug 690145: use Python to Generate the MSVC Projects
• Miscellanea:
• Bug 572489: atk_text_range_extents should use g_return_if_fail
• Bug 653293: remove G_SIGNAL_DETAILED from atktext signals that doesn't use details
• Bug 720095: add atk_object_peek_parent
• Updated AUTHORS and doap files
• Added role names on source file in order to be translated

What is new in version 2.11.3:

• Bug 709214: Need API to get the document's current page number and page count
• Updated Greek translation

Requirements:

• GLib2