WIP/RFC: add locale folder for helpdb.jl

LOCALE

@@ -0,0 +1,32 @@
+# Uncomment to enable 
+# Comment to disable
+# A for Available, U for Unavailable
+
+#	"bn"		#	Bengali						U
+#	"ca"		#	Catalan						U
+#	"cs"		#	Czech							U
+#	"da"		#	Danish							U
+#	"de"		#	German							U
+	"en"		#	English						A
+#	"es"		#	Spanish						U
+#	"et"		#	Estonian						U
+#	"fa"		#	Iranian						U
+#	"fi"		#	Finnish						U
+#	"fr"		#	French							U
+#	"hr"		#	Croatian						U
+#	"it"		#	Italian						U
+#	"ja"		#	Japanese						U
+#	"ko"		#	Korean							U
+#	"lt"		#	Lithuanian						U
+#	"lv"		#	Latvian						U
+#	"ne"		#	Nepali							U
+#	"nl"		#	Dutch							U
+#	"pl"		#	Polish							U
+#	"pt_BR"		#	Brazilian Portuguese			U
+#	"ru"		#	Russian						U
+#	"sl"		#	Slovenian						U
+#	"sv"		#	Swedish						U
+#	"tr"		#	Turkish						U
+#	"uk_UA"		#	Ukrainian						U
+#	"zh_CN"		#	Simplified Chinese				A
+#	"zh_TW"		#	Traditional Chinese			U

Makefile

@@ -7,14 +7,14 @@ default: release
 DIRS = $(BUILD)/bin $(BUILD)/lib $(BUILD)/$(JL_PRIVATE_LIBDIR) $(BUILD)/share/julia
 
 $(foreach dir,$(DIRS),$(eval $(call dir_target,$(dir))))
-$(foreach link,extras base test doc examples ui,$(eval $(call symlink_target,$(link),$(BUILD)/share/julia)))
+$(foreach link,extras base test doc examples ui help,$(eval $(call symlink_target,$(link),$(BUILD)/share/julia)))
 
 QUIET_MAKE =
 ifeq ($(USE_QUIET), 1)
 QUIET_MAKE = -s
 endif
 
-debug release: | $(DIRS) $(BUILD)/share/julia/extras $(BUILD)/share/julia/base $(BUILD)/share/julia/test $(BUILD)/share/julia/doc $(BUILD)/share/julia/examples $(BUILD)/share/julia/ui
+debug release: | $(DIRS) $(BUILD)/share/julia/extras $(BUILD)/share/julia/base $(BUILD)/share/julia/test $(BUILD)/share/julia/doc $(BUILD)/share/julia/examples $(BUILD)/share/julia/ui $(BUILD)/share/julia/help
 	@$(MAKE) $(QUIET_MAKE) julia-$@
 	@export JL_PRIVATE_LIBDIR=$(JL_PRIVATE_LIBDIR) && \
 	$(MAKE) $(QUIET_MAKE) LD_LIBRARY_PATH=$(BUILD)/lib:$(LD_LIBRARY_PATH) JULIA_EXECUTABLE="$(JULIA_EXECUTABLE_$@)" $(BUILD)/$(JL_PRIVATE_LIBDIR)/sys.ji
@@ -29,11 +29,11 @@ julia-debug julia-release:
 	@$(MAKE) $(QUIET_MAKE) -C ui $@
 	@ln -sf $(BUILD)/bin/$@-$(DEFAULT_REPL) julia
 
-$(BUILD)/share/julia/helpdb.jl: doc/helpdb.jl | $(BUILD)/share/julia
+$(BUILD)/share/julia/help/helpdb_en.jl: doc/helpdb_en.jl | $(BUILD)/share/julia/help/
 	@cp $< $@
 
 # use sys.ji if it exists, otherwise run two stages
