Quick instructions for installing the gEDA suite from this CDROM.

1.  Insert the CDROM into your CDROM reader.

2.  At this point, if you are running a system which runs the
    "magicdev" daemon (e.g. RedHat or Fedora), the installer 
    will start automatically.  If this happens, jump to step 5.

3.  If your system doesn't automagically start the installer, mount
    the CDROM (e.g. "mount -o exec -t iso9660 /dev/cdrom /mnt/cdrom").  
    Mounting it with the -o flag set is important for Gentoo and 
    Debian; it allows executables to be run off the CD.

4.  Run the installer: "/mnt/cdrom/installer".  
    --  If you want a log file kept of the install process, invoke 
        "installer" with the "--log" flag.  This will create a 
        file in your current directory called "Install.log" 
        which records what happened during the installation.
        (Note that this works best when you run the installer from
        a directory where you have write permission.)
    --  If you want to see debug messages during the installation 
        process, invoke "installer" with the "--verbose" flag.

5.  A GUI-driven Install Wizard will start up.  It will guide you 
    through the rest of the installation process.  Follow the 
    instructions presented by the installer.  

6.  To start, your system will be checked for the presence of
    some prerequisites, including GNU readline, the pkg-config 
    utility and guile-1.6.4.  If you don't have these
    packages, you will be offered the opportunity to install them.  To
    install them using the install wizard, just type in the root
    password for your machine when you are asked; the installer 
    takes care of everything else.  If you don't want to install 
    them via the Install Wizard, please exit the installer 
    and install the packages manually.

7.  After verifying that the prerequisite packages have been
    installed, you will be asked for the location of the "sources"
    directory.  This is simply the directory where you want to place 
    the source code for compilation.  By default, the installer 
    will place them under your home directory in ${HOME}/geda-sources.  
    Please either accept the default or enter the directory where
    you want the source code to live at the prompt window.

8.  After that, you will be asked for the location of the "install"
    directory.  This is simply the directory where the executables and
    associated libraries should live.  By default, the installer
    will place them under your home directory in 
    ${HOME}/geda-install.  Please either accept the default or enter
    the directory where you wish to place these files at the 
    prompt window.

9.  The install program will then go away and compile all programs in
    the gEDA suite from scratch, and then install them.  This process
    can take more than one hour; be ready to go away and have some
    coffee while this is happening.

    You can monitor the progress of the installation by watching the
    "Installation Log" window.  This window provides a view at the
    commands being executed and the system's output as the installation
    progressses.

    If an error is encountered during installation, you will be 
    prompted about what to do.  You can usually gather an idea about 
    what went wrong by looking at the "Installation Log" window.
    If you elect to continue with the install, the program which 
    errored out will not be installed.  If you install with the 
    "--log" flag set, you can consult the Install.log file, and 
    try to figure out what failed, fix it, and then try installing 
    again, either with the installer or manually.

    Note that if the error is a major one (such as if an important
    library won't build), then the installer will throw up a window
    informing you of an unrecoverable error, and then just die.  In
    this case you have no choice.  Sorry!  But you can always look at
    Install.log to try and figure out what went wrong.

10. Once the installation process is done, you should change your
    $PATH and $LD_LIBRARY_PATH variables to point to the places where
    you placed your executables.  For example, if your install 
    directory was "/home/BillGates/geda", then do this:

    -- For bash:
    export PATH=/home/BillGates/geda/bin:${PATH}
    export LD_LIBRARY_PATH=/home/BillGates/geda/lib:${LD_LIBRARY_PATH}

    -- For csh:
    setenv PATH /home/BillGates/geda/bin:${PATH}
    setenv LD_LIBRARY_PATH /home/BillGates/geda/lib:${LD_LIBRARY_PATH}

    In the best case, you should alter
    your .bashrc or .cshrc files to automatically set these 
    environment variables for you every time you log on.  If you don't
    know how to do this, please contact your system administrator or
    your local Linux guru.

11. Enjoy using the gEDA suite for your electronic design tasks!

Note:  If you wish to halt the installer at any point, just click on 
the "X" in the main popup window's upper right hand corner.