Blame win32/README.txt

Packit 9c2278
As some file decompression utilities have problems resolving UNIX symlink files,
Packit 9c2278
please check whether there are any 0-size files in Adwaita/scalable and/or
Packit 9c2278
Adwaita/cursors.  If there are, there is a good chance that you are affected by
Packit 9c2278
this problem.  Delete the whole folder tree and try again, note that the following
Packit 9c2278
utilities are known to work correctly:
Packit 9c2278
- Latest stable version of 7-zip (version 15.14 at time of writing)
Packit 9c2278
- Using the latest tar/xz as provided by MSYS2, by calling 'tar -Jxvh'.
Packit 9c2278
Packit 9c2278
Please refer to the following GNOME Live! page for more detailed
Packit 9c2278
instructions on building this package with Visual C++:
Packit 9c2278
Packit 9c2278
https://live.gnome.org/GTK%2B/Win32/MSVCCompilationOfGTKStack
Packit 9c2278
Packit 9c2278
The adwaita-msvc.mak is an NMake Makefile that is meant to be used to generate
Packit 9c2278
the index.theme file that is needed for installation of this icon theme
Packit 9c2278
package, as well as copying and processing the icon files so that they
Packit 9c2278
will be ready for use for GTK+ applications.
Packit 9c2278
Packit 9c2278
The required dependencies are as follows:
Packit 9c2278
Packit 9c2278
-A working installation of Python 2.7.x+ or 3.x, which could be built from the
Packit 9c2278
 sources or obtained from the installers from http://www.python.org.
Packit 9c2278
Packit 9c2278
For optimal results, you will also need:
Packit 9c2278
-The gtk-update-icon-cache tool, which can be found by building the latest GTK+
Packit 9c2278
 2.24.x/3.18.x (or later) package.
Packit 9c2278
 The tool should be placed in $(PREFIX)\bin.
Packit 9c2278
Packit 9c2278
-PNG versions of the SVG symbolic icons are generated in 16x16, 24x24, 32x32,
Packit 9c2278
 48x48, 64x64 and 96x96 sizes if the gtk-encode-symbolic-svg tool is found in
Packit 9c2278
 $(PREFIX)\bin, and the SVG GDK-Pixbuf loader is properly installed, which is
Packit 9c2278
 obtained by building GDK-Pixbuf and libRSVG.  The PNG versions of the symbolic
Packit 9c2278
 icons are necessary if your app is a GTK-3.x app and you are not intending to
Packit 9c2278
 ship the SVG GDK-Pixbuf loader nor the libRSVG DLL (which are both required
Packit 9c2278
 otherwise).
Packit 9c2278
Packit 9c2278
Run 'nmake /f adwaita-msvc.mak' to generate the needed index.theme file.
Packit 9c2278
PYTHON=xxx can be specified on the command line if your Python interpretor is
Packit 9c2278
not in your PATH.  Run 'nmake /f adwaita-msvc.mak install' to copy the
Packit 9c2278
generated index.theme, as well as all the icon and cursor files into
Packit 9c2278
$(PREFIX)\share\icons, and process them if the optional tools are found, so
Packit 9c2278
that the icons will be ready for use by GTK+-using applications.
Packit 9c2278
A 'clean' target is provided to remove all the generated files-to uninstall
Packit 9c2278
the installed icons, simply delete the $(PREFIX)\share\icons\Adwaita folder.
Packit 9c2278
Packit 9c2278
Please refer to the README.txt file in $(GLib_src_root)\win32\vs<Visual Studio Version>
Packit 9c2278
on how to build GLib using your version of Visual Studio.  Versions 2008 through 2015 are
Packit 9c2278
currently supported.
Packit 9c2278
Packit 9c2278
Set up the source tree as follows under some arbitrary top
Packit 9c2278
folder <root>:
Packit 9c2278
Packit 9c2278
<root>\<this-adwaita-icon-theme-source-tree>
Packit 9c2278
<root>\<Visual Studio Version>\<PlatformName>
Packit 9c2278
Packit 9c2278
*this* file you are now reading is thus located at
Packit 9c2278
<root>\<this-adwaita-icon-theme-source-tree>\win32\README.txt
Packit 9c2278
Packit 9c2278
--Chun-wei Fan <fanc999@gmail.com>