...

manual/faq.rst

@@ -649,20 +649,24 @@ If it still wont launch, start a command prompt (press the windows key and R; th
 
 Post any output you see in a help message on the `Forum <http://www.mobileread.com/forums/forumdisplay.php?f=166>`_.
 
-|app| freezes when I click on anything?
+|app| freezes/crashes occasionally?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 There are three possible things I know of, that can cause this:
 
-    * You recently connected an external monitor or TV to your computer. In this case, whenever |app| opens a new window like the edit metadata window or the conversion dialog, it appears on the second monitor where you dont notice it and so you think |app| has frozen. Disconnect your second monitor and restart calibre.
+    * You recently connected an external monitor or TV to your computer. In
+      this case, whenever |app| opens a new window like the edit metadata
+      window or the conversion dialog, it appears on the second monitor where
+      you dont notice it and so you think |app| has frozen. Disconnect your
+      second monitor and restart calibre.
 
-    * You are using a Wacom branded mouse. There is an incompatibility between Wacom mice and the graphics toolkit |app| uses. Try using a non-Wacom mouse.
+    * You are using a Wacom branded mouse. There is an incompatibility between
+      Wacom mice and the graphics toolkit |app| uses. Try using a non-Wacom
+      mouse.
 
     * If you use RoboForm, it is known to cause |app| to crash. Add |app| to
-      the blacklist of programs inside RoboForm to fix this.
+      the blacklist of programs inside RoboForm to fix this. Or uninstall
-
+      RoboForm.
-    * Sometimes if some software has installed lots of new files in your fonts folder, |app| can crash until it finishes indexing them. Just start |app|, then leave it alone for about 20 minutes, without clicking on anything. After that you should be able to use |app| as normal.
-
 
 |app| is not starting on OS X?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

setup/installer/windows/freeze.py

@@ -14,10 +14,9 @@ from setup.build_environment import msvc, MT, RC
 from setup.installer.windows.wix import WixMixIn
 
 ICU_DIR = r'Q:\icu'
-OPENSSL_DIR = r'Q:\openssl'
+OPENSSL_DIR = os.environ.get('OPENSSL_DIR', r'Q:\openssl')
-QT_DIR = 'Q:\\Qt\\4.8.2'
+QT_DIR = os.environ.get('QT_DIR', 'Q:\\Qt\\4.8.2')
 QT_DLLS = ['Core', 'Gui', 'Network', 'Svg', 'WebKit', 'Xml', 'XmlPatterns']
-QTCURVE = r'C:\plugins\styles'
 LIBUNRAR         = 'C:\\Program Files\\UnrarDLL\\unrar.dll'
 SW               = r'C:\cygwin\home\kovid\sw'
 IMAGEMAGICK      = os.path.join(SW, 'build', 'ImageMagick-6.7.6',

setup/installer/windows/notes.rst

@@ -46,14 +46,17 @@ In a cygwin terminal do:
 ssh-host-config -y
 net start sshd
 
-Pass port 22 through Windows firewall. Create .ssh/authorized_keys
+Pass port 22 through Windows firewall. Create ~/.ssh/authorized_keys
 
-Add VS90COMNTOOLS to ~/.bash_profile
+After installing python run::
+    python setup/vcvars.py && echo 'source ~/.vcvars' >> ~/.bash_profile
+
+To allow you to use the visual studio tools in the cygwin ssh shell.
 
 Basic dependencies
 --------------------
 
-Install cmake, python, WiX
+Install cmake, python, WiX (WiX is used to generate the .msi installer)
 
 You have to 
 
@@ -115,7 +118,7 @@ First install ActiveState Perl if you dont already have perl in windows
 
 Then, get nasm.exe from
 http://www.nasm.us/pub/nasm/releasebuilds/2.05/nasm-2.05-win32.zip and put it
-somewhere on your PATH (I chose C:\Program Files (x86)/Microsoft Visual Studio 9.0/VC/bin/)
+somewhere on your PATH (I chose ~/sw/bin)
 
 Download and untar the openssl tarball, follow the instructions in INSTALL.(W32|W64)
 to install use prefix q:\openssl
@@ -131,13 +134,17 @@ For 64-bit::
     perl Configure VC-WIN64A no-asm enable-static-engine --prefix=C:/cygwin/home/kovid/sw/private/openssl
     ms\do_win64a
     nmake -f ms\ntdll.mak
+    nmake -f ms\ntdll.mak test
+    nmake -f ms\ntdll.mak install
 
 Qt
 --------
+Download Qt sourcecode (.zip) from: http://qt-project.org/downloads
+Extract Qt sourcecode to C:\Qt\current
 
-Extract Qt sourcecode to C:\Qt\4.x.x. 
+Qt uses its own routine to locate and load "system libraries" including the
-
+openssl libraries needed for "Get Books". This means that we have to apply the
-Qt uses its own routine to locate and load "system libraries" including the openssl libraries needed for "Get Books". This means that we have to apply the following patch to have Qt load the openssl libraries bundled with calibre:
+following patch to have Qt load the openssl libraries bundled with calibre:
 
 
 --- src/corelib/plugin/qsystemlibrary.cpp	2011-02-22 05:04:00.000000000 -0700
@@ -156,7 +163,7 @@ Now, run configure and make::
 
 -no-plugin-manifests is needed so that loading the plugins does not fail looking for the CRT assembly
 
-    configure -ltcg -opensource -release -qt-zlib -qt-libmng -qt-libpng -qt-libtiff -qt-libjpeg -release -platform win32-msvc2008 -no-qt3support -webkit -xmlpatterns -no-phonon -no-style-plastique -no-style-cleanlooks -no-style-motif -no-style-cde -no-declarative -no-scripttools -no-audio-backend -no-multimedia -no-dbus -no-openvg -no-opengl -no-qt3support -confirm-license -nomake examples -nomake demos -nomake docs -no-plugin-manifests -openssl -I Q:\openssl\include -L Q:\openssl\lib && nmake
+    configure -ltcg -opensource -release -qt-zlib -qt-libmng -qt-libpng -qt-libtiff -qt-libjpeg -release -platform win32-msvc2008 -no-qt3support -webkit -xmlpatterns -no-phonon -no-style-plastique -no-style-cleanlooks -no-style-motif -no-style-cde -no-declarative -no-scripttools -no-audio-backend -no-multimedia -no-dbus -no-openvg -no-opengl -no-qt3support -confirm-license -nomake examples -nomake demos -nomake docs -no-plugin-manifests -openssl -I $OPENSSL_DIR/include -L $OPENSSL_DIR/lib && nmake
 
 Add the path to the bin folder inside the Qt dir to your system PATH.
 

setup/vcvars.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python
+# vim:fileencoding=UTF-8:ts=4:sw=4:sta:et:sts=4:fdm=marker:ai
+from __future__ import (unicode_literals, division, absolute_import,
+                        print_function)
+
+__license__   = 'GPL v3'
+__copyright__ = '2012, Kovid Goyal <kovid at kovidgoyal.net>'
+__docformat__ = 'restructuredtext en'
+
+import os
+from distutils.msvc9compiler import MSVCCompiler
+
+c = MSVCCompiler()
+orig_path = os.environ['path']
+c.initialize()
+paths = c._MSVCCompiler__paths
+lib = os.environ['lib'].split(';')
+include = os.environ['include'].split(';')
+
+def unix(paths):
+    up = []
+    for p in paths:
+        prefix, p = p.replace(os.sep, '/').partition('/')[0::2]
+        up.append('/cygdrive/%s/%s'%(prefix[0].lower(), p))
+    return ':'.join(up)
+
+raw = '''\
+#!/bin/sh
+
+export PATH="%s:$PATH"
+export LIB="%s"
+export INCLUDE="%s"
+'''%(unix(paths), ';'.join(lib), ';'.join(include))
+
+with open(os.path.expanduser('~/.vcvars'), 'wb') as f:
+    f.write(raw.encode('utf-8'))
+