Daniel Boles authored May 26, 2017 and Daniel Boles committed May 26, 2017

by ensuring the #ifndef GUARD_NAME and its #endif are the outermost
pieces of non-comment and non-whitespace content in the header file.

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

This includes atk/atkversion.h in all the public headers, either directly
or via atk/atkobject.h, and annotates the public symbols in the headers,
which all lead to _ATK_EXTERN via one of ATK_AVAILABLE_IN_ALL,
ATK_AVAILABLE_IN_X_Y, ATK_DEPRECATED, ATK_DEPRECATED_FOR,
ATK_DEPRECATED_IN_X_Y or ATK_DEPRECATED_IN_X_Y_FOR, depending on which
stable release series the API was introduced or deprecated.

_ATK_EXTERN which can then be defined in a way during the build, so that
these symbols can be exported automatically using compiler directives.

Also use _ATK_EXTERN for ATK_VAR in atk/atkmisc.h during the build so that
variables can also be properly exported.

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

So now is properly scanned by gtk-doc

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

2008-06-05  Michael Natterer  <mitch@imendio.com>

	* configure.in: add G_DISABLE_SINGLE_INCLUDES and
	ATK_DISABLE_SINGLE_INCLUDES to CPPFLAGS.

	* atk/atk.h: define __ATK_H_INSIDE__ around including all other
	headers.

	* atk/atk*.h: add single-include guards that #error out if
	ATK_DISABLE_SINGLE_INCLUDES is defined and any of these files is
	included individually. Use G_BEGIN_DECLS/G_END_DECLS in all files.

	* atk/Makefile.am: define ATK_COMPILATION while building ATK.
	Add single-include guards to the generated atk-enum-types.h too.


svn path=/trunk/; revision=1246

2002-02-11  jacob berkman  <jacob@ximian.com>

	* atk/atkselection.[ch] (atk_selection_get_type):
	* atk/atktable.[ch] (atk_table_get_type):
	* atk/atkregistry.h (atk_get_default_registry):
	* atk/atknoopobjectfactory.[ch] (atk_no_op_object_factory_get_type):
	* atk/atkobjectfactory.[ch] (atk_object_factory_get_type):
	* atk/atkcomponent.[ch] (atk_component_get_type):
	* atk/atkaction.[ch] (atk_action_get_type): declare function
	arguments as (void) rather than ()

* atk/atkregistry.h: Add declaration for atk_registry_get_type()