Miroirs/xwords
1
0
Fork 0
mirror of git://xwords.git.sourceforge.net/gitroot/xwords/xwords synced 2025-01-28 07:58:08 +01:00
Code Issues Projects Releases Packages Wiki Activity

update linux README

Browse source
This commit is contained in:
Eric House 2021-04-25 20:57:13 -07:00
parent 1e4bb23b18
commit 53311acb7f
1 changed files with 27 additions and 43 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

70
xwords4/linux/README.txt
View file

@ -1,54 +1,38 @@
(This file is out-of-date and the instructions it contains don't work.) This directory contains the desktop Linux port of CrossWords. It
should build and run on any Debian derivative (e.g. Ubuntu or
Raspbian).
This directory contains the desktop Linux port of Crosswords. You'll need the build tool "make" installed. Once you have that, cd
into this directory and run
To build, run a shell in this directory and type # make debs_install
which will get you all the packages the build depends on. Your user
will need sudo capability.
Once that's done, build:
# make MEMDEBUG=TRUE
or
# make # make
or
# make debug
or
# make memdebug
Any will work as long as you have both libncurses and libgtk-1.2 and the latter for a release build
the associated headers installed on your system. If you don't you can
play with the Makefile to build with only GTK or ncurses.
Once you've built, go to the linux directory that will be created If the build succeeds (if it doesn't, and it's not because you changed
within this one and type, at a minimum something, email me at xwords@eehouse.org), run the debug build thus:
# ./xwords -s -n SomeName # ./obj_linux_memdbg/xwords
to get a GTK-based game with the built-in (English) tiles. (Add the or the release thus:
-u flag to run with ncurses instead of GTK.) There will be no robot
player, and the hint feature ('?' button) won't work. For that you
need a real dictionary, which you can build in the dawg directory. If
you build the BasEnglish2to8.xwd one in dawg/English, this command
will run a two person game between you and the machine:
# ./xwords -s -r robot -n SomeName -d ../../dawg/English/BasEnglish2to8.xwd # ./obj_linux_rel/xwords
Here are the commands to launch two copies playing against each other Add --help to get a list of all the options.
over the network. Do these in separate shells both in the same
directory as the above commands ran in. Launch the one with the -s
flag (the "server") first.
s1# ./xwords -s -r Eric -N -p 4000 -l 4001 The first time you launch its main window will be tiny and in the
s2# ./xwords -d ../../dawg/English/BasEnglish2to8.xwd -r Kati -p 4001 -l 6002 upper-left corner of your screen. If you resize or move the window the
app will remember its new size and location. Use the buttons and menus
Both of these have "robot" players. Turn one or both -r flags to -n to do stuff. Not all will be obvious, and some stuff may not
for human players who make their own moves. work. Always remember that this app exists to develop and test code
whose main target is Android or other mobile platforms, not desktop
If you want to run them on different machines, just add the -a flag to Linux.
the client telling it on what machine to find the server (since it
sends the first message, and the server will use the return address
from that message.)
*****
Please keep in mind that these Linux desktop clients are meant for
development only, as testbeds for code in ../common/ that will also be
used for the "real" products on PalmOS, PocketPC, eBookman, etc.
They're not supposed to be polished.