win32/vsX: Fix 'make dist'

It should be atk-introspect.[vcproj|vcxproj], not atk-introspection.[vcproj|vcxproj].

Sorry!

Visual Studio builds: Integrate introspection builds

Since we hard-require Python for our builds, integrate introspection
builds in the build process.  This will fail if Python is not installed
or correctly set at PythonDir/PythonDirX64 or g-ir-scanner is not found
at $(GLibEtcInstallRoot)\bin, but it shouldn't otherwise impact the
build in other ways as the built DLL and lib will still be built and
copied normally.  This is in place here before the Meson build system is
ready for G-I and GLib.

MSVC Builds: Use PythonDir instead of PythonPath

If someone is building using MSBuild, we want to make sure that we do
not use an envvar that would also determine where the Python modules are
loaded.

Also, allow different Python paths depending on the Visual Studio
version that is being used for Visual Studio 201x builds, to better suit
the version of  Visual Studio that is used to build the official
releases of Python, which means the default is as follows:

-Visual Studio 2010, 2012, 2013: Python 3.4.x, which is built with 2010
-Visual Studio 2015 and 2017: Python 3.6.x, which is built with 2015.

MSVC Builds: Adapt to new glib-genmarshal command line

Use the --quiet and --output flags for the Python version of
glib-genmarshal.

Visual Studio builds: Adapt to the Python-fied glib-genmarshal

glib-genmarshal is used for the Visual Studio builds, and has been
recently converted to a Python script instead of a compiled C program.

Since Visual Studio calls cmd.exe to run Custom Build steps, we need
to call Python explicitly to run glib-genmarshal as shebang lines
are not supported in cmd.exe, which means that Python will become a
hard build-time requirement instead of being optional.  This also means
that the atk.pc pkg-config file will always be generated.

However, since ATK does not yet require a really recent GLib, maintain
compatibility with older GLib by calling glib-genmarshal.exe when the
glib-genmarshal Python script is not found.

meson: Add atkversion.h to introspection build

Update Friulian translation

atk/Makefile.am: Dist atk.rc

This was accidentally removed in commit cc0e04b, which broke Visual
Studio builds...

Move include guards out to enable GCC optimisation

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

meson: Keep the version in sync with Autotools

Release 2.25.2

Fix crash under atk_gobject_accessible_dispose

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

Add error-message, error-for, details, and details-for relation types

Also update documentation of description-for and described-by relation
types to help clarify which relation type is most suitable for each of
the accessible descriptions.

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

meson: Only depend on generated header

We don't need any target that depends on libatk to also depend on the
generated enumeration source file, just the header.

meson: Install atk.h

We're missing atk.h from the list of installed header.

meson: Use the appropriate GETTEXT_PACKAGE

The GETTEXT_PACKAGE for ATK is `atk10`.

meson: Use the appropriate soversion

The shared library should have a soversion of 0, so that Meson can
create the appropriate symlinks to match what Autotools do.

Update Git ignore file

Files were removed.

docs: Remove empty overrides file

It's empty and unused, and gtk-doc will create it for us.

docs: Update the README

Mention Meson and Ninja, and clean up the text a little bit.

build: Simplify GObject dependency discovery

We don't need this much ad hoc complexity in the build system to find
gobject-2.0 and its tools.

GObject depends on GLib; GThread does not exist any more, as has been
subsumed into GLib; the AM_PATH_GLIB_2_0 m4 macro is deprecated in
favour of just using PKG_CHECK_MODULES.

build: Modernise the API reference

Let's use modern, idiomatic gtk-doc to generate the API reference:

 - use XInclude
 - stop using SGML mode with XML files
 - drop version.xml and use the gtk-doc package entities

Mark unbindable functions as 'skip'

Functions that take a callback, with or without a closure, without a
scope are not allowed in introspected languages. The introspection
parser will automatically mark them as not introspectable, but it's
better to explicitly skip them.

build: Update deprecation warnings symbols

The old '*_DISABLE_DEPRECATED` pre-processor symbol class has been
deprecated now that the G* stack has moved on to versioned symbols and
versioned deprecation warnings. The appropriate way to disable compiler
warnings when building is to use `*_DISABLE_DEPRECATION_WARNINGS`.

build: Remove local introspection.m4

Always use the system one, since:

 - we require gobject-introspection at build time
 - the local copy always goes out of sync
 - the system copy is actually maintained

build: Dist the Meson files

When generating a tarball using Autotools we should dist the Meson
files, so it's possible to build ATK releases using Meson.

Remove ChangeLog

The commit log is in Git — and so is the ChangeLog file. There's no need
to leave the file around.

Remove unused script for bundling ATK on Windows

Almost 10 years old, and completely out of date.

Remove uninstalled pkg-config file

