Fork us on GitHub Follow us on Facebook Follow us on Twitter

Changes between Version 15 and Version 16 of UsersGuide


Ignore:
Timestamp:
2010-06-23T18:12:14Z (11 years ago)
Author:
Jiri Svoboda
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • UsersGuide

    v15 v16  
    11= User's Guide =
    22
    3  1. [#QuickStart Quick Start]
    4  2. [#Console Console]
    5  3. [#TextEditing Text Editing Keys]
    6  3. [#Shell Shell]
    7  4. [#Editor Editor]
    8  4. [#KernelConsole Kernel Console]
    9  5. [#BuildingFromSource Building From Source]
     3=== [UsersGuide/QuickStart Quick Start] ===
     4=== [UsersGuide/Console Console] ===
     5=== [UsersGuide/TextEditing Text Editing Keys] ===
     6=== [UsersGuide/Shell Shell] ===
     7=== [UsersGuide/Editor Editor] ===
     8=== [UsersGuide/KernelConsole Kernel Console] ===
    109
    11 == Quick Start == #QuickStart
    12 
    13 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
    14 {{{
    15 qemu -m 32 -cdrom image.iso
    16 }}}
    17 
    18 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.
    19 
    20 == Console == #Console
    21 
    22 Press the F1-F11 keys to switch between individual virtual consoles. Pressing F12 will take you to the kernel console. You can also switch keyboard layouts with Ctrl-Shift-Fn strokes as follows:
    23 
    24 || '''Keystroke''' || '''Layout''' ||
    25 || Ctrl-Shift-F1   || US QWERTY    ||
    26 || Ctrl-Shift-F2   || US Dvorak    ||
    27 || Ctrl-Shift-F2   || Czech QWERTZ    ||
    28 
    29 == Text Editing Keys == #TextEditing
    30 
    31 Whenever you are prompted to enter or edit some text, you can use the same common base set of control keys. These should be quite familiar to you as they are similar to the keys used in popular desktop environments.
    32 
    33 || '''Keystroke'''  || '''Action''' ||
    34 || Enter            || Submit or insert end-of-line ||
    35 || Backspace        || Delete character to the left of cursor (or delete selection) ||
    36 || Delete           || Delete character under cursor (or delete selection) ||
    37 || Left Arrow       || Move cursor left by one character ||
    38 || Right Arrow      || Move cursor right by one character ||
    39 || Home             || Move cursor to beginning of text ||
    40 || End              || Move cursor to end of text ||
    41 || Ctrl-Left Arrow  || Move cursor left by one word ||
    42 || Ctrl-Right Arrow || Move cursor right by one word ||
    43 || Shift-''movement'' || Select text ||
    44 || Ctrl-A             || Select all ||
    45 || Ctrl-C             || Copy selection to clipboard ||
    46 || Ctrl-X             || Cut selection to clipboard ||
    47 || Ctrl-V             || Paste from clipboard ||
    48 
    49 == Shell == #Shell
    50 
    51 Type ''help'' (+Enter) to get a list of built-in commands.
    52 
    53 The shell supports [#TextEditing common text-editing controls]. In addition to that the following controls are defined:
    54 
    55 || '''Keystroke'''  || '''Action''' ||
    56 || Enter            || Submit and execute the command ||
    57 || Up Arrow         || Move to older history entry ||
    58 || Down Arrow       || Move to newer history entry ||
    59 
    60 (''Trunk Only'') Other command-line driven applications (e.g. SBI) support exactly the same controls as the shell. (The command-line input is implemented in a common library called CLUI).
    61 
    62 == Text Editor (''Trunk only'') == #Editor
    63 
    64 Started with the {{{edit}}} command. The editor supports [#TextEditing common text-editing controls] and in addition, the following controls are defined:
    65 
    66 || '''Keystroke'''  || '''Action''' ||
    67 || Enter            || Insert line break ||
    68 || Up Arrow         || Move cursor one line up ||
    69 || Down Arrow       || Move cursor one line down ||
    70 || Page Up          || Move cursor up by one page ||
    71 || Page Down        || Move cursor down by one page ||
    72 || Ctrl-Q           || Quit ||
    73 || Ctrl-S           || Save ||
    74 || Ctrl-E           || Save As ||
    75 
    76 == Kernel Console == #KernelConsole
    77 
    78 The kernel console is controlled via a command line. The ''continue'' command will take you back to the user-space console. ''help'' will show a list of commands. The command line supports completion (Tab key) and history (up and down arrow keys).
    79 
    80 == Building From Source == #BuildingFromSource
    81 
    82 Checkout the latest sources from our central Bazaar repository
    83 
    84 {{{
    85 bzr checkout bzr://bzr.helenos.org/mainline HelenOS
    86 }}}
    87 
    88 ''Note:'' To get versions older than 0.4.1 you have to access the original Subversion repository
    89 
    90 {{{
    91 svn checkout svn://svn.helenos.org/HelenOS/trunk HelenOS
    92 }}}
    93 
    94 Use our script to install a supported cross-compiler toolchain
    95 
    96 {{{
    97 cd HelenOS/tools
    98 ./toolchain.sh ia32
    99 }}}
    100 
    101 '''Note:''' In older revisions of the source tree the ''toolchain.sh'' script has present in the ''contrib'' directory (not the ''tools'' directory where it is now).
    102 
    103 Go to the source root and start the build process
    104 
    105 {{{
    106 cd ../..
    107 make
    108 }}}
    109 
    110 Load preconfigured defaults for the platform you want to build for and select ''Done''. HelenOS will now be built.
    111 
    112 '''Important note''': If you don't compile using the supported toolchain, your build may well fail.
     10== Advanced Topics ==
     11=== [UsersGuide/CompilingFromSource Compiling From Source] ===