1
- BINARY INSTALL, BUILD, TOOLS, LOCALIZING (last updated 2011-11-14
1
+ BINARY INSTALL, BUILD, TOOLS, LOCALIZING (last updated 2019-02-22)
2
2
-------------------------------------------------------------------
3
3
4
4
CONTENTS
5
5
6
- (1) WIN32 BINARY DISTRIBUTION INSTALLATION
7
- (2) Mac OS X BINARY DISTRIBUTION INSTALLATION
8
- (3) UBUNTU Linux DEBIAN DISTRIBUTION INSTALLATION
9
- (4) MINIMUM INSTALL
10
- (5) BUILD, TEST AND INSTALL newLISP FROM SOURCE
11
- (6) COMMENTS FOR COMPILING AND LINKING
12
- (7) LOCALIZATION
13
- (8) UNINSTALL
14
- (9) RUNNING newLISP IN A SHELL OR CONSOLE WINDOW
15
- (10) RUNNING THE newLISP-GS GRAPHICAL FRONTEND
16
- (11) INSTRUCTIONS FOR CUSTOMIZED INSTALL AND PACKAGE CREATORS
17
- (12) COMMENTS ABOUT LIBFFI
6
+ (1) MINIMUM INSTALL
7
+ (2) BUILD, TEST AND INSTALL newLISP FROM SOURCE
8
+ (3) UNINSTALL
9
+ (4) COMMENTS FOR COMPILING AND LINKING
10
+ (5) LOCALIZATION
11
+ (6) RUNNING newLISP IN A SHELL OR CONSOLE WINDOW
12
+ (7) COMMENTS ABOUT LIBFFI
18
13
19
14
20
- (1) WIN32 BINARY DISTRIBUTION INSTALLATION
21
- ------------------------------------------
22
-
23
- The Win32 binary distribution comes packed as a Win32 installer
24
- application. After downloading a file:
25
-
26
- newlisp-xxxx-win-gs-xxx.exe
27
-
28
- double click on the downloaded file and follow instructions. xxxx and xxx
29
- are the version numbers for newLISP and the newLISP-GS the GUI frontend.
30
- On Win32 a ASCII version of newlisp.exe capable of ISO/IEC 8859 code pages
31
- is installed. A UTF-8 capable version is available from the newlisp download
32
- directory at: http://www.newlisp.org/downloads/UTF-8_win32/
33
-
34
-
35
- (2) Mac OS X BINARY DISTRIBUTION INSTALLATION
36
- ---------------------------------------------
37
-
38
- After downloading double-click on the Mac OS X disk image file:
39
-
40
- newlisp-xxxx-ppc.dmg # for older PPC type Macs
41
- or
42
- newlisp-xxxx-intel.dmg # since at least end of 2007
43
-
44
- This installs an applications icon in the Mac OS X Applications folder.
45
- On Mac OS X a UTF-8 capable version is installed by default. On both,
46
- Intel and PPC architectures Mac OS X v10.5 Leopard is minimum.
47
-
48
-
49
- (3) UBUNTU Linux DEBIAN DISTRIBUTION INSTALLATION
50
- -------------------------------------------------
51
-
52
- Double click the file:
53
-
54
- newlisp-xxxx-x_i386.deb
55
- or
56
- newlisp-xxxx-utf8_i386.deb
57
-
58
- This will bring up the debian installer application.
59
-
60
- On some UBUNTU libraries libreadline and libffi may have to be installed
61
- when making from source:
62
-
63
- sudo apt-get install libreadline6 libreadline6-dev
64
- and
65
- apt-get install libffi-dev
66
-
67
-
68
- (4) MINIMUM INSTALL
15
+ (1) MINIMUM INSTALL
69
16
-------------------
70
17
71
- For a minumum install, only the executable file: newlisp (or newlisp.exe
72
- on Win32) needs to be moved to a directory in the executable path, i.e.
73
- /usr/local/bin/newlisp on Unix. No other files are required. This installation
74
- is recommended for ISPs and other server installations. If modules are
75
- installed the environment NEWLISPDIR should be defined to point to
18
+ For a minumum install, only the executable file, newlisp iin on UNIX like
19
+ operating systems or newlisp.exe on Win32/64, needs to be moved to a directory
20
+ in the executable path, i.e. /usr/local/bin/newlisp on Unix.
21
+ No other files are required.
22
+
23
+ If modules are installed the environment NEWLISPDIR can be defined to point to
76
24
the modules parent directory. If NEWLISPDIR is not defined, newLISP sets
77
- it to /usr/local/share/newlisp during startup.
25
+ it to /usr/local/share/newlisp during startup on MacOS, Linux, BADs and other
26
+ UNIX.
78
27
79
28
To reduce an exisiting UNIX install to a minimum installation, remove all
80
29
files in /usr/share/newlisp and /usr/local/share/doc/newlisp and the executable
@@ -85,7 +34,7 @@ Applications folder. On Windows remove all file except newlisp.exe in
85
34
C:/Program Files/newlisp.
86
35
87
36
88
- (5 ) BUILD AND INSTALL newLISP FROM SOURCE
37
+ (2 ) BUILD AND INSTALL newLISP FROM SOURCE
89
38
-----------------------------------------
90
39
91
40
Un-tar/gunzip the distribution file newlisp_9.x.x.tgz :
@@ -131,7 +80,22 @@ Using 'make testall' or 'make checkall' more tests and a speed
131
80
benchmark are performed.
132
81
133
82
134
- (6) COMMENTS FOR COMPILING AND LINKING
83
+ (3) UNINSTALL
84
+ -------------
85
+
86
+ On MacOS, Linux, BSDs and other UNIX:
87
+
88
+ sudo make uninstall
89
+
90
+ or if installed with: make install_home
91
+
92
+ make uninstall_home
93
+
94
+ To manually uninstall on Windows remove all files in
95
+ c:\Program files\newlisp
96
+
97
+
98
+ (4) COMMENTS FOR COMPILING AND LINKING
135
99
--------------------------------------
136
100
137
101
If skipping the ./configure step and just doing make, the
@@ -147,13 +111,7 @@ make file manually or use configure-alt.
147
111
148
112
If compiling with READLINE fails on Linux , it may be due to missing
149
113
readline.h and history.h include files. In this case the package
150
- 'libreadline5-dev' has to be installed.
151
-
152
- On some platforms the warning message "ANSI does not support long long"
153
- will be issued for every file compiled. This message can be discarded
154
- and does not occur on newer versions of GCC. The 'long long' data type
155
- is not used anywhere in the newLISP source but part of some header files
156
- of the GCC installation.
114
+ 'libreadline5-dev' or a later version has to be installed.
157
115
158
116
Most of the makefile_xxxxx can also be used this way:
159
117
@@ -238,7 +196,7 @@ off_t 8
238
196
time_t 8
239
197
240
198
241
- (7 ) LOCALIZATION
199
+ (5 ) LOCALIZATION
242
200
----------------
243
201
244
202
The PCRE Regular Expressions code can be localized to your country/language
@@ -251,133 +209,30 @@ runtime without performance loss, (see newlisp_manual.html).
251
209
There are UTF-8 versions/makefiles available in the source distribution.
252
210
See the chapter about 'Customization, localization and UTF-8' in the manual.
253
211
254
-
255
- (8) UNINSTALL
256
- -------------
257
-
258
- On Win32 use the uninstall application from the newlisp applications
259
- menu.
260
-
261
- On Mac OS X double click on the uninstall script in the diskimage of
262
- the installer package.
263
-
264
- On UBUNTU Linux execute:
265
-
266
- sudo dpkg -r newlisp
267
-
268
- On all other UNIX, to uninstall if installed with make install do:
269
-
270
- sudo make uninstall
271
-
272
- or if installed with: make install_home
273
-
274
- make uninstall_home
275
-
276
- To manually uninstall on Win32 remove all files in c:\Program files\newlisp
277
-
278
- On Mac OS X and other UNIX remove all files in /usr/local/share/newlisp and
279
- /usr/share/doc/newlisp and the executable files /usr/local/bin/newlisp,
280
- /usr/local/bin/newliso-edit and /usr/local/bin/newlispdoc. On Mac OX X also
281
- remove the newLISP icon in the Applications folder.
282
-
283
-
284
- (8) RUNNING newLISP IN A SHELL OR CONSOLE WINDOW
212
+ (6) RUNNING newLISP IN A SHELL OR CONSOLE WINDOW
285
213
------------------------------------------------
286
214
287
215
On all platforms simply execute:
288
216
289
217
newlisp
290
218
291
- On Win32 the execution path of newlisp.exe was added to the environment
292
- during installation. On all other platforms the newlisp binary is in
293
- /usr/local/bin/newlisp or when using the home install in $HOME/bin
294
- where $HOME is the the home directory of the user taken from the environment
295
- variable HOME.
296
-
297
-
298
- (10) RUNNING THE newLISP-GS GRAPHICAL FRONTEND
299
- ----------------------------------------------
300
-
301
- On Win32 and Mac OS X a Java based syntaxhighlighting editor is installed in
302
- in the Applications menus. In other UNIX execute:
303
-
304
- newlisp-edit
305
-
306
- from the command line in a terminal window.
307
- The editor needs a Java runtime environment JRE version 1.5 as a minimum.
308
- In case it is not installed it can be obtained from:
309
- http://www.oracle.com/technetwork/java/javase/downloads/index.html
310
-
311
- Since Mac OS X 10.7 Lion, Java is not installed by default. Install
312
- Java for OS X 10.7 Lion from here: http://support.apple.com/kb/DL1421
313
-
314
- (11) INSTRUCTIONS FOR CUSTOMIZED INSTALL AND PACKAGE CREATORS
315
- -------------------------------------------------------------
316
-
317
- By default the configure script uses the following install directories:
318
-
319
- /usr/local/bin/
320
- /usr/local/share/newlisp
321
- /usr/local/share/doc/newlisp
322
-
323
- As an alternative the configure-alt script can be used. Do a:
324
-
325
- ./configure-alt --help
326
-
327
- To see all the options available. Options for install directories,
328
- readline support, UTF-8 support and memory model used are available.
329
-
330
- Like configure, configure-alt creates a makefile_build and makefile_install.
331
- Both makefiles are used by Makefile when doing:
332
-
333
- make
334
- make install
335
- make test
336
-
337
- or for a bigger testsuite
338
-
339
- make testall
340
-
341
- These are the standard configuration options recommended by newlisp.org:
342
-
343
- - use ILP32 memory model as a default, use LP64 only when ILP32 is not
344
- available on the platform (configure-alt will take the default offered
345
- on the platform)
346
-
347
- - use the default IPV4 support IPV6 has not been thoroughly tested yet
348
- although it passes the standard qa-net test script (configure-alt
349
- defaults to IPV4.
350
-
351
- - use readline support if possible (configure-alt uses it if available)
352
-
353
- - offer both packages, one with and one without UTF-8 support on UNIX
354
- installations. newlisp.org ships UTF-8 support on MAC OSX by default and
355
- ships without UTF-8 support on Win32 (offering UTF-8 binaries on the
356
- newlisp.org website).
357
-
358
- - for a brief, one line description of the package, use:
359
-
360
- newLISP is a LISP like, general purpose scripting language
361
-
362
- - for a longer description of the package, use:
363
-
364
- newLISP is a scripting language for developing web applications and
365
- programs in general and in the domains of artificial intelligence (AI)
366
- and statistics.
219
+ On Windows the execution path of newlisp.exe should be added to the environment
220
+ during installation. On all other platforms the newlisp binary should be in
221
+ /usr/local/bin/newlisp or /usr/bin/newlisp.
367
222
368
223
369
- (12 ) COMMENTS ABOUT LIBFFI
370
- --------------------------
224
+ (7 ) COMMENTS ABOUT LIBFFI
225
+ -------------------------
371
226
372
227
Here some general comments for usage of libffi in newLISP:
373
228
374
229
The extended ffi requiring libffi and ffi.h for compiling, was only
375
230
introduced a short time ago in February of 2012. Except for module/gsl.lsp
376
231
all other modules shipped in the distributions work with the older simple
377
- form of import not requiring libffi.
232
+ form of import not requiring libffi. Both are documented in the manual.
378
233
379
234
The configure utility will pick libffi enabled makefiles only for Windows,
380
- OSX and Linux. For all other OS it will pick makefiles not requiring libffi.
235
+ MacOS and Linux. For all other OS it will pick makefiles not requiring libffi.
381
236
382
237
Ted Walther's configure-alt utility, which automatically configures the
383
238
memory model (32-bit or 64-bit) never configures for the new extended ffi
0 commit comments