Full instructions for producing the Luminotes Desktop installer on Windows.

INSTALL

@@ -13,7 +13,7 @@ computer without an internet connection.
 First, install the prerequisites:
 
  * Python 2.4 to 2.5
- * CherryPy 2.2
+ * CherryPy 2.3
  * pysqlite 2.3 to 2.4
  * simplejson 1.3 to 2.0
  * pytz 2006p to 2008c
@@ -63,8 +63,80 @@ of your notes and notebooks, will be stored on the USB drive instead of on the
 computer itself. Then, anytime you want to start Luminotes on the USB drive,
 run usb_luminotes.sh from it.
 
-If you're only interested in Luminotes Desktop, you can stop reading here. The
-rest of this document describes Luminotes Server.
+If you're only interested in running Luminotes Desktop, you can stop reading
+here.
+
+
+building Luminotes Desktop
+--------------------------
+
+If you'd like to build your own Luminotes installer for Windows, follow these
+steps. You should only need to do this if you are a Luminotes developer.
+Otherwise you can completely skip this section.
+
+First, install the prerequisites:
+
+ * Python 2.4 to 2.6
+ * setuptools 0.x
+ * CherryPy 2.3
+ * pysqlite 2.x (which wraps SQLite 3.x)
+ * simplejson 1.3
+ * pytz 2006p to 2008c
+ * Python Imaging Library 1.1
+ * Python Universal Encoding Detector 1.0
+ * Microsoft Visual C++ 2008 SP1 Redistributable Package
+   (You do not need Visual Studio itself.)
+ * py2exe 0.x
+ * Inno Setup Unicode 5.x
+ * Luminotes source code
+
+The recommended way to do this on Windows is as follows:
+
+ 1. Log into Windows as the Administrator.
+
+ 2. Install Python via the official Windows installer.
+
+ 3. Install setuptools by downloading and running ez_setup.py.
+
+ 4. Install CherryPy. Since Luminotes currently requires an ancient version of
+    CherryPy, install it manually by downloading the correct version and
+    running: python.exe setup.py install within CherryPy's unzipped directory.
+
+    Note: python.exe is usually found in C:\Python*\
+
+ 5. Install other packages with easy_install (or pip, if you prefer):
+
+    * easy_install.exe install pysqlite
+    * easy_install.exe install simplejson
+    * easy_install.exe install pytz
+    * easy_install.exe install pil
+    * easy_install.exe install chardet
+
+    Note: easy_install.exe is usually found in C:\Python*\Scripts\
+
+ 7. Install Visual C++ 2008 SP1 Redistributable Package via its installer.
+
+ 8. Install py2exe via its installer.
+
+ 9. Install Inno Setup Unicode via its installer.
+
+ 10. Download and unpack the Luminotes source code.
+
+To actually build the Luminotes Desktop installer, cd to the Luminotes source
+directory and run:
+
+  python.exe setup.py py2exe
+  ISCC.exe dist\luminotes.iss
+
+  Note: ISCC.exe is usually found in C:\Program Files\Inno Setup 5\
+
+If py2exe has problems importing certain packages that are installed as eggs,
+then try unzipping the eggs into directories of the same name. The eggs are
+usually found in C:\Python*\Lib\site-packages\
+
+The commands above should produces a Luminotes Desktop setup.exe installer
+within the dist\Output\ directory. You can the run setup.exe on any Windows
+computer to install Luminotes Desktop.
 
 
 Luminotes Server
@@ -76,7 +148,7 @@ like at luminotes.com.
 First, install the prerequisites:
 
  * Python 2.4 to 2.5
- * CherryPy 2.2
+ * CherryPy 2.3
  * PostgreSQL 8.1
  * psycopg 2.0
  * simplejson 1.3

NEWS

@@ -1,6 +1,8 @@
 1.6.18: 
  * Fixed a bug that prevented use of the AltGr key on Polish and other
    keyboards.
+ * Added a section in the INSTALL file for developers building their own
+   Luminotes Desktop installer.
 
 1.6.17: July 26, 2009
  * Fixed a bug that caused ever-growing notes in Internet Explorer 8.