1QBrew Installation
2===================
3
4These instructions are for building and installing QBrew from source
5code. QBrew requires the Qt 4.3 or greater development libraries. These
6can be found at <http://www.trolltech.com>. Some Linux distributions
7separate Qt into separate runtime and development packages. If this
8is your case, Make sure you have both. QBrew uses the qmake tool to
9generate makefiles, and thus depends on a properly configured Qt
10installation.
11
12Note that I am not providing installation support for QBrew, and will
13consider such a submission to be a bug report as opposed to a support
14request. I can be contacted at <david@usermode.org>.
15
16Sincerely,
17David Johnson
18
19Unix Build
20==========
21
220) Make sure the prerequisite Qt library is installed.
23
241) Unarchive the source code package, and change into its directory.
25
262) Type './configure --help", and peruse the configure options available.
27   It may be necessary to use one or more of these options on your system.
28
293) Type './configure' to configure the package for your system. If you're
30   using `csh', you might need to type `sh ./configure' instead.
31
324) Type 'make' to compile the package.
33
345) Login, su or sudo to root. This is not necessary if you
35   configured the package to install to your home directory.
36
376) Type 'make install' to install the program and documentation.
38
397) Type `qbrew' to run the program.
40
41Mac OSX Build
42=============
43
440) Make sure the prerequisite Qt library is installed.
45
461) Unarchive the source code package, and change into its directory.
47
482) Set Qt related environment variables (assumes bash shell):
49       QTDIR=/Developer/qt (or as appropriate)
50       QMAKESPEC=macx-g++
51       PATH=$PATH:$QTDIR/bin
52       export QTDIR QMAKESPEC PATH
53
543) Build the package:
55       qmake -o Makefile qbrew.pro
56       make
57
584) Populate the application bundle
59        make install
60
615) You may wish to include the Qt runtime with the application bundle. Please
62   see the "Deploying on Application on Qt/Mac" article for more information.
63   A deployment script is included in the mac directory, that may be useful.
64
656) Now move the application bundle to your desired location
66        mv qbrew.app ~/Desktop
67
68Windows Build
69=============
70
710) Make sure the prerequisite Qt library is installed.
72
731) Unarchive the source code package, and change into its directory.
74
752) Build the package:
76       qmake qbrew.pro
77       make (or nmake)
78
794) Place into a final installation directory, with the following minimum
80   structure:
81       qbrew.exe
82       splash.png
83       datafile
84       doc\html\* (all html help files)
85       translations\* (all qm files)
86
875) You may also wish to include the Qt DLL and other runtime libraries in the
88   installation directory.
89