File: README

package info (click to toggle)
floater 1.2b1-6
  • links: PTS
  • area: non-free
  • in suites: woody
  • size: 1,612 kB
  • ctags: 1,822
  • sloc: ansic: 16,755; tcl: 4,034; sh: 1,291; makefile: 129
file content (171 lines) | stat: -rw-r--r-- 7,330 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
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
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
			    Floater 1.2b1
		  for Unix and for Microsoft Windows
			  September 14, 1999

		       http://www.floater.org/

                            by Geoff Pike
			  geoff@floater.org


Please check the ever growing Floater web page at
http://www.floater.org/ for the most up-to-date
documentation and information, including everything here and much more.

Floater is a free program for duplicate bridge play on the Internet.
It also supports non-duplicate bridge and 3-player hearts.

Floater 1.2 is a minor upgrade to 1.1 that includes several changes:
  o  Faster server
  o  New installer for Microsoft Windows users
  o  Some bug fixes

Version 1.2 is not interoperable with older versions.

To install, Microsoft Windows users should download and run the
installer from the Floater web page.  Unix users will need to rebuild
from scratch as described below.

Please report bugs to bugs@floater.org.

Floater for Macintosh will be available soon.  Sorry for the delay.

Please read this file as well as the files called BUGS and CONFUSING.

Microsoft Windows Installation Instructions:
--------------------------------------------

Download and run the installer, inst12b1.exe, available at
http://www.floater.org/inst12b1.exe.  The installer has two basic
steps.  Step 1: the installer checks for Tcl/Tk 8.0 and offers to
download and install it for you if necessary.  Step 2: the installer
downloads the Floater executable and associated files from floater.org
and creates a shortcut to Floater from the Desktop and from the
Start Menu.

After installing Floater, you may delete the installer.

Unix Installation instructions:
-------------------------------

Please be aware that these instructions are for installation only.
See the web page for other, ultimately more useful, information.

Please read carefully.  Unlike the Mac and Microsoft Windows versions,
you must compile Floater yourself for Unix.  If you have never edited
a Makefile before, you may find this difficult.

If you have problems, please consult the web page to see if there are
notes from others who may have tried compiling Floater on your
architecture/OS.  Send bugs to bugs@floater.org, and also please send
descriptions of what you had to modify to get Floater to work on your
system.  When sending email about problems that you have not yet been
able to solve, please clearly indicate what you have tried so far.
Due to the high volume of email, responses may be slow.

Almost all of the difficult-to-port features of Floater are
implemented by using Tcl and Tk, which have already been ported to
many different machines.  Floater should run on a variety of machines
with no problem.  It is known to compile on SunOS, Solaris,
Linux, HPs (HP/UX), and Silicon Graphics (IRIX), among others.  Don't
be intimidated by the amount of software you may need to install---the
autoconf scripts really work and next to nothing needs to be fixed by hand.

Floater for Unix has two versions---textual and graphical.  Both
require Tcl and Tk, which are freely available.  In addition, the text
version requires System V style curses or ncurses (GNU's free
replacement for curses).  Tcl/Tk 8.0 is required.  You should use the
latest patch level, which as of September, 1999, is 8.0.5.  (Floater
does not work with Tcl/Tk 8.1 or 8.2.  If you port it to Tcl/Tk 8.2
let us know!)

By default, the graphical and textual versions are in the same
executable.  You may build an executable that does not include the
textual version, which is useful if you have X and don't want to deal
with curses (see Makefile for details).

BSD users without ncurses should have it installed anyway, as the
maintainer of BSD curses has publically announced that he is no longer
supporting it and he encourages people to switch to ncurses.  If you
are unsure whether you need ncurses to use Floater, try it first
without ncurses.  You may get ncurses by anonymous ftp from
prep.ai.mit.edu in the /pub/gnu directory.  Or, it is too much
trouble, you may compile only the X user interface (see Makefile for
details).

Detailed instructions follow.  For easier ftp'ing, the Floater
web page (http://www.cs.berkeley.edu/~pike/floater/release.html)
allows you to download the appropriate files.

To install Floater 1.2b1 for Unix:
----------------------------------

0. Floater more or less requires UNIX and 32-bit integers.  Brave
souls who try to install it without those things may succeed but with
some difficulty.

1. If your site doesn't have it, install Tcl/Tk, available from the
Tcl/Tk web page at http://www.scriptics.com.  Note that Tcl/Tk 8.0.5
is what you should try to use, but 8.0.x is fine.  See above.

2. You may or may not need ncurses.  System V users and many BSD users
should either not need it or already have it.  See above.

3. Get the compressed Floater tar file from the Floater web page.
Uncompress and untar the file by doing:
        gzip -c -d floater1.2b1.tar.gz | tar xvf -

(You may remove floater1.2b1.tar.gz now.)

4. Run the configure script by doing changing to the floater1.2b1
directory and running ./configure.  The flags accepted by the
configure script are as follows:
  --with-tcl=/some/path
     will look for tcl headers files and libs in /some/path/include
     and /some/path/lib

  --with-tk=/some/path
     same as --with-tcl but for tk

  --with-curses=/some/path
     same as above but for curses (it tries to look for ncurses and
     then curses but may not be perfect...)

  --without-curses
     doesn't look for curses at all and defines GUI_ONLY when
     building.

If the configure script runs successfully, it creates a Makefile.
(Thanks to Andrew Swan for creating the new and improved configure script!)

5. Do "make".  It may or may not work.  If it doesn't work, edit the
file Makefile.in to try to set up the paths for various libraries,
etc., as necessary.  More instructions are in that file.  Each time
you edit Makefile.in, do "make Makefile" to regenerate the Makefile,
and then do (just) "make" again.  (On some systems you can just do
"make" and it will automatically recreate the Makefile and then try to
recompile.)  If desperate, you may also want to refer to
Makefile.pike, which is a Makefile that is known to work on at least
one system somewhere.

6. Once you have successfully built Floater, a common problem when you
first run it is an error message about being unable to find init.tcl
in certain directories.  The easiest solution, if you have Tcl and Tk
in sibling directories, is to create a directory called lib, sibling
to those two, and do:
        cd lib
        ln -s ../tk8.0/library tk8.0
        ln -s ../tcl8.0/library tcl8.0

Another solution is to find init.tcl and put a copy of it in one of
the directories in which it is looking when you start up Floater.
Another is, before running Floater, to do "setenv TCL_LIBRARY <dir>"
where <dir> is the directory containing init.tcl (typically
<something>/tcl8.0/library).  A third is to properly install Tcl by
doing "make install" in the tcl8.0/unix directory---but you probably
have to be root to do this.

(Once you fix that, the analogous problem will likely crop up with Tk.
It will complain that it can't find a usable tk.tcl.  The same fixes
apply, but be sure to copy all the .tcl files in tk8.0/library if you
choose that solution.)