~ubuntu-branches/ubuntu/precise/gnome-games/precise-proposed

« back to all changes in this revision

Viewing changes to iagno/help/sl/iagno.xml

  • Committer: Package Import Robot
  • Author(s): Rodrigo Moya
  • Date: 2011-05-30 13:32:04 UTC
  • mfrom: (1.3.4)
  • mto: (163.1.3 precise)
  • mto: This revision was merged to the branch mainline in revision 143.
  • Revision ID: package-import@ubuntu.com-20110530133204-celaq1v1dsxc48q1
Tags: upstream-3.0.2
Import upstream version 3.0.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="utf-8"?>
 
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
 
3
<!ENTITY legal SYSTEM "legal.xml">
 
4
<!ENTITY NETWORKGAMES SYSTEM "network-games.xml">
 
5
<!ENTITY appversion "2.20">
 
6
<!ENTITY manrevision "2.9">
 
7
<!ENTITY date "February 2008">
 
8
<!ENTITY app "<application>Iagno</application>">
 
9
<!ENTITY appname "Iagno">
 
10
<!ENTITY version "2.9">
 
11
]>
 
12
<!-- 
 
13
      (Do not remove this comment block.)
 
14
  Maintained by the GNOME Documentation Project
 
15
  http://developer.gnome.org/projects/gdp
 
16
  Template version: 2.0 beta
 
17
  Template last modified Feb 12, 2002
 
18
-->
 
19
<!-- =============Document Header ============================= -->
 
20
<article id="index" lang="sl">
 
21
<!-- please do not change the id; for translations, change lang to -->
 
22
<!-- appropriate code -->
 
23
<articleinfo>
 
24
 <title><application>Iagno</application> Manual</title>
 
25
 
 
26
    <abstract role="description">
 
27
      <para>
 
28
        Iagno is the two player strategy game of Othello, which is also known as
 
29
        Reversi and is similar to Go. The pieces are tiles that are black on one 
 
30
        side and white on the other and the objective is for the player to flip 
 
31
        his/her opponent's tiles to his/her color, while keeping the opponent 
 
32
        from doing the same. Once the board is filled with tiles, the winner is 
 
33
        the player with the most of his/her color tiles on the board.
 
34
      </para>
 
35
    </abstract>
 
36
 
 
37
 <copyright>
 
38
  <year>2000</year>
 
39
  <holder>Eric Baudais</holder>
 
40
 </copyright>
 
41
<!-- translators: uncomment this:
 
42
 
 
43
  <copyright>
 
44
   <year>2002</year>
 
45
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
 
46
  </copyright>
 
47
 
 
48
   -->
 
49
<!-- An address can be added to the publisher information.  If a role is 
 
50
     not specified, the publisher/author is the same for all versions of the 
 
51
     document.  -->
 
52
    <publisher> 
 
53
      <publishername> GNOME Documentation Project </publishername> 
 
54
    </publisher> 
 
55
 
 
56
     <legalnotice id="legalnotice">
 
57
        <para>
 
58
          Permission is granted to copy, distribute and/or modify this
 
59
          document under the terms of the GNU Free Documentation
 
60
          License (GFDL), Version 1.1 or any later version published
 
61
          by the Free Software Foundation with no Invariant Sections,
 
62
          no Front-Cover Texts, and no Back-Cover Texts.  You can find
 
63
          a copy of the GFDL at this <ulink type="help" url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
 
64
          distributed with this manual.
 
65
         </para>
 
66
         <para> This manual is part of a collection of GNOME manuals
 
67
          distributed under the GFDL.  If you want to distribute this
 
68
          manual separately from the collection, you can do so by
 
69
          adding a copy of the license to the manual, as described in
 
70
          section 6 of the license.
 
71
        </para>
 
72
 
 
73
        <para>
 
74
          Many of the names used by companies to distinguish their
 
75
          products and services are claimed as trademarks. Where those
 
76
          names appear in any GNOME documentation, and the members of
 
77
          the GNOME Documentation Project are made aware of those
 
