.dir.info
author convert-repo
Sun, 10 Feb 2019 04:31:24 +0000
changeset 1590 a1e0688b2f39
parent 1119 9a0d3e1d312b
permissions -rw-r--r--
update tags
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
39
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     1
This is the directory where your smalltalk executable is created.
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     2
The TOP makefile arrives here and does a 'make' here as
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     3
a final step.
1119
9a0d3e1d312b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 267
diff changeset
     4
The make here will leave an executable 'smalltalk' here.
39
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     5
This can be executed here or copied to use/local/bin (or whereever).
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     6
For proper execution, smalltalk needs access to the sourcefiles (for the browser)
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     7
and some config files (resources, styles and .rc files).
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     8
The makefile here creates subdirectories containing symbolic links to
1119
9a0d3e1d312b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 267
diff changeset
     9
these files. The searchpath (see Smalltalk>>systemPath) for all file accesses
39
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    10
is set to access files either locally, or in usr/local/lib/smalltalk.
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    11
Local operation:
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    12
	files are installed as symbolic links in subdirectories.
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    13
	The are accessed locally ('.' being in the path)
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    14
Group operation (proper installation):
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    15
	the files are installed as copies subdirs of in usr/local/lib/smalltalk
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    16
	Users may override these by creating subdirectories locally
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    17
	(for example: having a private 'smalltalk.rc')
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    18
	Access is from local files or global files - whichever is found first
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    19
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    20
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    21
Things you can do here:
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    22
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    23
    make                compile a smalltalk, create symbolic links to
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    24
			sourcefiles, bitmaps and resources.
267
094a3aaa77bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 224
diff changeset
    25
			The resulting executable (stx) is fit for local
094a3aaa77bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 224
diff changeset
    26
			execution (i.e. it does not require any installed
094a3aaa77bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 224
diff changeset
    27
			files from other places).
094a3aaa77bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 224
diff changeset
    28
			It can also be installed for shared usage (in /usr/local)
094a3aaa77bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 224
diff changeset
    29
			via the INSTALL script found in the TO directory.
39
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    30
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    31
    make smalltalk      only compile; leave links alone
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    32
137
35392f5afac1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 39
diff changeset
    33
    make smalltalk ADDITIONAL_CLASSES=<list of class names> \
35392f5afac1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 39
diff changeset
    34
		   ADDITIONAL_OBJS=<list of object files>
35392f5afac1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 39
diff changeset
    35
35392f5afac1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 39
diff changeset
    36
			compile (i.e. link) a smalltalk, which contains
35392f5afac1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 39
diff changeset
    37
			additional user classes.
35392f5afac1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 39
diff changeset
    38
			This can be used to make a bigger smalltalk, without
224
ad5935f0a870 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 189
diff changeset
    39
			defining a PACK.
137
35392f5afac1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 39
diff changeset
    40
			However, we recommend adding a package definition to the
35392f5afac1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 39
diff changeset
    41
			configurations/PACKS directory, and doing a CONFIG.
1119
9a0d3e1d312b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 267
diff changeset
    42
224
ad5935f0a870 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 189
diff changeset
    43
    make stx_fullstatic
ad5935f0a870 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 189
diff changeset
    44
			generates a statically linked executable.
ad5935f0a870 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 189
diff changeset
    45
			On some systems (solaris), this has a much faster
ad5935f0a870 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 189
diff changeset
    46
			startup time, since the shared-library linker does not have
ad5935f0a870 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 189
diff changeset
    47
			to patch the executable during startup (which creates lots of
ad5935f0a870 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 189
diff changeset
    48
			copy-on-write actions).
ad5935f0a870 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 189
diff changeset
    49
39
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    50
    make symLinks       only symbolic links are created
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    51
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    52
    make install        install smalltalk, libraries, include-files
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    53
			and sources in DESTBINDIR and DESTLIBDIR.
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    54
			Check with 'make -n install' before doing so.
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    55
			DESTBINDIR/DESTLIBDIR are typically set to
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    56
				/usr/local/bin
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    57
				/usr/local/lib/smalltalk
08e0f54e4f17 Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    58
			respectively.
189
a203bdd43dd3 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 188
diff changeset
    59
a203bdd43dd3 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 188
diff changeset
    60
    make demoApp1       a 'hello world' non-graphical demo application
a203bdd43dd3 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 188
diff changeset
    61
			see more in ../demoApps