debian
doc
examples
guiserver
modules
newlisp-js
qa-specific-tests
util
Makefile
README
makefile_aixILP32_utf8_gcc
makefile_aixLP64_utf8_gcc
makefile_aixLP64_utf8_xlc
makefile_aix_utf8_gcc
makefile_aix_utf8_xlc
makefile_amal_darwin_utf8_ffi
makefile_bsd
makefile_bsdLP64
makefile_bsdLP64_utf8
makefile_bsdLP64_utf8_ffi
makefile_bsdLP64_utf8_lib
makefile_bsd_lib
makefile_bsd_utf8
makefile_bsd_utf8_ffi
makefile_bsd_utf8_lib
makefile_cygwin
makefile_cygwinLP64
makefile_darwin
makefile_darwinLP64
makefile_darwinLP64_utf8
makefile_darwinLP64_utf8_ffi
makefile_darwinLP64_utf8_lib
makefile_darwin_package
makefile_darwin_universal_utf8_compat
makefile_darwin_utf8
makefile_darwin_utf8_ffi
makefile_darwin_utf8_leopardIntel
makefile_darwin_utf8_leopardIntel_ffi
makefile_darwin_utf8_leopardPPC
makefile_darwin_utf8_leopardPPC_ffi
makefile_darwin_utf8_lib
makefile_emscripten_lib_utf8
makefile_linux
makefile_linuxLP64
makefile_linuxLP64_ffi
makefile_linuxLP64_lib
makefile_linuxLP64_redhat_utf8_ffi
makefile_linuxLP64_utf8
makefile_linuxLP64_utf8_ffi
makefile_linux_ffi
makefile_linux_lib
makefile_linux_lib_utf8
makefile_linux_maemo_utf8
makefile_linux_openwrt
makefile_linux_redhat_utf8_ffi
makefile_linux_utf8
makefile_linux_utf8_ffi
makefile_mingw
makefile_mingw64
makefile_mingw64_ffi
makefile_mingw64_utf8
makefile_mingw64_utf8_ffi
makefile_mingw64dll
makefile_mingw64dll_ffi
makefile_mingw64dll_utf8
makefile_mingw64dll_utf8_ffi
makefile_mingw_ffi
makefile_mingw_utf8
makefile_mingw_utf8_ffi
makefile_mingwdll
makefile_mingwdll_ffi
makefile_mingwdll_utf8
makefile_mingwdll_utf8_ffi
makefile_netbsd
makefile_netbsd_utf8
makefile_opensolaris
makefile_original_install
makefile_os2
makefile_raspberrypi
makefile_raspberrypi_utf8
makefile_sunos
makefile_sunosLP64
makefile_sunosLP64_utf8
makefile_sunos_utf8
makefile_tru64
makefile_wings
makefile_wings64
newlisp.c
newlisp.h
nl-debug.c
nl-filesys.c
nl-import.c
nl-list.c
nl-liststr.c
nl-math.c
nl-matrix.c
nl-sock.c
nl-string.c
nl-symbol.c
nl-utf8.c
nl-web.c
nl-xml-json.c
pcre-chartables.c
pcre-config.h
pcre-internal.h
pcre.c
pcre.h
primes.h
protos.h
unix-lib.c
win-dll.c
win-dll.def
win-ffi.h
win-path.c
win-util.c
win64-dll.def
configure
configure-alt
index.cgi
qa-comma
qa-dot
README
newLISP version 10.x.x for LINUX, FreeBSD, Mac OSX Solaris and Win32
===================================================================


INTRODUCTION
------------
newLISP(tm) is LISP like scripting language for general programming
artificial intelligence and statistics. 

For more details about newLISP see the Users Manual and Reference in the
distribution file: 'doc/newlisp_manual.html' 

Code contributions, bug fixes, reports and comments are welcome. New
versions are available at:

    http://newlisp.org
      or
    http://newlisp.org/downloads
      or
    http://sourceforge.net/projects/newlisp

See the file doc/CHANGES in the source distribtion for changes over 
previous versions or

    http://newlisp.org/downloads/newLISP_xx_Release_Notes.html

New versions in development are available at:

    http://newlisp.org/downloads/development

Please contact me via email at: lutz@nuevatec.com.

Some of the information in this file is expanded in file newlisp-x.x.x/doc/INSTALL.


BUILD, CHECK and INSTALL
------------------------

Normally the correct makefile_xxxxx will be picked automatically just typing: 

  make

to discover the current platform and make for Linux, MacOSX, FreeBSD, OpenBSD,
NetBSD, Solaris/SunOS and Win32 (MinGW on MSYS). Sometimes the makefile_xxxxx
must be specified explicitely, e.g. when compiling for the RaspberryPi runnning
a sub-flavor of Linux and cross-compiled on a desktop system:

  make -f makefile_raspberrypi

Any other makefile_xxxxx can be picked the same way, but always read the
makefile_xxxxx first, sometimes it contains special instructions!

To test the compiled newlisp executable do:

  make check

or showing only success or failure:

  make testall

From a user account if the sudo command and admin password is available:

  sudo make install

If root permissions are not available:

  make install_home

home_install does not install the newLISP-GS Java based IDE, but installs
the supportig documentation.

see all flavors and platforms available for install:

  make help

will list all available platforms and flavors, newLISP can also be made as
a shared, dhynamic library: newlisp.so, newlisp.dylib or  newlisp.dll

To discover the platform in an extra step do:

  ./configure

  make

this discovers the platform and generates a makefile_build which
is used subsequently by make. As an alternative use:

  ./configure-alt

  make

this does a more elaborate analysys of options supported on a specific
platform and custom makes a makefile_build.

See the files doc/INSTALL, doc/LOCALIZATION and doc/FILES for more
detailed information.

MINIMUM INSTALL
---------------
Note that for a minumum install only the executable newlisp or newlisp.exe
in Win32 is necessary.

On Mac OS X or other UNIX copy  newlisp to /usr/local/bin or /usr/bin or ~/bin 
and give it executable permissions.


LICENSE
-------
newLISP and Nuevatec are trademarks of Lutz Mueller. Files in the newLISP
distribution are protected by the "GNU General Public License Version 3, June 2007". 
For the full text of this license see the accompanying file COPYING in the doc
directory, or the appendix in the file newlisp_manual.html. Documentation files
are protected by the "GNU Free Doumentation License Version 1.2, November 2002".
A copy of this license is also included in the file COPYING.

This and information about lcensing from other contributors to newLISP is
contained in the file COPYING in the source distribution.


MORE INFO AND CONTACT
---------------------
See in the doc/ directory of the source distribution

lutz@nuevatec.com

last edit February 2013

                                  +++