                  Adding a translation to Skipstone
                  -------------------------------

1) Extract the strings from the source
--------------------------------------
In the skipstone src directory, create the .po template (.pot):

	xgettext -k_ -kN_  ../src/*.[ch]  -o ../locale/skipstone.pot

2) Update or create .po files
-----------------------------
If there are any existing translations, XX.po files, then merge them:

	cd locale
	msgmerge XX.po  skipstone.pot > XX.po.new
	mv XX.po.new XX.po

Or, if this is a new translation, copy the template:

	cd locale
	cp skipstone.pot XX.po


3) Add translations
-------------------
Edit XX.po to add translations for new strings, fix broken translations,
and touch up fuzzy translations.


4) Make and install Skipstone with i18n enabled
---------------------------------------------
The skipstone binary must be compiled to use the gettext() function so
translations will occur.

You can explicitely control the i18n enabling for each make step
like this:

	make enable_nls=1

Then the install step:

	make install enable_nls=1



In either case, a make install will for each XX.po file create a XX.mo file
and copy it to:

	$LOCALEDIR/XX/LC_MESSAGES/skipstone.mo

If there is no LOCALEDIR environment variable, then the default install
will be to:

	/usr/share/locale/XX/LC_MESSAGES/skipstone.mo



But, if you want a different explicite install directory, for example:

	make install enable_nls=1 LOCALEDIR=/usr/local/share/locale

or (for bash)
	export LOCALEDIR=/usr/local/share/locale
	make install enable_nls=1

Other export lines:
	sh:  export LOCALEDIR; LOCALEDIR=/usr/local/share/locale
	csh: setenv LOCALEDIR /usr/local/share/locale

