Compiling and running

General steps to compile jsh:

• clone this respository: git clone git@github.com:jovanbulck/jo-shell.git
• change the directory: cd jo-shell
• execute the Makefile: make

Note: to disable debug info, do one of the following:

• type debug off
• run jsh with the --nodebug option
• include the line "debug off" in ~/.jshrc
• change the initialisation of the DEBUG global variable in jsh.c

jsh uses the GNU Readline library. The following sections list platform specific info to install the dependencies:

Linux

ArchLinux

Install the necessary packages:

$ sudo pacman -S readline

Ubuntu

Install the necessary packages:

$ sudo apt-get install libreadline6-dev

Tiny Core Linux

Install the necessary packages:

$ tce-load -wi git ncurses compiletc readline readline-dev

BSD UNIX

Only Free BSD was tried:

FreeBSD 10.0

1. Install gmake (GNU make) and gcc packages with pkg install
2. Readline should work now; if not try installing readline and/or bash
3. always use gmake instead of make
4. Change the line "CC = gcc" to "CC = gcc48" in the Makefile

Mac OS X

1. Install command line developping tools (gcc, make, ...):

• option 1: install Xcode via the Mac App store
• option 2: only install the command line tools, using this github project

2. Point to right readline library

• Install newest readline library via Homebrew or Macports.

3. Compile with the make command