README

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

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!).

This version builds with modern (2023) environments (tested with boost 1.80 and 1.82).

Documentation:

  * PDF : https://github.com/urbiforge/urbi/blob/master/doc/urbi-sdk.pdf

  * 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 \
        python3 python3-pip libboost-all-dev default-jdk \
        libssl-dev swig texlive texlive-latex-extra tex4ht

 * git clone https://github.com/urbiforge/urbi.git urbi
   cd urbi
   git submodule update --init
   cmake -Bbuild . -DCMAKE_BUILD_TYPE=RELEASE -DCMAKE_INSTALL_PREFIX=/usr/local
   cmake --build build --config Release
   cmake --install build --config Release

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

Build with clang, libc++, cxx17:

     qibuild configure --release --with-debug-info urbi -D CMAKE_C_COMPILER=clang -D CMAKE_CXX_COMPILER=clang++ -D CMAKE_CXX_STANDARD=17 -D CMAKE_CXX_FLAGS='-stdlib=libc++ -fno-delete-null-pointer-checks'