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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
This directory contains both source and binary (win32, Linux, Sparc/Solaris) distribution
of the Python wrapping for SLang screen management library.
BINARY DISTRIBUTION
~~~~~~~~~~~~~~~~~~~
1. What do you need:
Binary Python-1.5.x installation
2. What to do:
Put an appropriate .so or .pyd file correspondingly to lib-dynload or DLLs subdirectory of your
Python distribution.
SOURCE DISTRIBUTION
~~~~~~~~~~~~~~~~~~~
****** Unix *******
0. Supported platforms:
Intel/Linux
Sparc/Solaris
HP-UX 10 (B.10.20)
AIX 4.2
1. What do you need:
1.1. Python installation, containing files, necessary for extension
development. For RedHat one usually needs to install
python-devel-1.5-x.*.rpm. If you installed Python from source, it
should be in its place by default.
1.2. SLang installation.
For RedHat-5.2 Linux, one would try to use slang-1.2.2.*.rpm and
slang-devel-1.2.2.*.rpm from rawhide development version, but this may
cause problems. Although nothing prevent working on such a system,
one cannot advise it for everybody. Anyway it will need to
upgrade some system packages, or even installing (upgrading) entire
rawhide distribution.
So, for most of Unices, please compile and install slang-1.2.2 from its
source distribution. In configuring it, indicate --prefix=<prefix for your
Python installation>. In that case, the 'slang.h' header will go to
$(prefix)/include. If you will succeed with rpm, it will go to
/usr/include/slang. Current configure script tries to handle both cases.
2. What to do:
cd src
./configure
make
make install
(or put manually the resulting slang.so to any place from which you can import it.)
make slpython
will give you a static version of python executable with slang module
built in.
Current configuration script tries to locate your 'python' file and guess
installation prefix. All header and library files are looked up in the
subdirs of that prefix.
You do not need SWIG distribution or installation, unless you'd like to
improve the wrapping. In the latter case, you'd better install SWIG from the
source both for win32 and unix, though rpm's do exist.
******* Win32 *******
1. What do you need:
1.1. Visual C++ 5.0.
1.2. Python installation.
1.3. Source distribution of slang-1.2.2.
2. What to do:
2.1. Compile slang-1.2.2. Put library to ../python/libs, header to
.../python/include. You will need to let VC 5.0 learn these directories.
2.2. Open slang.dsp and build main target. The .pyd will be in pyds subdir.
The workspace was built with the use of David Asher's compile.py script
found in NumPy distribution.
PROBLEMS, FEATURES AND LIMITATIONS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. I didn't mastered 'gpm' support for Linux platform. This is in TODO list.
Mouse in xterm window is intercepted as expected, the same is valid for
win32 console.
2. The interaction between standard 'print' to sys.stdout and output to
SLang screen is different on different platforms. The best, as I see, is on
win32, where they are separated and the former can be seen at any time via
'...suspend_msg'.
3. The example 'tst.py' contains only those functions, which meaning I
realized for that moment. I didn't see any 'videobuffer' management
functions, as long as any higher level "windowing" primitives.
4. Cursor in win32 console cannot be made invisible. The same is for
Solaris(?). But probably I haven't found a good solution.
5. Current use of 'autoconf' stuff is a bit naive in locating libslang.a
and other files.
6. For HP-UX and AIX only static version is produced by the author
and more or less tested. User may nevertheless succeed in building
shared modules for those platforms.
DOCUMENTATION
~~~~~~~~~~~~~
See one in the SLang distribution. The presented wrapping is *very*
straightforward, so one may use the original doc without any intellectual
effort to map C concepts to those of Python.
Copyright notice
================
Copyright (C) Institute of Applied Astronomy, Russian Academy of Sciences,
1998, 1999
Copyright (C) Alexander V. Voinov, 1998, 1999
All Rights Reserved
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in
supporting documentation, and that the names of the Institute of Applied
Astronomy, Russian Academy of Sciences not be used in advertising or
publicity pertaining to distribution of the software without specific,
written prior permission.
INSTITUTE OF APPLIED ASTRONOMY, RUSSIAN ACADEMY OF SCIENCES DISCLAIM ALL
WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL INSTITUTE
OF APPLIED ASTRONOMY, RUSSIAN ACADEMY OF SCIENCES BE LIABLE FOR ANY
SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-------------------------------------------------------------------------
|
