Compiling and running

General steps to build jsh:

1. clone this respository: git clone git@github.com:jovanbulck/jo-shell.git
2. change the directory: cd jo-shell
3. execute the Makefile to make a jsh binary in the current directory: make
4. if desired, install a jsh binary in /usr/local/bin/ and man page in /usr/local/share/man/man1/: sudo make install

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

Currently, the provided binaries fail to run for Tiny Core Linux. You have to compile it yourself. Install the necessary packages:

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

BSD UNIX

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

TODO update db ??

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