File: INSTALL

package info (click to toggle)
blt8.0 2.4f-3
  • links: PTS
  • area: main
  • in suites: slink
  • size: 6,440 kB
  • ctags: 6,543
  • sloc: ansic: 57,358; tcl: 10,169; sh: 1,694; makefile: 551
file content (114 lines) | stat: -rw-r--r-- 3,152 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
The following describes how to compile and install the BLT library.

1. Uncompress and untar the distribution file.  

	zcat BLT2.4.tar.gz | tar -xvf - 

   This will create a directory "blt2.4" with the following subdirectories:

     		   blt2.4
      	______________|______________
     	|          |       |        |
      demos   library     man      src
     				    |
     				  shared

2. Run ./configure

   Go into the "blt2.4" directory 

        cd blt2.4

   and run the auto-configuration script "./configure".  Tell where to find 
   the Tcl and Tk header files and libraries with the "--with-tcl" switch.

        ./configure --with-tcl=/util/lang/tcl

       Switches:

       --with-tcl=dir	Top level directory where the Tcl and/or Tk 
     			header files and libraries are installed. Will 
     			search both "$dir/include" and "$dir/lib".

       --with-tk=dir	Top level directory where the Tk header files 
     			and libraries are installed.

       --with-cc=program  Lets you specify the C compiler, such as 
     			  "acc" or "gcc". 

       --prefix=path	By default, the bltwish demo program, the BLT
     			header files, libraries, scripts, and manual
     			pages are installed in "/usr/local/blt".  This 
     			lets you pick another location.

  The configure script creates a header file "src/bltConfig.h". It will also 
  generate new Makefiles from their respective templates (Makefile.in).

        Makefile.in 	        ==> Makefile
        src/Makefile.in	        ==> src/Makefile
        src/shared/Makefile.in	==> src/shared/Makefile
        man/Makefile.in		==> man/Makefile
        library/Makefile.in	==> library/Makefile

3. Compile the libraries and build the demonstration program "bltwish".

        make 

4. Test by running the demos. 

   Go into the demos directory 

        cd demos

   and run the test scripts.

        ./graph

   If your system doesn't support "#!" in shell scripts, then it's

        ../bltwish ./graph


5. Installing BLT

       make install

   The following directories will be created when BLT is installed.  
   By default, the top directory is /usr/local/blt.  
                  
           ___________|__________
           |     |        |     |
          bin  include   lib   man
                          |
                        blt2.4   
                      ____|____
                      |       |
                    demos   dd_protocols

   You can change the top directory by supplying the "--prefix=dir" switch 
   to ./configure.

*6. (Optional) Compiling BLT into your own custom "wish".

   [If your version of "wish" supports dynamic loading of packages
   you can simply add

         package require BLT 

   to the start of your script.]

   Add the following lines to your program's Tcl_AppInit routine in
   tkAppInit.c

        if (Blt_Init(interp) != TCL_OK) {
            return TCL_ERROR;
        }

   then link with libBLT.a.  And that's all there's to it.
     
7. Send bugs reports, suggestions, etc. to

        gah@bell-labs.com and/or ghowlett@fast.net

   Make sure you include BLT and the version number in the subject line.