78
          trademarks, then the names are in capital letters or initial
 
79
          capital letters.
 
80
        </para>
 
81
 
 
82
        <para>
 
83
          DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
 
84
          UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
 
85
          WITH THE FURTHER UNDERSTANDING THAT:
 
86
 
 
87
          <orderedlist>
 
88
                <listitem>
 
89
                  <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
 
90
                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
 
91
                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
 
92
                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
 
93
                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
 
94
                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
 
95
                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
 
96
                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
 
97
                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
 
98
                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
 
99
                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
 
100
                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
 
101
                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
 
102
                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
 
103
                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
 
104
                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
 
105
                    EXCEPT UNDER THIS DISCLAIMER; AND
 
106
                  </para>
 
107
                </listitem>
 
108
                <listitem>
 
109
                  <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
 
110
                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
 
111
                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
 
112
                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
 
113
                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
 
114
                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
 
115
                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
 
116
                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
 
117
                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
 
118
                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
 
119
                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
 
120
                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
 
121
                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
 
122
                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
 
123
                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
 
124
                       THE POSSIBILITY OF SUCH DAMAGES.
 
125
                  </para>
 
126
                </listitem>
 
127
          </orderedlist>
 
128
        </para>
 
129
  </legalnotice>
 
130
 
 
131
 
 
132
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
 
133
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
 
134
        any of this. -->
 
135
 
 
136
    <authorgroup> 
 
137
      <author role="maintainer"> 
 
138
        <firstname>Eric</firstname> 
 
139
        <surname>Baudais</surname> 
 
140
        <affiliation> 
 
141
          <address> <email>baudais@okstate.edu</email> </address> 
 
142
        </affiliation> 
 
143
      </author> 
 
144
<!-- This is appropriate place for other contributors: translators,
 
145
      maintainers,  etc. Commented out by default.
 
146
       <othercredit role="translator">
 
147
        <firstname>Latin</firstname> 
 
148
        <surname>Translator 1</surname> 
 
149
        <affiliation> 
 
150
          <orgname>Latin Translation Team</orgname> 
 
151
          <address> <email>translator@gnome.org</email> </address> 
 
152
        </affiliation>
 
153
        <contrib>Latin translation</contrib>
 
154
      </othercredit>
 
155
-->
 
156
    </authorgroup>
 
157
        
 
158
        <releaseinfo revision="2.26" role="review"/>
 
159
    
 
160
<revhistory>
 
161
  <revision> 
 
162
    <revnumber>Iagno Manual V2.9</revnumber> 
 
163
    <date>February 2008</date> 
 
164
    <revdescription> 
 
165
      <para role="author">Claude Paroz <email>claude@2xlibre.net</email></para>
 
166
      <para role="publisher">GNOME Documentation Project</para>
 
167
    </revdescription> 
 
168
  </revision>
 
169
  <revision> 
 
170
    <revnumber>Iagno Manual V2.8</revnumber> 
 
171
    <date>September 2004</date> 
 
172
    <revdescription> 
 
173
      <para role="author">Eric Baudais <email>baudais@okstate.edu</email></para>
 
174
      <para role="publisher">GNOME Documentation Project</para>
 
175
        </revdescription> 
 
176
  </revision>
 
177
  <revision>
 
178
   <revnumber>0.1</revnumber>
 
179
   <date>4 February 2000</date>
 
180
   <authorinitials>EB</authorinitials>
 
181
   <revremark>
 
182
   First draft completed.
 
183
   </revremark>
 
184
  </revision>
 
185
 
 
186
  <revision>
 
187
   <revnumber>0.2</revnumber>
 
188
   <date>5 February 2000</date>
 
189
   <authorinitials>EB</authorinitials>
 
190
   <revremark>
 
191
   Added a footnote to why section.  Fixed some typos.
 
192
   </revremark>
 
193
  </revision>
 
194
 
 
195
  <revision>
 
196
   <revnumber>0.3</revnumber>
 
197
   <date>7 February 2000</date>
 