No library ships these files, and they have always been questionable to
begin with.

When building from a separate prefix, using PKG_CONFIG_PATH to modify
the pkg-config search path is a better option that just pointing to the
source directory of the dependencies.

Remove atk.spec.in

It's 12 years old, and hopelessly out of date. All operating systems
using RPM have a package for ATK anyway.

Add Meson build system

Meson is a meta-build system that has several advantages over Autotools:

  - faster
  - simpler to use and understand
  - portable to various platforms
  - tailored to the needs of GNOME libraries
  - well maintained and supported

Various other libraries in the GNOME stack have already adopted Meson in
parallel, or exclusively, including GTK+.

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

build: Add builddir to the docs directories

We generate header and source files during the build process, so we need
to tell gtk-doc to scan files under the builddir as well as the srcdir.

Include the marshallers header, not the source

The atkutil.c source is including atkmarshal.c, instead of including the
header. This is a weird behaviour, so let's build atkmarshal.c like the
rest of the source files, and include the header.

Convert file to UTF-8 encoding

The version header template was using the ISO-8859-15 encoding, and
breaking when using tools that expected UTF-8.

build: Use template files for the ATK enumerations

Placing the enumeration GType inline in the Makefile makes them
unreadable, and does not allow to easily update the body of the
get_type() functions. Case in point: ATK still generates thread-unsafe
versions of the enumeration and flags GTypes.

Let's update the build to something more idiomatic, and use template
files, like every other G* library does.

Add missing ATK_UNAVAILABLE macro

Without this, anybody trying to use ATK_VERSION_MAX_ALLOWED will fail to
import atk.h.

Add ATK_ROLE_FOOTNOTE

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

win32/replace.py: Fix replacing items in files with UTF-8 content

Some files that this script will process might have UTF-8 items in
there, which can cause problems on Python 3.x as it is more strict and
careful on unicode issues.  Fix this by:

-Doing what we did before on Python 2.x
-Opening the file with encoding='utf-8' on Python 3.x

Update po/Makevars

This is not a GNU package and the Free Software Foundation has no copyright
over it. Also adds MSGID_BUGS_ADDRESS.

Update Belarusian translation

(cherry picked from commit 856b79af5bb2542af7ac2a0d85262808db1a8328)

Release 2.24.0

Update Catalan translation

win32/Makefile.msvc.introspection: Sync with G-I

This is so that we can support using a list of C includes and so
generate the full NMake Makefile modules to build the .gir files in
a simpler way.

win32/detectenv-msvc.mak: Support Visual Studio 2017

Sync the file from GLib so that we can build the introspection files
using Visual Studio 2017.

Updated Danish translation

Remove win32/vs15/atk-install.props before re-generation

This will ensure that it will be up-to-date when win32/vs10/atk-install.props
is re-generated.

Visual Studio builds: Support Visual Studio 2017

Update the autotools scripts so that we can copy the Visual Studio 2010
project files and update them to obtain the Visual Studio 2017 projects.

As the format of the toolset version is different, allow a version number
string for the toolset version and use it if specified, otherwise just
create the toolset version string as we did before.

Note that Visual Studio 2015 and 2017 aims to be compatible in terms of
CRT usage, so it should be possible to use 2015-built binaries with
2017-built binaries.

Release 2.23.4

Visual Studio 201x builds: Fix previous commit

The previous commit which moved the project files from build/win32/ to
win32/ also attempted to clean up things a bit.  This fixes the cleanup.

Visual Studio projects: Move to win32/

It was suggested that the project be moved to win32/, so that one will
need to go one less layer down into the tree to reach the project files.

Makefile.msvcproj, Makefile-newvs.am: Update from GLib

We will move the project files to win32/ from build/win32/ soon, so
prepare the way by making these autotools modules like what it is
in GLib just before moving them to win32/.

docs: change id of the atkobject chapter

The reason is avoid collision with AtkObject.html on case-insensitive
filesystems.

One could argue that having a small html that just list AtkObject,
but this is done automatically by gtk-doc.

One could argue again, saying that probably the current chapter-split
main page (at atk-docs.sgml) is not the correct one, but I think
that for now a small id rename is better that a full main page
overhaul.

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

Update Friulian translation

Update Friulian translation

Add Friulian translation

docs: Tiny typo.

Fix to Catalan translation

build/win32/vs10/Makefile.am: Remove atk-install.props's on re-generation

This ensures that changes made to the generated atk-install.props are applied
to build/win32/vs[11|12|14] as well.

Adjust translations for the Unicode apostrophe

Use Unicode apostrophe in a translatable string

See https://developer.gnome.org/hig/stable/typography.html

Updated Croatian translation
(cherry picked from commit d57f97d831b02071e3a17d8376e5d27c52a523de)

Release 2.22.0

Update British English translation

