README

DISCLAIMER
----------

   THE AUTHORS OF THIS LIBRARY ACCEPT ABSOLUTELY NO LIABILITY FOR
    ANY HARM OR LOSS RESULTING FROM ITS USE.  IT IS _EXTREMELY_ UNWISE
    TO RELY ON SOFTWARE ALONE FOR SAFETY.  Any machinery capable of
    harming persons must have provisions for completely removing power
    from all motors, etc, before persons enter any danger area.  All
    machinery must be designed to comply with local and national safety
    codes, and the authors of this software can not, and do not, take
    any responsibility for such compliance.


The Build Process
-----------------

Refer to the file 'docs/INSTALL' for information about building and 
running the software.
    

Directory Layout
----------------

The directory tree for LinuxCNC is documented in 'directory.map' in the
top level directory.


    COPYING - this software is released under the GPL, 
              with some parts under the LGPL

Please also see the files in docs/

    README  - general information
    INSTALL - information about compiling and installing the software
    AUTHORS - information about authors
    NEWS    - latest news


Quickstart:
-----------

From the top level directory, switch to the source directory:

  cd src

In the source directory, build LinuxCNC:

  ./autogen.sh
  ./configure
  [or, if you do not have a realtime kernel:]
  ./configure --enable-simulator

  make clean
  make
  sudo make setuid

to run the software go back to the top level directory, and issue:

  . scripts/rip-environment
  linuxcnc