802f5d031d
- Fixed issues with inspector - Changed the use of boost::mutex - not include entire boost.thread - Updated documentation build script [SVN r73059]
97 lines
3.8 KiB
Plaintext
97 lines
3.8 KiB
Plaintext
//
|
|
// Copyright (c) 2009-2011 Artyom Beilis (Tonkikh)
|
|
//
|
|
// Distributed under the Boost Software License, Version 1.0. (See
|
|
// accompanying file LICENSE_1_0.txt or copy at
|
|
// http://www.boost.org/LICENSE_1_0.txt)
|
|
//
|
|
|
|
|
|
// vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 filetype=cpp.doxygen
|
|
/*!
|
|
\page gettext_for_windows Using Gettext Tools on Windows
|
|
|
|
In order to get the Gettext tools like \c msgfmt, \c msgmerge, \c xgettext for Windows you have
|
|
basically several options:
|
|
|
|
- Download the package from <a href="http://cppcms.sourceforge.net">CppCMS</a> project (where the Boost.Locale was developed originally)
|
|
- Download the a set of packages from MinGW project
|
|
- Build it on your own
|
|
- Use Cygwin's packages
|
|
|
|
\section gettext_for_windows_cppcms Getting gettext utilities from CppCMS project
|
|
|
|
Boost.Locale was developed for needs of <a href="http://cppcms.sourceforge.net">CppCMS</a> project
|
|
and thus CppCMS hosts a convince package for Windows users of pre-build, statically liked \c gettext
|
|
runtime utilities like \c xgettext, \c msgfmt, etc.
|
|
|
|
So you can download a zip file \c gettext-tools-static-XXX.zip from a CppCMS downloads page
|
|
under <a href="https://sourceforge.net/projects/cppcms/files/boost_locale/gettext_for_windows/">boost_locale/gettext_for_windows</a>.
|
|
|
|
Extract the file and use the executable files inside.
|
|
|
|
\section gettext_for_windows_mingw Getting Gettext via MinGW project
|
|
|
|
MinGW project provides GNU tools for Windows, including GNU compilers and various runtime utilities.
|
|
Thus you can always install full MinGW distribution including gettext tools. However, if you
|
|
a want minimalistic runtime version that allows you to extract messages and create catalogs
|
|
you need to download several packages manually.
|
|
|
|
In order to install Gettext via MinGW distributing you need to download, a GCC's runtime,
|
|
iconv library and gettext itself.
|
|
|
|
So visit a <a href="https://sourceforge.net/projects/mingw/files/">downloads page</a> of MinGW project
|
|
and download following files (chose the latest versions of each package):
|
|
|
|
- From: \c MinGW/BaseSystem/GCC/Version4/gcc-xxx/ \n
|
|
File: \c libgcc-xxx-mingw32-dll-1.tar.lzma
|
|
- From \c MinGW/Gettext/gettext-yyy/ \n
|
|
Files: \c gettext-yyy-mingw32-dev.tar.lzma,
|
|
\c libgettextpo-yyy-mingw32-dll-0.tar.lzma,
|
|
\c libintl-yyy-mingw32-dll-8.tar.lzma
|
|
- From \c MinGW/libiconv/libiconv-zzz/ \n
|
|
Files: \c libiconv-zzz-mingw32-dll-2.tar.lzma, \c libcharset-zzz-mingw32-dll-1.tar.lzma
|
|
|
|
For example, at June 23, 2011 it was:
|
|
|
|
- GNU Runtime: \c libgcc-4.5.2-1-mingw32-dll-1.tar.lzma
|
|
- \c iconv: \c libiconv-1.13.1-1-mingw32-dll-2.tar.lzma and \c libcharset-1.13.1-1-mingw32-dll-1.tar.lzma
|
|
- \c gettext: \c libintl-0.17-1-mingw32-dll-8.tar.lzma, \c libgettextpo-0.17-1-mingw32-dll-0.tar.lzma and \c gettext-0.17-1-mingw32-dev.tar.lzma.
|
|
|
|
After you download the packages, extract all the files to the same directory using tools like
|
|
\c 7zip and you'll get all the executables and \c dll's you need under \c bin subdirectory.
|
|
|
|
\note the version on MinGW site is slightly outdated (0.17.1) while gettext provides currently 0.18.1.
|
|
|
|
\section gettext_for_windows_build Building latest version on your own.
|
|
|
|
You can build your own version of GNU Gettext using MinGW environment, you'll need to have up-to-date gcc compiler
|
|
and the shell, you'll need to install iconv first and then build a gettext with it.
|
|
|
|
Basic and simplest way would be to open a MinGW shell
|
|
|
|
Build \c iconv:
|
|
|
|
\code
|
|
cd libiconv-SOMEVERSION
|
|
./configure --prefix=c:/mygettext --disable-shared
|
|
make
|
|
make install
|
|
cd ..
|
|
cd gettext-SOMEVERSION
|
|
./configure --prefix=c:/mygettext --disable-shared --with-libiconv-prefix=c:/mygettext
|
|
make
|
|
make install
|
|
\endcode
|
|
|
|
And now you have in <tt>c:\\mygettext\\bin</tt> all appropriate executable files
|
|
to use.
|
|
|
|
\section gettext_for_windows_cygwin Using Cygwin
|
|
|
|
If you already have Cygwin - just use gettext tools provided with it.
|
|
|
|
*/
|
|
|
|
|