~ubuntu-branches/ubuntu/gutsy/gnome-games/gutsy

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Aron Sisak
  • Date: 2007-08-28 11:17:57 UTC
  • mfrom: (1.1.35)
  • Revision ID: package-import@ubuntu.com-20070828111757-p1o9q24u57fbgkuq
Tags: 1:2.19.91-0ubuntu1
* New upstream release:
  - Sudoku:
    - Fix a crash when solving a sudoku, caused by a type mismatch (#470523).
  - Aisleriot:
    - Fix translation of "Autoplay" in Napoleons Tomb (#469363).
  - Gnometris:
    - Remove gaussian blur in background image to improve rendering performance.
  - Mahjongg:
    - Fix workaround for bug #353964. (LP: #94851)
* debian/patches/99_autoconf.patch:
  - Update via automagic

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