198
   <authorinitials>EB</authorinitials>
 
199
   <revremark>
 
200
   Made the doc compliant with the GDP template.  Clarified 
 
201
   the playing section.
 
202
   </revremark>
 
203
  </revision>
 
204
 
 
205
  <revision>
 
206
   <revnumber>1.0</revnumber>
 
207
   <date>7 April 2000</date>
 
208
   <authorinitials>EB</authorinitials>
 
209
   <revremark>
 
210
   Licensed the Iagno Manual under the FDL.  Updated the 
 
211
   screenshots to the GDP standard theme, MicroGUI.
 
212
   </revremark>
 
213
  </revision>
 
214
 </revhistory>
 
215
 
 
216
    <releaseinfo>This manual describes version 2.20 of Iagno.
 
217
    </releaseinfo>
 
218
    <!-- The following feedback information only applies to appliactions
 
219
    listed in bugzilla.gnome.org and bugzilla.ximian.com. For other
 
220
    applications, please provide your own feedback info or remove thsi
 
221
    section altogether -->
 
222
    <legalnotice> 
 
223
      <title>Feedback</title> 
 
224
      <para>To report a bug or make a suggestion regarding the <application>Iagno</application> application or
 
225
        this manual, follow the directions in the 
 
226
        <ulink url="ghelp:user-guide?feedback-bugs" type="help">GNOME Feedback Page</ulink>. 
 
227
      </para>
 
228
<!-- Translators may also add here feedback address for translations -->
 
229
    </legalnotice>
 
230
 
 
231
</articleinfo>
 
232
 
 
233
  <indexterm zone="index"> 
 
234
    <primary>Iagno</primary> 
 
235
  </indexterm>
 
236
 
 
237
<!-- ============= Document Body ============================= -->
 
238
<!-- ============= Introduction ============================== -->
 
239
<sect1 id="intro">
 
240
 <title>Introduction</title>
 
241
 <sect2 id="what">
 
242
  <title>What is Iagno?</title>
 
243
  
 
244
  <para>
 
245
  <application>Iagno</application> is a computer version of 
 
246
  the game Reversi, more popularly called Othello.  
 
247
  <application>Iagno</application> is a two player strategy 
 
248
  game similar to Go.  The board is 8 by 8 with tiles that 
 
249
  are black on one side and white on the other side.  The 
 
250
  object of <application>Iagno</application> is to flip as 
 
251
  many of your opponent's tiles to your color as possible 
 
252
  without your opponent flipping your tiles.  This is done 
 
253
  by trapping your opponent's tiles between two tiles of 
 
254
  your own color.
 
255
  </para>
 
256
 
 
257
  <para>
 
258
    Iagno also features <link linkend="network-games">multiplayer</link> support with two 
 
259
    human players in hotseat or network mode.
 
260
  </para>
 
261
 
 
262
  <para>
 
263
   To run <application>Iagno</application>, select
 
264
   <guimenuitem>Iagno</guimenuitem> from the
 
265
   <guisubmenu>Games</guisubmenu> submenu of the <guimenu>Main
 
266
   Menu</guimenu>, or type <command>iagno</command> on the
 
267
   command line. 
 
268
  </para>
 
269
 </sect2>
 
270
 
 
271
 <sect2 id="why">
 
272
  <title>Why is Othello called Iagno?</title>
 
273
  <para>
 
274
  You're probably wondering why this game is called
 
275
  <application>Iagno</application> instead of Othello or
 
276
  even gnothello.  The answer is complicated, and involves
 
277
  things like trademarks and lawyers and whatnot.
 
278
  Instead of leaving 
 
279
  it at that, I'll tell you a long and complicated lie about 
 
280
  the origin of the name <application>Iagno</application>.
 
281
  </para>
 
282
  <para>
 
283
  On a stormy night, like those depicted so much in England, 
 
284
  a lonely programmer was sitting in front of his computer 
 
285
  screen.  Ian had finished his masterpiece in gaming.  It 
 
286
  was a fully interactive game of Othello and he decided
 
