Ticket #1157: i18n.diff

docs/i18n.txt

@@ -38 +38 @@
 .. admonition:: Behind the scenes
 
     Django's translation machinery uses the standard ``gettext`` module that
-    comes with Python.
+    comes with Python. If you're using windows, you'll need to install this,
+    see `gettext on Windows`_ for more information.
 
 If you don't need internationalization
 ======================================
@@ -763 +764 @@
       anyway.
     * Django doesn't use ``xgettext`` alone. It uses Python wrappers around
       ``xgettext`` and ``msgfmt``. That's mostly for convenience.
+
+gettext on Windows
+==================
+
+gettext stuff is only needed for people who either want to extract message IDs or
+compile .po files. Translation work itself just uses existing .po files, but if
+you want to create your own .po files, or want to test or activate a changed .po
+file, you will need the ``gettext`` utilities:
+
+    * Download the following zip files from http://sourceforge.net/projects/gettext
+    * * ``gettext-runtime-X.bin.woe32.zip``
+    * * ``gettext-tools-X.bin.woe32.zip``
+    * * ``libiconv-X.bin.woe32.zip``
+
+    * extract the 3 files in the same folder (i.e. ``C:\Program Files\gettext-utils``)
+
+    * Update the system PATH :
+    * * ``Control Panel > System > Advanced > Environment Variables``
+    * * In the ``System variables`` list, click ``Path``, click ``Edit``
+    * * Add ``;C:\Program Files\gettext-utils\bin`` at the end of the ``Variable value``
+ No newline at end of file