Sugar on Gentoo Linux: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
 
mNo edit summary
Line 1: Line 1:
==Installation==
==Installation==


It was really easy to get [[Sugar]] goind under gentoo using sugar-jhbuild. The instructions on this page have been tested under Gentoo 2006.1 ~x86
It was really easy to get [[Sugar]] going under gentoo using sugar-jhbuild. The instructions on this page have been tested under Gentoo 2006.1 ~x86




Line 31: Line 31:
cd sugar-jhbuild
cd sugar-jhbuild
git pull
git pull

The sanity checks are still very basic but, often, good information can be gotten from:

./sugar-jhbuild sanitycheck




=== Troubleshooting ===
=== Troubleshooting ===

==== missing db2html ====

You may find that jhbuild complains about missing 'db2html' in which case you will need to create a symlink from docbook2html:

ln -s /usr/bin/docbook2html /usr/bin/db2html



==== missing gconf.def ====
==== missing gconf.def ====

Revision as of 20:01, 5 September 2006

Installation

It was really easy to get Sugar going under gentoo using sugar-jhbuild. The instructions on this page have been tested under Gentoo 2006.1 ~x86


Emerge(1) the prerequisites

There are a number of packages required to get going. All of these, with the exception of jhbuild, are in the portage tree.

emerge -av dev-util/git docbook2html

I may have missed one or two, please add them to this list if you find any!


Getting and building jhbuild

Instructions for getting and installing jhbuild can be found at: http://www.gnome.org/~jamesh/jhbuild.html#getting-started


Using Sugar-jhbuild

Use of Sugar-jhbuild is detailed on building Sugar from sources. To summarize those instructions:

git clone git://dev.laptop.org/sugar-jhbuild
cd sugar-jhbuild
./sugar-jhbuild

If you had already checked out sugar-jhbuild previously, make sure your copy is up-to-date before building:

cd sugar-jhbuild
git pull

The sanity checks are still very basic but, often, good information can be gotten from:

 ./sugar-jhbuild sanitycheck


Troubleshooting

missing db2html

You may find that jhbuild complains about missing 'db2html' in which case you will need to create a symlink from docbook2html:

 ln -s /usr/bin/docbook2html /usr/bin/db2html


missing gconf.def

gnome-python-desktop was complaining about a missing gconf.def:

 IOError: [Errno 2] No such file or directory:
 'sugar-jhbuild/build/share/pygtk/2.0/defs/gconf.defs'

I rectified this with a:

 touch build/share/pygtk/2.0/defs/gconf.defs

and the build completed without problem.


Testing sugar

When using sugar-jhbuild, you can use:

./sugar-jhbuild run

If you want to run Sugar from the source tree enter in a jhbuild shell:

./sugar-jhbuild shell 

Then from the directory sugar-jhbuild/source/sugar), use:

shell/sugar