urbiforge / urbi

   .---------------------------------------------------------------.
   |          _   _      _     _    ____  ____  _  __              |
   |         | | | |_ __| |__ (_)  / ___||  _ \| |/ /              |
   |         | | | | '__| '_ \| |  \___ \| | | | ' /               |
   |         | |_| | |  | |_) | |   ___) | |_| | . \               |
   |          \___/|_|  |_.__/|_|  |____/|____/|_|\_\              |
   |                                                               |
   `---------------------------------------------------------------'

Component Software Platform (Urbi) &
Concurrent Programming Language (urbiscript).

Version:

  This is version 3.0. There might be bits of 2.x references left
  in the doc or in the code, just ignore them (or fix them!).

Documentation:

  * PDF : https://github.com/urbiforge/urbi/blob/master/doc/urbi-sdk.pdf
  * HTML: an online version has been made available at http://urbi.jcbaillie.net/doc

  * Build the doc: ./doc.sh (should be in build-doc folder then)
  * HTML archive version here (just uncompress an open locally):
      https://github.com/urbiforge/urbi/blob/master/doc/urbi-sdk.html.tar.gz

Build Urbi:

 * install the following packages (debian/ubuntu):
	build-essential git-core vim autoconf mlocate wget \
        python python-pip libboost-all-dev default-jdk \
        libssl-dev swig texlive texlive-latex-extra tex4ht

 * pip install qibuild
 * qisrc init && \
   qisrc add https://github.com/urbiforge/libjpeg.git && \
   qisrc add https://github.com/urbiforge/gtest.git   && \
   qisrc add https://github.com/urbiforge/libport.git && \
   qisrc add https://github.com/urbiforge/urbi.git

 * qibuild configure --release --with-debug-info urbi && \
   qibuild make urbi && \
   qibuild install urbi /usr/local

Run Urbi (interactive session):

 * urbi-launch -s

Run Urbi (server):

 * urbi-launch --start -- -i --port 54000
 * and then, from some other shell: 'nc localhost 54000'

 (to preserve command history: rlwrap nc localhost 54000)

Run Urbi docker container:

 * docker run --net host urbiforge/urbi
 * rlwrap nc localhost 54000