our current experimental Neutrino branch

git-svn-id: file:///home/bas/coolstream_public_svn/THIRDPARTY/applications/neutrino-experimental@27 e54a6e83-5905-42d5-8d5c-058d10e6a962

data/locale/_readme.txt

@@ -0,0 +1,67 @@
+Format of .locale files:
+------------------------
+character encoding: UTF-8
+filename suffix   : .locale
+
+Files must be strictly alphabetically ordered, and must not contain
+any empty lines.
+
+Destination of .locale files:
+-----------------------------
+directory: /var/tuxbox/config/locale or /share/tuxbox/neutrino/locale
+
+Master file:
+------------
+deutsch.locale is considered the master file.
+
+
+Verfication of .locale files:
+-----------------------------
+Use the check.locale.files shell script for detecting
+- violations of the sorting order,
+- missing translations and
+- legacy strings.
+
+
+
+How do I add a new locale string?
+---------------------------------
+1.)
+First of all, add the new string to deutsch.locale while preserving
+the ordering. Do not add any empty lines. Use `make ordercheck' to for
+verification.
+
+2.)
+Enter the directory apps/tuxbox/neutrino/data/locale.
+
+3.)
+Create new versions of the files apps/tuxbox/neutrino/src/system/locals.h
+and apps/tuxbox/neutrino/src/system/locals_intern.h
+using the command `make locals.h locals_intern.h'.
+
+4.)
+Check the modifications with `make check', or with
+diff locals.h ../../src/system/locals.h
+diff locals_intern.h ../../src/system/locals_intern.h
+
+5.)
+Copy the replacement file to their destination with `make install-locals',
+or with
+cp -p locals.h ../../src/system/locals.h
+cp -p locals_intern.h ../../src/system/locals_intern.h
+
+6.)
+To the extent possible, update other locale file. For this, the
+Perl-script create-locals-update.pl may be useful. 
+
+7.)
+If committing the changes to CVS, commit both the involved
+locale-files, apps/tuxbox/neutrino/src/system/locals.h, and
+as apps/tuxbox/neutrino/src/system/locals_intern.h.
+
+Useful tools:
+-------------
+- emacs (add '(file-coding-system-alist (quote (("\\.locale\\'" . utf-8-unix) ("" undecided)))) to .emacs or use "C-x <RET> c utf-8 <RET> C-x C-f deutsch.locale")
+- iconv
+- sort
+- uxterm