Help:Starting a new page: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Recipes for buildrom / LinuxBIOS compilation)
 
No edit summary
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
You might expect there to be a "New Page" command, but there isn't.
== Recipes for Buildrom and LinuxBIOS ==


One way to make a new page is to browse to a nonexistent wiki page. The wiki software will then give you the option of editing that page.
This page shows how to do various things related to compiling LinuxBIOS. Many of these were discovered by trial and error, so there may be easier or better ways...


For example, to create a page named "My Wacky Page", enter this URL in your browser:
All paths are relative to the top level "buildrom" directory.


<nowiki>http://wiki.laptop.org/go/My_Wacky_Page</nowiki>
=== How to "make clean" just linuxbios ===
Then click on "edit this page" at the end of the "There is currently no text in this page" message.


After you save your page, be sure to create links to it in related pages. Unreferenced pages can be hard to find. (The syntax for creating links is, for example, <nowiki>[[My Wacky Page]]</nowiki> ).
If you do a "make clean" at the top level of buildrom, it will take a long time to rebuild all of the components. If you just want to clean linuxbios, do this:


You can also do the steps in the opposite order - first create the link on an existing page, then click on that link and edit the new page.
$ make linuxbios-clean


To rename your page, click the move tab and create a new title. The URL for the page changes as well.
You can clean any individual package FOO with "make FOO-clean". Appropriate values for FOO are the
names of the subdirectories of packages/ .

=== Changing the LinuxBIOS Config File ===

The configuration file is in work/linuxbios/LinuxBIOSv2/targets/olpc/rev_a/rev_a/

The currently active one is Config.1M.lb

If you change it, you'll need to do this in order to rebuild properly:

$ make linuxbios-clean
$ make

or you can do it in one line like this:

$ make linuxbios-clean all

=== Getting a new version of Ron's upstream linuxbios code ===

If Jordan has checked in a new version of buildrom that refers to a new LinuxBIOS version from Ron, you can get it with:

$ git pull

(assuming that the parent of your buildrom tree is Jordan's tree).

If you want to try a new version of the upstream code that is not yet reflected in Jordan's tree, you can do this:

Edit packages/linuxbios/linuxbios.mk and change the "LINUXBIOS_VER=nnnn" line, replacing "nnnn" with the LinuxBIOS release number. Then:

$ mv work/linuxbios/LinxBIOSv2 work/linuxbios/LinuxBIOSv2-
$ rm work/linuxbios/stamps/.unpacked*
$ make

=== Finding out what went wrong ===

The "make" output from the top level of buildrom is pleasantly terse. So to find out the details, you need to look in the log files. They can be found in <PACKAGE_NAME>/logs/ . "build.log" is the main one that you're likely to use, but there are also "install.log" and "config.log" files for some of the packages.






--[[User:Wmb@firmworks.com|Wmb@firmworks.com]] 19:05, 15 August 2006 (EDT)

Latest revision as of 03:04, 29 October 2007

You might expect there to be a "New Page" command, but there isn't.

One way to make a new page is to browse to a nonexistent wiki page. The wiki software will then give you the option of editing that page.

For example, to create a page named "My Wacky Page", enter this URL in your browser:

 http://wiki.laptop.org/go/My_Wacky_Page

Then click on "edit this page" at the end of the "There is currently no text in this page" message.

After you save your page, be sure to create links to it in related pages. Unreferenced pages can be hard to find. (The syntax for creating links is, for example, [[My Wacky Page]] ).

You can also do the steps in the opposite order - first create the link on an existing page, then click on that link and edit the new page.

To rename your page, click the move tab and create a new title. The URL for the page changes as well.