Adding some basic documentation about setting the locale of the Calendar widget. See slightlynybbled#31

slightlynybbled · slightlynybbled · commit 189bb69dd6f2 · 2018-05-31T07:25:15.000-04:00
diff --git a/examples/user_calendar.py b/examples/user_calendar.py
@@ -1,5 +1,10 @@
 import tkinter
 import tk_tools
+import locale
+
+# use this as a flag to change the language of the
+# calendar using the locale, as shown below
+show_in_german = False
 
 
 def callback():
@@ -10,6 +15,10 @@ def callback():
 
     root = tkinter.Tk()
     root.title('TK Tools Calendar')
+
+    if show_in_german:
+        locale.setlocale(locale.LC_ALL, 'deu_deu')
+
     calendar = tk_tools.Calendar(root)
     calendar.pack()
 
diff --git a/tk_tools/groups.py b/tk_tools/groups.py
@@ -600,7 +600,12 @@ def _get_calendar(locale, fwday):
 
 class Calendar(ttk.Frame):
     """
-    Graphical date selection widget, with callbacks.
+    Graphical date selection widget, with callbacks.  To change
+    the language, use the ``locale`` library with the appropriate
+    settings for the target language.  For instance, to display
+    the ``Calendar`` widget in German, you might use::
+
+        locale.setlocale(locale.LC_ALL, 'deu_deu')
 
     :param parent: the parent frame
     :param callback: the callable to be executed on selection
diff --git a/tk_tools/version.py b/tk_tools/version.py
@@ -1 +1 @@
-__version__ = '0.9.5'
+__version__ = '0.9.6'
