README

This directory contains the source code for the Xeros operating system
which is a desicated version of the Xinu OS.

To build a Xeros image, type make in this directory. If you want to
launch bochs immediately after the make completes (assuming it is
successful) type "make beros" instead. This command will first build a
Xeros image and then start the bochs emulator.  (You can also go to
the c directory, where the source code you are editing resides, and
run the same make commands there.)

When you run "make", or "make xeros", the first two steps below are
performed. If you run "make beros" then all 3 steps are done.

1. Change to the compile directory and run make

2. If step 1 succeeds, a boot image is built by changing to the boot
directory and running make there. 

3) If step 3 succeeds, bochs is run.

If you simply type make you can, assuming there was a clean make, run
the resulting image by executing the bochs command in this directory
(i.e.  nice bochs)

Once bochs is running, choose option 6 to start the simulation and to
load and run the created image.

##########################################################################

ADDITIONAL COMMENTS

- The keyboard device scan code is mostly and roughly made from from the one
  given in scancodestoASCII.txt file.

- The shell, every command with different number of arguments will be ignored.
  If any signals occur while waiting for a command it will ignore everything
  that the kbd buffer had and the shell will prompt for a command again.
  The same will happen if the buffersize gets full while writing a command.
  All spaces will be ignored, this means "p          " is a valid command.
  The commands won't work with upper cases as it was not specified in the pdf.
  
- The test part in the shell will not perform argument checking. It is only
  used for the testing part and should not mess the original content.

- Uncomment line 8 in <xeroskernel.h>, this will print in the console as well.
  If anything is slow to respond back, use this for testing purporses. should
  not modify anything at all except for printing to the console as well.