diff --git a/tools/tools/locale/README b/tools/tools/locale/README
new file mode 100644
index 000000000000..d181b0b0f664
--- /dev/null
+++ b/tools/tools/locale/README
@@ -0,0 +1,18 @@
+# $FreeBSD$
+
+To generate the locales:
+
+Tools needed: java, perl and devel/p5-Tie-IxHash
+
+fetch cldr data from: http://cldr.unicode.org
+extract in a directory ~/unicode/cldr/v27.0.1 for example
+fetch unidata from http://www.unicode.org/Public/zipped/ (latest version)
+extract in a directory ~/unicode/UNIDATA/8.0.0 for example
+
+either modify tools/tools/locales/etc/unicode.conf or export variables:
+CLDRDIR="~/unicode/cldr/v27.0.1"
+UNIDATADIR="~/unicode/UNIDATA/8.0.0"
+
+run:
+make POSIX
+make install