Changes

Sugar-jhbuild will automatically download the latest of Sugar's dependencies as well as Sugar itself directly from their source repositories, rather than relying on source packages that may have become stale.

Sugar-jhbuild will automatically download the latest of Sugar's dependencies as well as Sugar itself directly from their source repositories, rather than relying on source packages that may have become stale.

Below are generic instructions on how to use jhbuild to get up and running with Sugar.

Below are generic instructions on how to use jhbuild to get up and running with Sugar.

== Run Sugar ==

== Run Sugar ==

This command launches the Sugar emulator in a nested X session:

This command launches Sugar in a nested X session:

  ./sugar-jhbuild run sugar-emulator

  ./sugar-jhbuild run sugar-emulator

The default size of 800x600 is currently the minimum that should work without issues. I.e. activities should be tested to work in this mode (and in others as well).

The default size of 800x600 is currently the minimum that should work without issues. I.e. activities should be tested to work in this mode (and in others as well).

== Running sugar-emulator in a VNC session ==

== Running sugar in a VNC session ==

Many users and developers have reported problems with running sugar-emulator in xephyr. As an alternatice, you can run sugar emulator inside a VNC session. To accomplish this, install any generic vncviewer package and create a <code>~/.vnc/xstartup</code> file containing the code below:

Many users and developers have reported problems with running sugar-emulator, which uses Xephyr. As an alternatice, you can run sugar inside a VNC session. To accomplish this, install a complete set of VNC packages (both server and client)  and create a <code>~/.vnc/xstartup</code> file containing the code below:

 

#!/bin/sh

#!/bin/sh

exec ~/sugar-jhbuild/sugar-jhbuild run dbus-launch --exit-with-session sugar

exec ~/sugar-jhbuild/sugar-jhbuild run dbus-launch --exit-with-session sugar

 

Now, you may run sugar-emulator by creating a generic VNC session and accessing it using a VNC viewer.

Now, you may run Sugar by creating a VNC session and accessing it using a VNC viewer. E.g.:

== Other commands ==

== Other commands ==