Some methods do not have a way to notify that they have failed.
They should thus make sure that they set some value, rather than let them
uninitialized and thus random.

This is a follow-up for 9118d447 ("Make sure returned values are
initialized")

The atk_image_get_image_locale() method is missing a description.

https://bugzilla.gnome.org/show_bug.cgi?id=764883

Source files are not executable.

https://bugzilla.gnome.org/show_bug.cgi?id=752930

Fixes a couple of warnings emitted by gtkdoc-mkdb
and g-ir-scanner.

https://bugzilla.gnome.org/show_bug.cgi?id=729752

Make sure that config.h is included first in all the C-sources in atk/ so
that the build-time definitions of _ATK_EXTERN can be used during the
build of the ATK library.

https://bugzilla.gnome.org/show_bug.cgi?id=728031

This reverts commit feb4bd4c.

The static documentation of those .sgml (so the reason of
tracking those objects) where moved to the source files.

Some other stuff was changed in order to prevent gtk-doc warnings
(like replacing "Returns blah" for the correct "Returns: blah")

https://bugzilla.gnome.org/show_bug.cgi?id=684665

https://bugzilla.gnome.org/show_bug.cgi?id=652205

Fixes bug #571622.

symbols, and modify the inline docs so that the parser can find them.
Bug #313183.

sections tagged as incomplete.

that NULL in-params were passed.  Thanks to Behdad Estafood for
finding problem.

Added new API for ATK 1.11/1.12.
Minor docs cleanup.

supplements AtkUtil sgml page, and moves return code
exception/range info to "Returns" block.

2004-08-13  Padraig O'Briain  <padraig.obriain@sun.com>

	* *atk/atkdocument.c atk/atkeditabletext.c atk/atkhypertext.c
	atk/atkimage.c atk/atknoopobjectfactory.c atkobject.c
	atk/atkstreamablecontent.c atk/atktext.c attk/atkvalue.c:
	Fix for bug #149990; patch from Kjartan Maraas.

* atk/atkaction.c:
Refer to return value in function documentation for
atk_action_do_action
* atk/atkimage.c:
Fix typo in comments
* docs/tmpl/atkaction.sgml:
Update to include return value

* docs/tmpl/atkimage.sgml atk/atkimage.h:
Swap height and width arguments to atk_image_get_image_size
* atk/atkimage.c:
Swap height and height arguments to atk_image_get_image_size
Do not crash if NULL pointers are passed for return values

so the naming is consistant.  Now get_image_position
and get_image_size return -1 for x/y/height/width
if AtkImage implementations of these functions is
not found.

* atk/*.c:
Remove all instances of g_return_if_fail (foo != NULL); that are
immediately before a g_return_if_fail (ATK_IS_FOO (foo));
since the second check catches the NULL.

input/output also take an enum specifying whether
the coords are screen or top-level window based.

changes to the API.

* atk/atkaction.c, atk/atkcomponent.c, atk/atkeditabletext.c,
atk/atkhyperlink.c, atk/atkhypertext.c, atk/atkimage.c,
atk/atkregistry.c, atk/atkselection.c, atk/atktable.c,
atk/atktext.c, atk/atkutil.c, atk/atkvalue.c
Fix warnings generated by Sun FORTE compiler