287
  to play a pun with the name and called it gnothello for 
 
288
  the game was written using GNOME.  
 
289
  </para>
 
290
  <para>
 
291
  Later his buddies came over and like all programmers he 
 
292
  showed off his masterpiece.  They all laughed in his face 
 
293
  and told Ian that his game was worthless and a pitiful 
 
294
  attempt to be a true hacker.  After Ian kicked them out 
 
295
  he decided to rename his program Iago 
 
296
  <footnote>
 
297
   <para>
 
298
   Iago is Othello's nemesis in the play <citetitle>Othello
 
299
   </citetitle> by William Shakespeare.
 
300
   </para>
 
301
  </footnote>
 
302
  for the evil which 
 
303
  had manifested itself due to his game.  Yet it still 
 
304
  didn't sound right.  All GNOME programs have some part 
 
305
  of GNOME in it, Ian thought.  After much thought he decided 
 
306
  on the name we have come to cherish, <application>Iagno
 
307
  </application>.
 
308
  </para>
 
309
 </sect2>
 
310
</sect1>
 
311
 
 
312
<sect1 id="playing">
 
313
 <title>Playing Iagno</title>
 
314
 <para>
 
315
 The board starts with four tiles arranged in a box on the 
 
316
 middle of the board. The tiles have the same color at each 
 
317
 corner, as shown in <xref linkend="start-shot"/>. 
 
318
 </para>
 
319
 
 
320
 <figure id="start-shot">
 
321
  <title>Starting Position</title>
 
322
  <screenshot>
 
323
    <mediaobject> 
 
324
    <imageobject>
 
325
  <imagedata fileref="figures/START.png" format="PNG" srccredit="Eric Baudais"/>
 
326
   </imageobject>
 
327
    <textobject> 
 
328
      <phrase>Screenshot of the starting position.</phrase> 
 
329
    </textobject> 
 
330
  </mediaobject>
 
331
  </screenshot>
 
332
 </figure>
 
333
 
 
334
 <para>
 
335
 Black goes first and places a tile on the board such that it 
 
336
 traps white's tiles between two of black's tiles. When black places 
 
337
 a tile on the board all of white's tiles between black's newly placed 
 
338
 tile and another black tile, in a horizontal, vertical, or diagonal row, are flipped over 
 
339
 and become black, as shown in <xref linkend="first-shot"/>.
 
340
 </para>
 
341
 
 
342
 <figure id="first-shot">
 
343
  <title>First Move</title>
 
344
  <screenshot>
 
345
    <mediaobject> 
 
346
    <imageobject>
 
347
  <imagedata fileref="figures/FIRST.png" format="PNG" srccredit="Eric Baudais"/>
 
348
   </imageobject>
 
349
    <textobject> 
 
350
      <phrase>Screenshot of the first move.</phrase> 
 
351
    </textobject> 
 
352
  </mediaobject>
 
353
  </screenshot>
 
354
 </figure>
 
355
 
 
356
 <para>
 
357
 When there is tile trapped between two tiles, of an identical color 
 
358
 in the same row, the player captures tiles until another tile of the 
 
359
 player's color is encountered, as shown in <xref linkend="block-shot"/>.  
 
360
 The player can only take tiles that are 
 
361
 a direct result of the placing a tile on the board. Once a tile is 
 
362
 placed on the board the player cannot remove it and place the tile 
 
363
 somewhere else. If a player cannot move they forfeit their turn.  
 
364
 The game ends when it is no longer possible for either player to move.
 
365
 
 
366
 <figure id="block-shot">
 
367
  <title>White cannot capture the black tile in the center of the
 
368
  middle column because there are white tiles blocking the ends of that
 
369
  column. If it where blacks turn instead, black could place a tile at
 
370
  the top of the column but would only flip the first of the two white
 
371
  tiles.</title>
 
372
  <screenshot>
 
373
    <mediaobject> 
 
374
    <imageobject>
 
375
  <imagedata format="PNG" fileref="figures/BLOCK.png" srccredit="Eric Baudais"/>
 