Add more options to XGETTEXT_OPTIONS in po/Makevars

Updated Polish translation

Release 2.21.90

Add Language headers to po files

Future versions of gettext will fail if this header is missing.

Visual Studio builds: Make .pc generation more flexible

Allow the use of ${exec_prefix} for libdir and includedir when passing
them in as arguments to the script.

Updated Occitan translation

Updated Occitan translation

Added Scottish Gaelic translation

build/win32/atkpc.py: Fix dependent package string

The required packages should be space-separated, not comma-separated.

build/win32/pc_base.py: Allow custom options

Some packages might have some parts that are built for certain build
configs, meaning that they could have .pc files of their own, such as
Pango, where PangoFT2 is optionally built.  Allow such an option if
needed.

Also remove some trailing whitespaces.

Visual Studio 2008 builds: Ensure pc file is generated before "install"

Change the build event type to post build event, for all build types, to
ensure that we have the .pc file generated before copying the files, if
applicable.

Visual Studio builds: Generate atk.pc

...if Python can be found via $(PythonPath) (x86 builds) or
$(PythonPathX64) (x64 builds).  This makes it easier for packages that
requires atk.pc for introspection.

Visual Studio builds: Include version info in property sheets

This is needed so that we can generate the .pc file from the .pc.in file.

atk-introspection-msvc.mak: Clean up a bit

We don't need to delete the .pyc files upon cleaning, so remove this line.

MSVC Builds: Generate the Introspection Build Commands

This uses the common autotools module that was added in the previous commit
to generate the command lines used to generate the .gir and compile the
.typelib files, as well as the file list that is to be consumed during the
generation of the .gir files.

This also makes the detectmsvc-msvc.mak and introspection-msvc.mak NMake
modules the same as the ones in $(glib_srcroot)/build/win32 and
$(gi_srcroot)/build/win32 respectively, so that they may be copied from
these locations when they are updated.

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

MSVC Builds: Add a Common Autotools Module for Introspection

This adds a common autotools module that can be included by the Makefile.am's
to generate the filelist and to assemble the command line to call
g-ir-scanner and g-ir-compiler to generate the .gir files and .typelib files
respectively.

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

Add some missing argument (out) annotations

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

Release 2.20.0

Updated Danish translation

Updated Danish translation

Release 2.19.92

atkregistry: remove code not being compiled

I think that code was there in order to explain why it is not
needed. If that case, it would be better to just move the comment
around.

In general having code around #if 0 is a maintenance burden. That code
has not been compiled for years and nothing happen. It is better to
just remove it.

build: Fix gettext domain after recent changes

Commit 1b11db36463116310ec2e40a7072d205a6536532 that switched the build
system to use upstream gettext intead glib-gettext accidentally changed
the gettext domain from atk10 to atk; this commit changes it back.

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

MSVC builds: Re-arrange include paths

We want to search for the GLib include paths before the include paths of
GLib's dependencies.

build: Fix builddir ≠ srcdir in autogen.sh

gtkdocize either needs a --srcdir argument or needs to be run in the
source directory. Fix that by updating autogen.sh from the latest
template:

https://wiki.gnome.org/Projects/GnomeCommon/Migration#autogen.sh

Updated Occitan translation

Updated Swedish translation

Release 2.19.90

Updated Lithuanian translation

Use upstream gettext intead glib-gettext

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

Revert "MSVC release builds: Ensure that /LTCG is used"

As we now ensure that items using GResources and GConstructors are always
referenced so that the linker does not optimize them out in a default
Release build, we no longer need to enforce the use of /LTCG, so
/LTCG:incremental will work as well.

This reverts commit fc5394e7ca78d6d6272a3591236f99c11ffc5111.

MSVC release builds: Ensure that /LTCG is used

MSVC 2015 changed its default link-time code generation setting to
/LTCG:incremental, which causes problems if /opt:noref is to be used,
meaning that some code will be optimized out by the linker.

Avoid this situtation here by enforcing the use of /LTCG for MSVC 2010+
builds.

Fix build/win32/vs10/atk-install.vcxproj

Replace AtkEtcInstallRoot with GlibEtcInstallRoot, which is a leftover
from before.

Updated Esperanto translation

Updated Vietnamese translation

Signed-off-by: Trần Ngọc Quân <vnwildman@gmail.com>

Build: Make Makefile.msvcproj A Bit More Generic

Handle also the situation where $(srcdir) == $(top_srcdir), so that this
can also be used in cases like librsvg and gobject-introspection.

build/Makefile-newvs.am: Update Comments for Usage

Update the notes that this is also used for Visual Studio 2015 support,
and correct the MSVC_VER_LONG for MSVC 2015, which is 14, not 2015.

Also add a note that this can be used for other projects that have
Visual Studio build support.