Changes

<noinclude>{{Translations}}{{GoogleTrans-en}}{{TOCright}}</noinclude>

<noinclude>{{Translations}}{{GoogleTrans-en}}{{TOCright}}</noinclude>

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.

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.

==Compatible Platforms==

==Compatible platforms==

Jhbuild is quite demanding with regard to the packages and setup for the host Linux distribution. As a result there are only a few Linux distributions which are known to work with it.

Jhbuild is quite demanding with regard to the packages and setup for the host Linux distribution. As a result there are only a few Linux distributions which are known to work with it.

See the distribution specific instructions for information about whether your distribution is currently supported. Other distros which have a recent-enough release (e.g. including the latest stable GNOME release) can be supported if someone is willing to maintain the dependencies for that distro release (in config/sysdeps).

See the distribution-specific instructions for information about whether your distribution is currently supported. Other distros which have a recent-enough release (e.g. including the latest stable GNOME release) can be supported if someone is willing to maintain the dependencies for that distro release (in config/sysdeps).

==Check distro-specific instructions==

==Check distro-specific instructions==

definitely do not compile as root with jhbuild -- you'll run into funky problems -- Colin A. :)

definitely do not compile as root with jhbuild -- you'll run into funky problems -- Colin A. :)

==Prequisites==

==Prerequisites==

; python

; python

: The sugar-jhbuild command is a Python script, so you need the Python interpreter.

: The sugar-jhbuild command is a Python script, so you need the Python interpreter.

== Run Sugar ==

== Run Sugar ==

This command launches the Sugar emulator:

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

  ./sugar-jhbuild run

  ./sugar-jhbuild run

To exit the emulator, press Alt-Q.

To exit the emulator, press Alt-Q.

Note that due to a [http://dev.sugarlabs.org/ticket/342 bug in Xephyr] your keyboard might not work as expected. A partial workaround is to run <code>setxkbmap &lt;keymap name&gt;</code> in <code>~/.sugar/debug</code> (this file will be created on first run of Sugar). Most "regular" keys should work fine after that, some "special keys" (e.g. cursor up/down) might still refuse to operate as intended.

 

Note that due to a [http://dev.sugarlabs.org/ticket/342 bug in Xephyr] your keyboard might not work as expected. A partial workaround is to run <code>setxkbmap &lt;keymap name&gt;</code> by adding this command line to <code>~/.sugar/debug</code>. Most "regular" keys should work fine after that, some "special keys" (e.g. cursor up/down) might still refuse to operate as intended.

The "keymap name" usually is a two letter country code, e.g. "de" for german or "fr" for french.

The "keymap name" usually is a two letter country code, e.g. "de" for german or "fr" for french.

== Running multiple instances ==

== Running multiple instances ==

To run multiple instances of sugar you can start it in the following way:

To run an additional instance of sugar, you can start the second instance in the following way:

  SUGAR_PROFILE=2 ./sugar-jhbuild run

  SUGAR_PROFILE=2 ./sugar-jhbuild run

[[Category:Installing Sugar]]

[[Category:Installing Sugar]]

[[Category:Jhbuild]]

[[Category:Jhbuild]]nested in