Comment out the homepage URL
[pkg/netris.git] / FAQ
1 #
2 # Netris
3 # Frequently asked questions
4 #
5 # $Id: FAQ,v 1.4 1999/05/16 06:56:21 mhw Exp $
6 #
7
8 Questions
9 =========
10 [1] Where can I find the latest version?
11 [2] The pieces look bizarre in my xterm window, and don't erase
12     properly.  What's up?
13 [3] If I drop a piece and then slide it off a cliff, shouldn't
14     it automatically drop again?
15 [4] When I try to play a networked game, it just hangs.
16 [5] Is the game fair?  Is there an advantage to being the -w or the
17     -c player?
18 [6] I'm using a slow terminal, and the game response is sluggish.
19     What can I do?
20 [7] Why can't my terminal hide the cursor?
21 [8] Occasionally when clearing a line, the display jerks, scrolling
22     very awkwardly.  How can I fix it?
23
24 Answers
25 =======
26 [1] Where can I find the latest version?
27
28     ftp://ftp.netris.org/pub/netris/
29
30     The latest version is available via anonymous ftp from
31     ftp.netris.org in /pub/netris.
32     
33     Unfortunately this machine is currently on the far end of a
34     14.4kbps modem connection, and may go away at any time without
35     notice, but I'll do my best to keep it up.  If you have trouble
36     contacting the ftp server, try mailing me at <mhw@netris.org>.
37
38 [2] The pieces look bizarre in my xterm window, and don't erase
39     properly.  What's up?
40
41     Try disabling standout mode with the -S option.  If this fixes it,
42     it's probably because the bold font on your xterm is set wrong.
43     It's a good idea to fix it, since the blocks look much nicer when
44     they're inverse.
45
46     If the blocks don't erase correctly and are drawn larger than normal
47     characters, check your .Xdefaults file.  If you set the "font", make
48     sure you also set the "boldFont" to something of the same size.  For
49     example, I use 6x10 font for xterms, and here are the relevant lines
50     from my xterm.
51
52     txterm*font:        6x10
53     txterm*boldFont:    6x10
54
55     Make sure you capitalize the F in "boldFont"
56
57 [3] If I drop a piece and then slide it off a cliff, shouldn't
58     it automatically drop again?
59
60     Try the -D option.
61
62 [4] When I try to play a networked game, it just hangs.
63
64     There are two possibilities.  First, versions 0.1d? are incompatible
65     with current versions.  This is unfortunate, but remember, those were
66     very developmental versions.  I needed to fix up the protocol, and
67     I didn't want a whole bunch of messy compatibility code (at least
68     not yet :-)  Ask your opponent to get the latest version.
69
70     The other possibility is that you've typed in the wrong hostname, or
71     there's a port number mismatch, if either of you used the -p option.
72
73 [5] Is the game fair?  Is there an advantage to being the -w or the
74     -c player?
75
76     The game is fair.  The game is completely symmetric once the
77     connection is established.  Furthermore, a random number seed is
78     exchanged at the start of the game, so both players will get the
79     same pieces.
80
81     There is a built-in random number generator, so even if the C
82     library on your system has a non-standard generator, both
83     players will still get the same sequence.
84
85     There is no attempt to synchronize the start of the game
86     accurately for networks with high latency.  This should be fixed
87     at some point, but I doubt such a small head start makes much
88     difference for a game lasting several minutes.
89
90 [6] I'm using a slow terminal, and the game response is sluggish.
91     What can I do?
92
93     Try the -S option.  This disables use of standout mode (bold/inverse),
94     which require control sequences to be sent twice (or more) per line.
95     Standout mode makes the pieces look much more like blocks, but can
96     make the game unplayable on a slow terminal.
97
98     Also, you can type 's' to toggle spying (updating your view of the
99     opponent's board).
100
101 [7] Why can't my terminal hide the cursor?
102
103     Netris uses the termcap library to look up the "vi" and "ve"
104     capabilities, which make the cursor invisible/visible
105     respectively.  These capabilities aren't very consistently
106     reported among un*xes, so I use compiled-in vt220 codes for
107     several vt100-like terminals.  Most emulators probably won't
108     support the codes, but they'll probably ignore them quietly.
109
110     Try setting the TERM environment variable to "vt100" or "vt220"
111     before running Netris.  If that doesn't work, your terminal
112     probably doesn't support cursor invisibility.
113
114 [8] Occasionally when clearing a line, the display jerks, scrolling
115     very awkwardly.  How can I fix it?
116
117     You can try running ./Configure with the "--curses-hack" option
118     and recompile.  This utilizes a non-portable hack which will only
119     work with certain curses libraries, so it's disabled by default.
120
121     All screen updating is done by your curses library, which means
122     it's not something that Netris can control.  Netris never tells
123     curses to scroll, but curses does so automatically in order to
124     optimize screen updates.  This hack modifies curses's internal
125     variables, making it think that your terminal doesn't know how to
126     region-scroll.
127
128
129 # vi: tw=70 ai