Mercurial > hg > rlgwebd
annotate about.html @ 165:59e62710cbb5
rlgwebd.js: prevent races when reading ttyrecs.
DglSession objects read a 12-byte TTYREC header, extract therefrom the
length of the data chunk, and then read the data. In between these two
reads, the file watcher could trigger another readchunk() invocation,
which might attempt to read a header from the beginning of the data
chunk. This usually results in expecting a data chunk of several GB
and failing to create a Buffer for it.
The race is remedied by setting a flag on the DglSession object
whenever readchunk() is called, clearing it when both reads complete,
and refusing to read if it is already set.
| author | John "Elwin" Edwards |
|---|---|
| date | Wed, 07 Jan 2015 13:18:35 -0500 |
| parents | e4f27a093d1e |
| children | db27b91578f0 |
| rev | line source |
|---|---|
| 82 | 1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> |
| 2 <html> | |
| 3 <head> | |
|
135
e4f27a093d1e
Bump the version number.
John "Elwin" Edwards <elwin@sdf.org>
parents:
134
diff
changeset
|
4 <title>RLG-Web β6 Information</title> |
| 82 | 5 <link rel="stylesheet" type="text/css" href="style-rlg.css"> |
| 6 </head> | |
| 7 <body> | |
|
135
e4f27a093d1e
Bump the version number.
John "Elwin" Edwards <elwin@sdf.org>
parents:
134
diff
changeset
|
8 <h1>RLG-Web β6 Help and Information</h1> |
| 114 | 9 <p>This page explains <a href="/">RLG-Web</a> and how to use it. Since the project is still under rapid development, details may change.</p> |
| 82 | 10 <h2>Browser Compatibility</h2> |
|
134
83058bb7d2f3
Update the documentation.
John "Elwin" Edwards <elwin@sdf.org>
parents:
114
diff
changeset
|
11 <p>RLG-Web has been tested using Firefox and Chrome; there should be no problems with recent versions of these two browsers. Safari 6 works, but |
|
83058bb7d2f3
Update the documentation.
John "Elwin" Edwards <elwin@sdf.org>
parents:
114
diff
changeset
|
12 older versions may not. Opera ought to work, though it hasn't been tested yet. Internet Explorer 9 is compatible, but older versions might not be.</p> |
| 114 | 13 <h2>WebSockets</h2> |
| 14 <p>If your browser supports it, RLG-Web will connect using WebSockets. This lets the server send data to your browser as soon as Rogue generates it, | |
|
134
83058bb7d2f3
Update the documentation.
John "Elwin" Edwards <elwin@sdf.org>
parents:
114
diff
changeset
|
15 instead of waiting for the browser to ask for it. This reduces the lag time.</p> |
| 114 | 16 <p>The site will still work if your browser doesn't support this feature, but it will probably be annoyingly slow.</p> |
| 82 | 17 <h2>Starting Games</h2> |
| 18 <p>If you have already registered an account, you can log in. If not, create one with the "New name" button. Once logged in, RLG-Web will list your | |
| 19 saved games and let you resume them or start new ones.</p> | |
| 20 <p>If there are games being played, you can watch them whether you are logged in or not.</p> | |
| 21 <p>Use the "Stop" button to stop watching a game, or to force a game you are playing to save.</p> | |
| 22 <h2>Playing Games</h2> | |
| 23 <p>The games can be difficult to learn if you are not familiar with ASCII roguelikes. The '?' key will tell you what each key does. An 'S' will save | |
| 24 your game, and a 'Q' will quit.</p> | |
| 25 <p>The original method of moving around was with the vi-keys.</p> | |
| 26 <table style="font-size: 2em; margin: 0 5em"> | |
| 27 <tr><td>y</td><td>k</td><td>u</td></tr> | |
| 28 <tr><td>h</td><td>.</td><td>l</td></tr> | |
| 29 <tr><td>b</td><td>j</td><td>n</td></tr> | |
| 30 </table> | |
| 31 <p>This is the most reliable way of exploring.</p> | |
| 32 <p>You can also move with arrow keys, or with the number pad, if your browser recognizes those keys. If it doesn't, the simulated keyboard can imitate | |
| 33 them.</p> | |
| 34 <p>Note: Super-Rogue does not work with the arrow keys or the number pad yet.</p> | |
| 35 <h2>Saving Games</h2> | |
| 114 | 36 <p>If you accidentally close your browser, don't worry. If your browser supports WebSockets, RLG-Web will save your game automatically. If not, it |
| 37 will be saved after staying idle for an hour, or you can force it to save when you return.</p> | |
| 38 <p>Your strength 18 character with the two-handed sword on level 22 is safe from bugs and network problems. But the dragons are sure to get him.</p> | |
| 82 | 39 <h2>Accounts and Passwords</h2> |
| 40 <p>rlgallery.org doesn't use https yet, so you should not assume your password is safe. Don't use the same one you use on your bank's website, etc.</p> | |
| 41 <p>You don't have to supply a valid e-mail address. It will only be used if you ask to have your password reset.</p> | |
|
134
83058bb7d2f3
Update the documentation.
John "Elwin" Edwards <elwin@sdf.org>
parents:
114
diff
changeset
|
42 <p>You can change your e-mail or password on the <a href="/options.html">options page</a>.</p> |
| 82 | 43 <h2>Missing Features</h2> |
| 44 <p>You can't watch games that are being played in dgamelaunch yet. The opposite situation works: you can use dgamelaunch to watch games being played | |
| 45 in RLG-Web.</p> | |
| 46 </body> | |
| 47 </html> |