376
   </imageobject>
 
377
    <textobject> 
 
378
      <phrase>Screenshot of black blocking.</phrase> 
 
379
    </textobject> 
 
380
  </mediaobject>
 
381
  </screenshot>
 
382
 </figure>
 
383
 </para>
 
384
 
 
385
</sect1>
 
386
 
 
387
<sect1 id="settings">
 
388
 <title>Game Settings</title>
 
389
 
 
390
 <sect2 id="player">
 
391
  <title>Player Color and Difficulty</title>
 
392
 
 
393
  <para>
 
394
  When you start Iagno the human player plays black and the computer player 
 
395
  plays white with the first level of difficulty. Using the
 
396
  <guimenuitem>Game</guimenuitem> tab in the
 
397
  <guisubmenu>Preferences</guisubmenu> dialog you can set the type of
 
398
  player for each color. Human is of course you, level one is the
 
399
  easiest computer player and level three is the hardest. You can set
 
400
  both to human to play against a friend or set both to computer to
 
401
  watch the computer play itself.
 
402
  </para>
 
403
 </sect2>
 
404
 
 
405
 <sect2 id="quick-moves">
 
406
  <title>Quick Moves Option</title>
 
407
 
 
408
  <para>
 
409
  This option is in the <guimenu>Settings</guimenu> menu. Then go to the 
 
410
  <guisubmenu>Preferences</guisubmenu> submenu in the <guimenuitem>Game
 
411
  </guimenuitem> tab and it is initially off. When enabled this option 
 
412
  makes the computer player place its tiles faster. 
 
413
  </para>
 
414
 
 
415
  <note>
 
416
   <title>Note:</title>
 
417
   <para>
 
418
   Enabling this option does not force the computer player to move and does 
 
419
   not reduce the level of difficulty.
 
420
   </para>
 
421
  </note>
 
422
 </sect2>
 
423
 
 
424
 <sect2 id="enable-sound">
 
425
  <title>Enable/Disable Sound</title>
 
426
 
 
427
  <para>
 
428
  The last option of the <guimenuitem>Game</guimenuitem> tab in the
 
429
  <guilabel>Preferences</guilabel> dialog allows you to enable or disable all
 
430
  sounds when playing in <application>Iagno</application>. 
 
431
  </para>
 
432
 
 
433
  <figure id="player-shot">
 
434
   <title>The Preferences menu with the Game tab highlighted.</title>
 
435
   <screenshot>
 
436
    <mediaobject> 
 
437
    <imageobject>
 
438
  <imagedata format="PNG" fileref="figures/PLAYER.png" srccredit="Eric Baudais"/>
 
439
   </imageobject>
 
440
    <textobject> 
 
441
      <phrase>Screenshot of the game settings.</phrase> 
 
442
    </textobject> 
 
443
  </mediaobject>
 
444
   </screenshot>
 
445
  </figure>
 
446
 
 
447
 </sect2>
 
448
 
 
449
</sect1>
 
450
 
 
451
<sect1 id="animations">
 
452
 <title>Appearance</title>
 
453
 
 
454
 <para>
 
455
 All the animation option are in the 
 
456
 <menuchoice>
 
457
  <guimenu>Settings</guimenu>
 
458
  <guisubmenu>Preferences </guisubmenu>
 
459
 </menuchoice>
 
460
 menus with the <guimenuitem>Appearance</guimenuitem> tab highlighted.
 
461
 </para>
 
462
 
 
463
 <sect2 id="animation-amount">
 
464
  <title>Animation</title>
 
465
 
 
466
  <para>
 
467
  This option controls the amount of animation present when each tile is 
 
468
  flipped, using radio buttons.  Selecting the option <guibutton>none
 
469
  </guibutton> will cause the tiles to change color instantaneously.  
 
470
  Selecting the <guibutton>option</guibutton> partial will cause the 
 
471
  animation to flip the tiles slowly.  Selecting the <guibutton>complete
 
