README

                                 ------------
                                    Poedit
                                 ------------

              a cross-platform gettext catalogs editing tool


 About
=======

This program is GUI frontend to GNU gettext utilities (win32 version
is part of the distribution) and catalogs editor/source code parser. It helps
with translating application into another language. For details on principles
of the solution used, see GNU gettext documentation or wxWidgets' wxLocale
class reference.


 Installing
============

Binary easily-installable packages are provided for Windows and OS X and are
part of many Linux distributions.


 Installing from sources
=========================

Requirements:

  * Boost
  * Unicode build of wxWidgets library, version >= 3.0 (see http://www.wxwidgets.org)
  * ICU
  * LucenePlusPlus
  * If on Unix, GtkSpell for spell checking support

Optional dependencies:

  * cld2 (better language autodetection and non-English source languages)
  * Expat and Berkeley DB >= 4.7 (legacy translation memory migration)
  * C++REST SDK >= 2.5 (Crowdin integration)


 Unix
------

Do the usual thing:

    ./configure
    make
    make install

You must have the dependencies installed in a location configure will find,
e.g. by setting CPPFLAGS and LDFLAGS appropriately.


 OS X
------

You need a full git checkout to build on OS X; see below for details.

After checkout, use the Poedit.xcworkspace workspace and Xcode 6 to build
Poedit.

There are some additional dependencies on tools not included with OS X.
They can be installed with Homebrew and macosx/Brewfile:

    brew bundle macosx/


 Windows using Visual Studio 2013
----------------------------------

You need a full git checkout to build on Windows; see below for details.

After checkout, use the Poedit.sln solution.


 Installing from Git repository
--------------------------------

Get the sources from github (http://github.com/vslavik/poedit):

    git clone git://github.com/vslavik/poedit.git

If you are on Windows or OSX, you probably want the dependencies too. They
are at git://github.com/vslavik/poedit-deps.git, but as it's a git submodule,
you can get them by just doing

    git submodule init
    git submodule update --recursive

If you get the sources directly from the Git repository, some generated files
are not present. You have to run the ./bootstrap script to create them. After
that, continue according to the instructions above.

The ./bootstrap script requires some additional tools to be installed:

 * AsciiDoc, xsltproc and xmlto to generate the manual page
 * Bakefile, to generate Windows makefiles/projects
 * ImageMagick and png2icns from libicns to generate icons in Windows and
   OS X native formats

If you don't have any of the dependencies, ./bootstrap will print errors, but
will continue to run. In other words, if you don't need e.g. Windows stuff, you
can ignore Windows-specific dependencies.


 License
=========

Poedit is released under the MIT license and you're free to do 
whatever you want with it and its source code (well, almost :-) -- see the
license text).

See the COPYING file for details on program's licensing and the
icons/README file for details on the icons.

Win32 and Mac OS X versions contain GNU gettext binaries. They are distributed
under the GNU General Public License and their source code is available from
http://www.gnu.org/software/gettext or, if you have difficulties getting them
from there, email me for a copy of the sources.


 Author
========

Vaclav Slavik <vaclav@slavik.io>
Please see the AUTHORS file for information about other contributors.


 Links
=======

http://poedit.net/
        - Poedit homepage
http://www.gnu.org/software/gettext/
        - GNU project homepage, contains gettext and documentation