Changes between Initial Version and Version 1 of UsersGuide

Timestamp:

2009-05-01T12:44:57Z (16 years ago)

Author:

Jiri Svoboda

Comment:

For the hapless newbie.

UsersGuide

@@ +1 @@
+= User's Guide =
+
+ 1. [#QuickStart Quick Start]
+ 2. [#Console Console]
+ 3. [#Shell Shell]
+ 4. [#KernelConsole Kernel Console]
+ 5. [#BuildingFromSource Building From Source]
+
+== Quick Start == #QuickStart
+
+To try out HelenOS, download the latest IA-32 ISO image from the [http://www.helenos.org/download download page]. Install [http://www.nongnu.org/qemu/ QEMU]. In the directory where you downloaded the ISO image run
+{{{
+qemu -m 32 -cdrom image.iso
+}}}
+
+You can also use a different emulator. Just make sure it is configured to emulate a Pentium 4 or later CPU or HelenOS won't boot and it will display a red error message.
+
+== Console == #Console
+
+== Shell == #Shell
+
+== Kernel Console == #KernelConsole
+
+== Building From Source == #BuildingFromSource
+
+Checkout the latest sources
+{{{
+svn checkout svn://svn.helenos.org/HelenOS/trunk helenos-trunk
+}}}
+
+Use our script to install a supported cross-compiler toolchain
+{{{
+cd helenos-trunk/contrib/toolchain
+./toolchain.ia32.sh
+}}}
+
+Go to the source root and start the build process
+{{{
+cd ../..
+make
+}}}
+
+Load preconfigured defaults for the platform you want to build for and select ''Done''. HelenOS will now be built.
+
+'''Important note''': If you don't compile using the supported toolchain, your build may well fail.