472
  </guibutton> option will cause the tiles to flip slowly and smoothly.
 
473
  </para>
 
474
 
 
475
 </sect2>
 
476
 
 
477
 <sect2 id="stagger-flips">
 
478
  <title>Stagger Flips</title>
 
479
  
 
480
  <para>
 
481
  This option causes captured tiles along a row, column, or diagonal to
 
482
  flip one after another, like dominoes, instead of all flipping
 
483
  simultaneously.  It has no effect on game play, but looks cool.
 
484
  </para>
 
485
 
 
486
 </sect2>
 
487
 
 
488
 <sect2 id="grid">
 
489
  <title>Show Grid</title>
 
490
 
 
491
  <para>
 
492
  This option will display a grid on top of the playing surface.  The 
 
493
  grid is useful to display because it shows the player exactly where 
 
494
  they are placing each tile.
 
495
  </para>
 
496
 
 
497
  <tip>
 
498
   <title>Tip:</title>
 
499
   <para>
 
500
   This option should be enabled for beginning players to see the gameplay 
 
501
   more clearly.
 
502
   </para>
 
503
  </tip>
 
504
 
 
505
 </sect2>
 
506
 
 
507
 <sect2 id="flip-final">
 
508
  <title>Flip Final Results</title>
 
509
 
 
510
  <para>
 
511
  This option moves all the black tiles to the top of the board and all the 
 
512
  white tiles to the bottom of the board at the end of the game.  This allows 
 
513
  you to visually see the outcome of the game.
 
514
  </para>
 
515
 
 
516
  <note>
 
517
   <title>Note:</title>
 
518
   <para>
 
519
   This option does not affect the outcome of the game in any way.
 
520
   </para>
 
521
  </note>
 
522
 
 
523
 </sect2>
 
524
 
 
525
 <sect2 id="tile-set">
 
526
  <title>Tile Set</title>
 
527
  <para>
 
528
  This option lets you choose the type of board and tiles which are displayed.  
 
529
  If you want to make your own tile sets use the classic tile set as a template 
 
530
  and change the texture and colors for different effects.  When you make a new 
 
531
  tile set that works with Iagno send it to Ian Peters <email>itp@gnu.org</email> 
 
532
  and he will include it with the next distribution.
 
533
  </para>
 
534
 
 
535
  <important>
 
536
   <title>Important:</title>
 
537
   <para>
 
538
   There are two tile sets which look the same, but have different
 
539
   animations -- woodtrim and classic.
 
540
   </para>
 
541
  </important>
 
542
 
 
543
  <figure id="animation-shot">
 
544
   <title>The Preferences menu with the Appearance tab highlighted.</title>
 
545
   <screenshot>
 
546
    <mediaobject> 
 
547
    <imageobject>
 
548
  <imagedata format="PNG" fileref="figures/ANIMATION.png" srccredit="Eric Baudais"/>
 
549
    </imageobject>
 
550
    <textobject> 
 
551
      <phrase>Screenshot of the animation settings.</phrase> 
 
552
    </textobject> 
 
553
  </mediaobject>
 
554
   </screenshot>
 
555
  </figure>
 
556
 
 
557
 </sect2>
 
558
 
 
559
</sect1>
 
560
 
 
561
<!-- ============= Network games  ===============================================
 
562
 This doc is common to gnome-games. The file is pulled in from gnibbles directory
 
563
 as a SVN symlink, and included here. Therefore translators only have to translate 
 
564
 the network stuff once, instead of one time for each game. 
 
565
 ================================ -->
 
566
 
 
567
  <!-- ============= Network Games Documentation ============================= 
 
568
   This documentation is written so that is can be reused for all the 
 
569
   gnome-games which have network multiplayer support. Therefore no direct
 
570
   references to a specific game should be made. Further, this file is currently
 
571
   included in the various games as a SVN symlink. The figures can also
 
572
   be included as SVN symlinks to avoid duplication of the same images.
 
573
  -->
 
574
 
 
575
 <sect1 id="network-games">
 
576
  <title>Network Games</title>
 
