First I have to say that qooxdoo is one of the best browser and platform independent GUI-without-Java-tool. So far I have not seen any other tool with the potential of this one.

Documentation

Checkout from Subversion repository

SVN (Subversion) is a tool used by many software developers to manage changes within their source code tree. SVN provides the means to store not only the current version of a piece of source code, but a record of all changes (and who made those changes) that have occurred to that source code. Use of SVN is particularly common on projects with multiple developers, since SVN ensures changes made by one developer are not accidentally removed when another developer posts their changes to the source tree.

Sourceforge has published some documentation how to use Subversion, too.

Authoritative documentation on Subversion is available here.

When you download a Subversion version, remember that it will overwrite the contents of your local directory. If you don‘t want to overwrite your local copy of qooxdoo, change to a different local directory.

Subversion details

The following configuration settings are used to access the Subversion repository:

• Hostname: svn.
• Port: 443
• Protocol: HTTPS
• Repository Path: /svnroot/qooxdoo
• Username: Your SourceForge.net username for SVN write operations, none will be requested otherwise.
• Password: Your SourceForge.net user password for write operations, none will be requested otherwise.

For SVN checkout you don‘t need to be a registered developer. Using Subversion there is no longer a delay between anonymous and developer access (this is a great new feature compared to the old CVS access at ).

Checkout qooxdoo

Using the command line

Please type in the following to checkout qooxdoo from Subversion:

svn co https://svn./svnroot/qooxdoo/trunk qooxdoo

Using Windows?

To access our subversion repository on Windows, please install TortoiseSVN.

You can download your installer here. There are also some language packs available.

You can download documentation (as PDF) in different languages:

• English
• German

Using OS X?

Any hints? Please feel free to send additions to our mailing list.

The build process

To be able to build a working qooxdoo version from your checkout you need to have the following tools installed in your unix/linux environment (also cygwin for Windows is supported as described below).

• bash
• rsync
• libxslt (seperate xsltproc if not integrated here)
• python (>=2.3)

If you have installed this stuff, please open a new shell, change to the qooxdoo directory and call the following shell script:

$ tools/make.sh

To also create the documentation please call this instead:

$ tools/generate/make-docs.sh

Probably these scripts are not directly executable after checking them out from Subversion. If this is true in your environment, please execute the following first:

$ bash tools/utils/fix-rights.sh

Cygwin

What is Cygwin?

In short, Cygwin is "LINUX under Windows". It is not an emulator and you can‘t use it to run any LINUX-program under Windows, but it makes it possible to run (special compiled) LINUX programs (and shell-scripts) under Windows.

Because qooxdoo uses LINUX shell-scripts you need cygwin to run these scripts.

For more information please have a look at their homepage.

How to download and install Cygwin

This is easy but you must select some special packages to install. If you don‘t select these packages, you will not get a working version of qooxdoo (and you will not get any error message!).

First download the setup-program.

Then run it and select "Install from Internet". At the next page, I recommend to set the "Root directory" to C:\cygwin (if you like it, replace this path at your installation - and in this documentation). At the next page, set the
"Local Package Directory" to whatever you like (or leave the default-value untouched). Then select a download location and wait...

The next step is important! Please use the default selected packages and select additionally these packages:

• Devel
  • subversion
• Lib
  • libxml2
  • libxslt
• Interpreters
  • libxslt
  • python
• Net
  • openssh
  • rsync

Now finish the installation and run the file c:\cygwin\cygwin.bat.
Then you can see something like:

Please have a look at the output (this will differ in your installation!). This output means that your "home-directory" of cygwin is at C:\cygwin\home\VogelOr.
Please remember your path and replace C:\cygwin\home\VogelOr with your path.

Close the cygwin window.

And now:
Congratulations - your computer is "ready" to create a working version of qooxdoo!

Subversion Config Settings

You‘ll need to add a couple of config settings to your SVN config file. If you are on Windows, that‘s located at:

C:\Documents and Settings\YourUserName\Application Data\Subversion\config

And on UNIX/Mac OS X:

~/.subversion/config

Enable auto-props

Open it up in your favorite text editor. Most configs have some default settings, so locate [miscellany] and enable-auto-props in the file. If they exist, make sure that they are uncommented (remove # from beginning of line), otherwise add them. They line should look like:

[miscellany]
enable-auto-props = yes

Configure auto-props

Next, located [auto-props]. If it doesn‘t exist, add it, otherwise you‘ll probably have to uncomment it. Add the following entries below [auto-props]:

*.sh = svn:eol-style=native;svn:executable
*.py = svn:eol-style=native;svn:executable
*.txt = svn:eol-style=native
*.rest = svn:eol-style=native
*.css = svn:eol-style=native
*.xml = svn:eol-style=native
*.xsl = svn:eol-style=native
*.xslt = svn:eol-style=native
*.html = svn:eol-style=native
*.htm = svn:eol-style=native
*.htc = svn:eol-style=native
*.svg = svn:eol-style=native
*.js = svn:eol-style=native
*.png = svn:mime-type=image/png
*.gif = svn:mime-type=image/gif
*.jpg = svn:mime-type=image/jpeg
*.jpeg = svn:mime-type=image/jpeg
Makefile = svn:eol-style=native
README = svn:eol-style=native
CHANGELOG = svn:eol-style=native
LICENSE = svn:eol-style=native
AUTHORS = svn:eol-style=native
RELEASENOTES = svn:eol-style=native
TODO = svn:eol-style=native

Please post questions to our mailinglist.