Title
-Intro
-Setup
--Real Hardware
--Virtual Machine
-Using $AX
-Bugs

$AX OS

User Guide

Intro

Setup

Setting up the $AX OS is a relatively simple task. You first need to choose whether you will be running $AX on real hardware or in a virtual machine.

Real Hardware

Load the floppy image onto the floppy disk and restart your computer. Make sure it boots from floppy in the BIOS menu.

If in doubt about putting a floppy disk image onto a physical floppy disk read from 'Step 5' under 'Building' of the System Guide.

Virtual Machine

This method reduces the risk of potentially ruining the system you have currently installed. If you are unsure, please use this one.
Step 1
Make sure you have your favourite Virtual Machine installed on your system. The one used for developement of $AX is 'Oracle VM VirtualBox'.
Step 2
Setup a new machine that is capable of booting from a floppy disk image. Set the floppy image to load as the the one in the home directory of the latest build.
Step 3
Run the machine with the floppy disk image. $AX should now boot.
Troubleshooting
If $AX fails to boot, please either follow the Virtual Machine's wizard or refer to online/offline documentation to make sure your system is both setup correctly and that you have correctly attatched the floppy disk image to your system.

Using $AX

$AX is an extremely easy to use Operating System that Linux users can operate almost instantly. Typing ls in lowercase prints all the programs and files on the disk - including the empty slots. When you have spotted a program you think you want to run, simply press the escape key. If what you are looking for is not on the current page, press any key to change page.

If when trying to run a program a double explanation mark appears like so !! and replaces the dollar sign ($), it means either the file loaded isn't executable or you have not entered the correct parameters. As of v6, you are now able to use the backspace key to correct your mistakes. In either case, simple type the program in the same case it appears in ls and type after a space and then -h. An example of how to type the program is below:
$ prog -h

If this prints help to the screen then please refer to the program's help for use. If a double explanation mark appears again then the program is not executable. Any questions on this can be sent to danbarry16@googlemail.com.

Bugs

If you are using the OS on either real hardware or a virtual machine and encounter a bug, please feel free to submit a bug in the issues section, along with what the bug is and how we can repeat it. If you think the bug may be specific to your system please also give us the details of your hardware.

Bugs and suggestions can be submitted at http://www.heluxresearch.info.