| 1 | Crules - Multi-Paradigm Programming Language! |
|---|
| 2 | ============================================= |
|---|
| 3 | |
|---|
| 4 | Thanks for taking the time to look at Crules another |
|---|
| 5 | Dynamic Language! Its designed for language embeding |
|---|
| 6 | to be fast and work in a more classical way by allowing |
|---|
| 7 | side effects while remaing 'just works' ethos! Have fun! |
|---|
| 8 | |
|---|
| 9 | test |
|---|
| 10 | |
|---|
| 11 | NOTE: |
|---|
| 12 | ------------ |
|---|
| 13 | For using Xcode in MacOSX or MSVC in Windows @see |
|---|
| 14 | README.cmake. |
|---|
| 15 | |
|---|
| 16 | GETTING THE DEPENDANCIES |
|---|
| 17 | ------------------------ |
|---|
| 18 | |
|---|
| 19 | Debian/Ubuntu: |
|---|
| 20 | % aptitude install build-essential bison flex autoconf \ |
|---|
| 21 | automake libtool libgmp3-dev libmpfr-dev libreadline5-dev \ |
|---|
| 22 | libpcre3-dev |
|---|
| 23 | |
|---|
| 24 | openSuse: |
|---|
| 25 | % yast -i gcc bison flex mpfr-devel gmp-devel pcre-devel |
|---|
| 26 | #autoconf stuff too |
|---|
| 27 | |
|---|
| 28 | Fedora: |
|---|
| 29 | #TODO |
|---|
| 30 | |
|---|
| 31 | openSolaris: |
|---|
| 32 | * Option A: Sun Studio C/C++ compilers |
|---|
| 33 | % pfexec pkg install sunstudio SUNWgnu-mpfr SUNWaconf SUNWgnu-automake110 SUNWlibtool SUNWgnu-mp |
|---|
| 34 | # Optional: using default install of AT&T LEX and YACC or install SUNWflexlex and SUNWbison |
|---|
| 35 | # Choose your weapon: get your favourite editor vim or emacs |
|---|
| 36 | # Finally external repo for readline |
|---|
| 37 | # http://blogs.sun.com/trond/entry/compiling_drizzle_on_opensolaris |
|---|
| 38 | % pfexec pkg set-authority -O http://pkg.opensolaris.org/pending/ pending |
|---|
| 39 | % pfexec pkg install readline5 |
|---|
| 40 | |
|---|
| 41 | *Option B: GCC |
|---|
| 42 | TODO |
|---|
| 43 | |
|---|
| 44 | FreeBSD: |
|---|
| 45 | #TODO |
|---|
| 46 | |
|---|
| 47 | MacOSX: |
|---|
| 48 | % install xcode from your install dvd to get GCC |
|---|
| 49 | % sudo ports install gmp mpfr |
|---|
| 50 | # readline and rest should already be installed from xcode |
|---|
| 51 | |
|---|
| 52 | |
|---|
| 53 | ==================================================== |
|---|
| 54 | |
|---|
| 55 | % sh config/autorun.sh |
|---|
| 56 | % ./configure |
|---|
| 57 | |
|---|
| 58 | !! - useful configure options - !! |
|---|
| 59 | ------------------------------------------------------ |
|---|
| 60 | * --prefix=/usr # default /usr/local |
|---|
| 61 | * --with-debug=yes/no # default no |
|---|
| 62 | * --with-dmalloc=yes/no # default no |
|---|
| 63 | * --with-bignum=yes/no # not implmented yet |
|---|
| 64 | |
|---|
| 65 | @see ./configure --help |
|---|
| 66 | |
|---|
| 67 | % make |
|---|
| 68 | % make install |
|---|
| 69 | |
|---|
| 70 | # plus all the normal gnu style make rules |
|---|
| 71 | % make clean/distclean/dist/maint..... |
|---|
| 72 | |
|---|
| 73 | ------------------------------------------------------ |
|---|
| 74 | |
|---|
| 75 | What now?! |
|---|
| 76 | =================== |
|---|
| 77 | |
|---|
| 78 | @see crules/examples/*.crl |
|---|
| 79 | for some code examples or the testsuite.. |
|---|
| 80 | |
|---|
| 81 | % make test |
|---|
| 82 | isn't implemented yet but some decent test cases have been developed |
|---|
| 83 | |
|---|
| 84 | # you should have an interactive session to crules and your usual |
|---|
| 85 | # bash cmd line editing should be working |
|---|
| 86 | # http://tiswww.case.edu/php/chet/readline/rluserman.html |
|---|
| 87 | |
|---|
| 88 | Debugging |
|---|
| 89 | ================== |
|---|
| 90 | |
|---|
| 91 | If you come into bugs please: |
|---|
| 92 | |
|---|
| 93 | % ./configure --with-debug=yes |
|---|
| 94 | % make clean |
|---|
| 95 | % make |
|---|
| 96 | % ./src/crules |
|---|
| 97 | # reproduce the bug and mail all the stdout/stderr see http://crules.org |
|---|
| 98 | # of where to post and more info on bugs |
|---|
| 99 | |
|---|
| 100 | PORTABILITY & CORRECTNESS |
|---|
| 101 | =========================== |
|---|
| 102 | |
|---|
| 103 | This Subject is VERY important to me, this is why i use autotools to make sure |
|---|
| 104 | things are portable and are tested properly to be as 'correctly' implemented as |
|---|
| 105 | possible. Therefore this code should all be fairly portable i done some work a |
|---|
| 106 | few weeks back |
|---|
| 107 | and it was working on SPARC64 x86_64 MIPS // more to come please test |
|---|
| 108 | as much as you can and any bugs please send straight to http://crules.org |
|---|
| 109 | |
|---|
| 110 | HACKING |
|---|
| 111 | ================= |
|---|
| 112 | |
|---|
| 113 | See HACKING for more details |
|---|