-$(BUILD)/$(JL_PRIVATE_LIBDIR)/sys.ji: VERSION base/*.jl base/pkg/*.jl $(BUILD)/share/julia/helpdb.jl
+$(BUILD)/$(JL_PRIVATE_LIBDIR)/sys.ji: VERSION base/*.jl base/pkg/*.jl $(BUILD)/share/julia/help/helpdb_en.jl
 	@#echo `git rev-parse --short HEAD`-$(OS)-$(ARCH) \(`date +"%Y-%m-%d %H:%M:%S"`\) > COMMIT
 	$(QUIET_JULIA) cd base && \
 	(test -f $(BUILD)/$(JL_PRIVATE_LIBDIR)/sys.ji || $(JULIA_EXECUTABLE) -bf sysimg.jl) && $(JULIA_EXECUTABLE) -f sysimg.jl || echo "Note: this error is usually fixed by running 'make clean'. If the error persists, 'make cleanall' may help."
@@ -81,6 +81,7 @@ ifeq ($(OS), WINNT)
 	-cp $(JULIAHOME)/contrib/windows/* $(PREFIX)
 endif
 	cp $(JULIAHOME)/VERSION $(PREFIX)/share/julia/VERSION
+	cp $(JULIAHOME)/LOCALE $(PREFIX)/share/julia/LOCALE
 	echo `git rev-parse --short HEAD`-$(OS)-$(ARCH) \(`date +"%Y-%m-%d %H:%M:%S"`\) > $(PREFIX)/share/julia/COMMIT
 
 dist: 

base/util.jl

@@ -219,7 +219,8 @@ function init_help()
            help_module_dict, help_function_dict
     if help_category_dict == nothing
         println("Loading help data...")
-        helpdb = evalfile("$JULIA_HOME/../share/julia/helpdb.jl")
+        HELP_LOCALE = evalfile("$JULIA_HOME/../share/julia/LOCALE")
+        helpdb = evalfile("$JULIA_HOME/../share/julia/help/helpdb_$(HELP_LOCALE).jl")
         help_category_list = {}
         help_category_dict = Dict()
         help_module_dict = Dict()

doc/Makefile

@@ -24,7 +24,7 @@ WGET = $(abspath ../deps)/jldownload
 
 help:
 	@echo "Please use \`make <target>' where <target> is one of"
-	@echo "  helpdb.jl  to make the REPL help db"
+	@echo "  helpdb_en.jl  to make the REPL help db"
 	@echo "  html       to make standalone HTML files"
 	@echo "  dirhtml    to make HTML files named index.html in directories"
 	@echo "  singlehtml to make a single large HTML file"
@@ -171,9 +171,9 @@ doctest:
 	@echo "Testing of doctests in the sources finished, look at the " \
 	      "results in $(BUILDDIR)/doctest/output.txt."
 
-helpdb.jl: stdlib/*.rst sphinx/jlhelp.py sphinx/julia.py
+helpdb_en.jl: stdlib/*.rst sphinx/jlhelp.py sphinx/julia.py
 	$(SPHINXBUILD) -b jlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/jlhelp
-	mv $(BUILDDIR)/jlhelp/jlhelp.jl helpdb.jl
+	mv $(BUILDDIR)/jlhelp/jlhelp.jl helpdb_en.jl
 
 listpkg: 
 	$(JULIA) listpkg.jl

doc/README.md

@@ -18,7 +18,7 @@ On ubuntu, you'll need the following packages installed:
 
 Then run
 
-    $ make helpdb.jl
+    $ make helpdb_en.jl
     $ make html
     $ make latexpdf
 
@@ -27,9 +27,9 @@ File layout
 -----------
 
     conf.py             Sphinx configuration
-    helpdb.jl           REPL help database
+    helpdb_en.jl           REPL help database
     sphinx/             Sphinx extensions and plugins
-    sphinx/jlhelp.py    Sphinx plugin to build helpdb.jl
+    sphinx/jlhelp.py    Sphinx plugin to build helpdb_en.jl
     stdlib/             Julia standard library documentation
     _themes/            Sphinx html themes