MSVC builds: Update Visual Studio build instructions.msvc.improved

Let people know the newer things that the NMake Makefiles can now do to
build gsettings-desktop-schemas.

1 files changed, 29 insertions, 2 deletions

diff --git a/win32/README.txt b/win32/README.txt
index fea1438..a86eb4b 100644
--- a/win32/README.txt
+++ b/win32/README.txt
@@ -24,7 +24,7 @@ The required dependencies are as follows:
 

 -A working installation of PERL, which could either be built from the sources or obtained

  from distributions such as Strawberry PERL or ActiveState PERL.  This is needed if the

- GLib used is 2.52.x or earlier.

+ GLib used is 2.52.x or earlier, or if planning to process the translations in po\.

 

 -A working installation of Python 2.7.x+ or 3.x, which could be built from the sources or

  obtained from the installers from http://www.python.org.

@@ -36,19 +36,46 @@ For introspection building, you will also need:
  ensure that the Python in your PATH (or the one specified with $(PYTHON) matches the

  Python installation and configuration that was used to build gobject-introspection.

 

+For processing the translations, you will also need:

+-intltool 0.50.1 or later.  This can be hard to install on Windows, and it requires

+ the XML::Parser PERL package, which can be obtained from CPAN.  An installation of

+ Cygwin or MSYS2 is also needed, with its bin\ path being added at the end of your

+ PATH.  The gettext tools are also required.

+

 Run 'nmake /f Makefile.vc' to generate the needed schema files.  If building the

 introspection files is desired, run 'nmake /f Makefile.vc introspection'.  A 'clean'

-target is provided to remove all the generated files.  You may also specify the following

+target is provided to remove all the generated files.  An 'install' target is

+provided to copy the generated GSchema XML files to DATADIR (please see below), and

+the .h header file, the introspection file and the translation files to locations

+under $(PREFIX) as appropriate.  You may also specify the following

 items in the NMake command line with item=xxx:

 

+---

 PREFIX: Installation prefix, <parentdir_of_srcroot>\vs<Visual Studio Version>\<PlatformName>

         by default.

+

+DATADIR: User-specified data directory, $(PREFIX)\share by default.

+

 GLIB_COMPILE_SCHEMAS: Location of the glib-compile-schemas tool,

                       $(PREFIX)\bin\glib-compile-schemas.exe by default

+

 GLIB_MKENUMS: Location of the glib-mkenums tool script, $(PREFIX)\bin\glib-mkenums by default

+

 PYTHON: Location of the Python 2.7.x/3.x interpreter, needed if it is not in your PATH.

+

 PERL: Location of the PERL interpreter, needed if not in your PATH.

 

+INTROSPECTION: Build the introspection files for GSettings-Desktop-Schemas

+

+GENERATE_MO: Process the translations provided by GSettings-Desktop-Schemas, where the

+             following items are supported:

+

+* INTLTOOL_UPDATE: Path to the intltool-update script from intltool, if it is not at

+                   $(PREFIX)\bin

+* INTLTOOL_EXTRACT: Path to the intltool-extract script from intltool, if it is not at

+                    $(PREFIX)\bin

+* XGETTEXT: Path to the xgettext tool, if it is not in your PATH.

+---

 Please refer to the README.txt file in $(GLib_src_root)\win32\vs<Visual Studio Version>

 on how to build GLib using your version of Visual Studio, for GLib 2.56.x or earlier, or

 in $(GLib_src_root)\README.win32 for GLib 2.57.x or later.  Versions 2008 through 2017 are