577
  <para>
 
578
    Iagno support networked multiplayer games which is provided by <ulink type="http" url="http://www.ggzgamingzone.org">GGZ Gaming Zone</ulink>. By connecting to a Iagno server
 
579
    on the Internet, you can challenge other players in multiplayer games.
 
580
    For news, updates and a list of servers to connect to, see the <ulink type="http" url="http://www.gnome.org/projects/gnome-games/">gnome-games website</ulink>.
 
581
  </para>
 
582
  <para>
 
583
    To start the multiplayer game of Iagno, select <menuchoice><guimenu>Game</guimenu> 
 
584
    <guimenuitem>Network Game</guimenuitem></menuchoice> on the Iagno menu.
 
585
  </para> 
 
586
 
 
587
<sect2 id="connecting">
 
588
<title>Connecting to a Iagno network server</title>
 
589
<para>
 
590
The Iagno connection dialog is shown initially when starting a new
 
591
network game. This dialog allows you to select a server to connect to,
 
592
and the username that you will have while connected to that server.  
 
593
</para>
 
594
 
 
595
<para>
 
596
It is possible to connect to a server with either a guest account or a normal
 
597
registered account. Guest accounts allows you to anonymously login, while
 
598
a normal login account allows you to reserve your own username which
 
599
is protected by the password that you choose.
 
600
</para>
 
601
 
 
602
<para> The <guimenuitem>Guest Login</guimenuitem> option should be selected
 
603
if you want an anonymous guest account. If you want to create a new 
 
604
login account, then select the <guimenuitem>First-time Login</guimenuitem> 
 
605
option, with the username, password and email of your choice.
 
606
If you have already created your account, you can connect by selecting
 
607
the <guimenuitem>Normal Login</guimenuitem> option, and enter the
 
608
username and password that you have chosen.
 
609
</para>
 
610
<para>
 
611
To connect to a server, click on the <guimenuitem>Connect</guimenuitem> button.
 
612
</para>
 
613
<figure id="connect">
 
614
<title>The Iagno network connection dialog.</title>
 
615
<screenshot>
 
616
  <mediaobject> 
 
617
    <imageobject>
 
618
  <imagedata fileref="figures/connect.png" format="PNG" srccredit="Andreas Røsdal"/>
 
619
    </imageobject>
 
620
    <textobject> 
 
621
      <phrase>The Iagno network connection dialog.</phrase> 
 
622
    </textobject> 
 
623
  </mediaobject>
 
624
</screenshot>
 
625
</figure>
 
626
</sect2>
 
627
 
 
628
<sect2 id="joining">
 
629
<title>Joining a game room</title>
 
630
<para>
 
631
Once you have successfully connected to a server, you can choose which game room to join. To play a multiplayer game of Iagno, select the Iagno room. If you want to host your own game, then click on the Launch button. This creates a new table where other players can participate in a game against you. 
 
632
If there are any other games already started, then you can double-click on an existing game table to join it.
 
633
The list of game tables on the right shows you the number of available seats, which means the
 
634
number of players that can join the game table.
 
635
</para>
 
636
<figure id="tables">
 
637
<title>This Iagno network dialog allows you to join a game room to find other players.</title>
 
638
<screenshot>
 
639
  <mediaobject> 
 
640
    <imageobject>
 
641
  <imagedata fileref="figures/tables.png" format="PNG" srccredit="Andreas Røsdal"/>
 
642
    </imageobject>
 
643
    <textobject> 
 
644
      <phrase>This Iagno network dialog allows you to join a game room to find other players.</phrase> 
 
645
    </textobject> 
 
646
  </mediaobject>
 
647
</screenshot>
 
648
</figure>
 
649
<para>
 
650
When creating a new table for Iagno games, a preference dialog is displayed which allows you to
 
651
customize the game, such as set the minimum number of players for the game. Once the total
 
652
number of seats have been taken, then no more players are allowed to join that game table.
 
653
</para>
 
654
<para>
 
