Line 79: |
Line 79: |
| | | |
| If it doesn't run or you have other problems read on. | | If it doesn't run or you have other problems read on. |
| + | |
| === Dealing with dependencies === | | === Dealing with dependencies === |
| | | |
Line 85: |
Line 86: |
| If you notice that there's a package missing from the <code>./sugar-jhbuild depscheck </code> output (i.e. it's required for Sugar to work properly and not installed, but depscheck does not mention it), please [http://dev.sugarlabs.org/newticket?component=sugar-jhbuild&version=Git%20as%20of%20bugdate&type=defect&summary=Need%20package%20%3cinsert%20name%20of%20package%3e%20on%20%3cinsert%20name%20of%20distribution%3e&description=%3cplease%20explain%20why%20you%20think%20the%20package%20is%20required%20%28e.g.%20error%20message%29%3e file a bug report] (login required first, but currently no automatic redirection to login page) against the sugar-jhbuild Component in the [http://dev.sugarlabs.org/ Sugar Labs bug tracker]. | | If you notice that there's a package missing from the <code>./sugar-jhbuild depscheck </code> output (i.e. it's required for Sugar to work properly and not installed, but depscheck does not mention it), please [http://dev.sugarlabs.org/newticket?component=sugar-jhbuild&version=Git%20as%20of%20bugdate&type=defect&summary=Need%20package%20%3cinsert%20name%20of%20package%3e%20on%20%3cinsert%20name%20of%20distribution%3e&description=%3cplease%20explain%20why%20you%20think%20the%20package%20is%20required%20%28e.g.%20error%20message%29%3e file a bug report] (login required first, but currently no automatic redirection to login page) against the sugar-jhbuild Component in the [http://dev.sugarlabs.org/ Sugar Labs bug tracker]. |
| | | |
− | ===Some tips and known issues=== | + | ===Some tips=== |
| + | |
| + | A useful sequence of commands for building Sugar, from the [http://mailman.laptop.org/pipermail/sugar/2007-February/001352.html Sugar mailing list]: (Note that build will update first anyway, so run update separately if you want to see what changed more easily.) |
| + | |
| + | ./sugar-jhbuild update |
| + | ./sugar-jhbuild build -a --clean |
| + | ./sugar-jhbuild run |
| + | |
| + | The use of -a and --clean flags are needed when a file is removed so that autogen.sh is run. '''Note:''' Some packages, e.g., squeak and etoys, don't have a ''make clean''. Just ignore the error. |
| + | |
| + | |
| + | === known issue with hulahop === |
| + | |
| * hulahop stopped building because I had installed a more recent version of xulrunner on my machine. The workaround was to <code>rm -rf ~/sugar-jhbuild/source/hulahop</code> and then run update and build again. | | * hulahop stopped building because I had installed a more recent version of xulrunner on my machine. The workaround was to <code>rm -rf ~/sugar-jhbuild/source/hulahop</code> and then run update and build again. |
| *25 Aug 9: hulahop doesnt' build correctly. http://lists.sugarlabs.org/archive/sugar-devel/2009-August/018540.html The 'fix' is running autoconf. | | *25 Aug 9: hulahop doesnt' build correctly. http://lists.sugarlabs.org/archive/sugar-devel/2009-August/018540.html The 'fix' is running autoconf. |
| ::Question. How do you run autoconf to fix this problem? | | ::Question. How do you run autoconf to fix this problem? |
− | ::: when you get asked because of the error, choose the configure stage | + | ::: when you get asked because of the error, choose the configure stage, or add "-a" to the build / buildone commands |
| + | |
| + | === If build breaks after an update === |
| + | |
| + | The packages in sugar-jhbuild are the latest development versions, so you not only get the latest features, but also the latest breakages. The dependencies may change often, too, so be sure to run |
| + | ./sugar-jhbuild depscheck |
| + | regularly and install the missing packages. |
| + | |
| + | If your problem persists for more than a day (and even though you installed all missing packages), please [http://dev.sugarlabs.org/newticket?component=sugar-jhbuild&version=Git%20as%20of%20bugdate&type=defect&summary=%3cPlease%20enter%20short%20summary%20of%20your%20problem%20here%3e&description=%3cplease%20copy%20exact%20error%20message%20and%20additional%20information%20here%3e file a bug report]. |
| + | |
| | | |
| == Run Sugar == | | == Run Sugar == |
Line 134: |
Line 156: |
| | | |
| ./sugar-jhbuild --help-commands | | ./sugar-jhbuild --help-commands |
− |
| |
− | A useful sequence of commands for building Sugar, from the [http://mailman.laptop.org/pipermail/sugar/2007-February/001352.html Sugar mailing list]: (Note that build will update first anyway, so run update separately if you want to see what changed more easily.)
| |
− |
| |
− | ./sugar-jhbuild update
| |
− | ./sugar-jhbuild build -a --clean
| |
− | ./sugar-jhbuild run
| |
− |
| |
− | The use of -a and --clean flags are needed when a file is removed so that autogen.sh is run. '''Note:''' Some packages, e.g., squeak and etoys, don't have a ''make clean''. Just ignore the error.
| |
− |
| |
− | == If build breaks after an update ==
| |
− |
| |
− | The packages in sugar-jhbuild are the latest development versions, so you not only get the latest features, but also the latest breakages. The dependencies may change often, too, so be sure to run
| |
− | ./sugar-jhbuild depscheck
| |
− | regularly and install the missing packages.
| |
− |
| |
− | If your problem persists for more than a day (and even though you installed all missing packages), please [http://dev.sugarlabs.org/newticket?component=sugar-jhbuild&version=Git%20as%20of%20bugdate&type=defect&summary=%3cPlease%20enter%20short%20summary%20of%20your%20problem%20here%3e&description=%3cplease%20copy%20exact%20error%20message%20and%20additional%20information%20here%3e file a bug report].
| |
| | | |
| == From within Sugar == | | == From within Sugar == |