655
It is possible to chat with other players in network games. Ask for advice or help playing the games,
 
656
but please be polite against other players.
 
657
</para>
 
658
</sect2>
 
659
 
 
660
<sect2 id="pregame">
 
661
<title>Waiting for other players to join the game</title>
 
662
<para>
 
663
Once you have successfully joined a game table, then you have to wait until enough
 
664
players have joined the table. The <guimenuitem>Players List</guimenuitem> menu item
 
665
allows you to see a list of the players who have joined the game.
 
666
The game will begin immediately when the total number of players in the the game have been reached.
 
667
</para>
 
668
</sect2>
 
669
 
 
670
<sect2 id="playing-multiplayer">
 
671
<title>Playing multiplayer Iagno games</title>
 
672
<para>
 
673
Multiplayer Iagno games have pretty much the same rules as normal Iagno games,
 
674
except that you are now playing against human players. This means that other
 
675
strategies might possibly be better than when playing against AI players.
 
676
</para>
 
677
<para>
 
678
Once a player has won, the game ends and you can return to the initial network game screen.
 
679
Then you can play yet another game of addictive Iagno multiplayer!
 
680
</para>
 
681
</sect2>
 
682
 
 
683
</sect1>
 
684
 
 
685
 
 
686
 
 
687
 
 
688
<sect1 id="bugs">
 
689
 <title>Known Bugs and Limitations</title>
 
690
 
 
691
 <itemizedlist mark="opencircle">
 
692
    <listitem>
 
693
     <para>
 
694
        The computer player for Iagno is easy to beat.
 
695
     </para>
 
696
    </listitem>
 
697
 </itemizedlist>
 
698
 
 
699
</sect1>
 
700
 
 
701
<sect1 id="credits">
 
702
 <title>Authors</title>
 
703
  <para>
 
704
   <application>Iagno</application> was written by Ian Peters
 
705
   (<email>itp@gnu.org</email>).    This manual was written by Eric Baudais
 
706
   (<email>baudais@okstate.edu</email>).
 
707
   To report a bug or make a suggestion regarding this application or
 
708
   this manual, follow the directions in this 
 
709
   <ulink url="ghelp:user-guide?feedback-bugs" type="help">document</ulink>.
 
710
  </para>
 
711
 
 
712
  <!-- For translations: uncomment this:
 
713
 
 
714
  <para>
 
715
   Latin translation was done by ME
 
716
   (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
 
717
   suggestions regarding this translation to SOMEWHERE.
 
718
  </para>
 
719
 
 
720
  -->
 
721
 
 
722
 </sect1>
 
723
 
 
724
 
 
725
 <!-- ============= Application License ============================= -->
 
726
 
 
727
 <sect1 id="license">
 
728
  <title>License</title>
 
729
  <para>
 
730
   This program is free software; you can redistribute it and/or
 
731
   modify it under the terms of the <citetitle>GNU General Public
 
732
   License</citetitle> as published by the Free Software Foundation;
 
733
   either version 2 of the License, or (at your option) any later
 
734
   version.
 
735
  </para>
 
736
  <para>
 
737
   This program is distributed in the hope that it will be useful, but
 
738
   WITHOUT ANY WARRANTY; without even the implied warranty of
 
739
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
740
   <citetitle>GNU General Public License</citetitle> for more details.
 
741
  </para>
 
742
  <para>
 
743
   A copy of the <citetitle>GNU General Public License</citetitle> is
 
744
   included as an appendix to the <citetitle>GNOME Users
 
745
   Guide</citetitle>.  You may also obtain a copy of the
 
746
   <citetitle>GNU General Public License</citetitle> from the Free
 
747
   Software Foundation by visiting <ulink type="http" url="http://www.fsf.org">their Web site</ulink> or by writing to
 
748
   <address>
 
749
    Free Software Foundation, Inc.
 
750
    <street>59 Temple Place</street> - Suite 330
 
751
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
 
752
    <country>USA</country>
 
753
   </address>
 
754
  </para>
 
755
 </sect1>
 
756
</article>