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

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Jeremy Bicha
  • Date: 2012-02-06 22:22:58 UTC
  • mfrom: (1.1.103)
  • Revision ID: package-import@ubuntu.com-20120206222258-28gah1dnl2ij0kw0
Tags: 1:3.3.5-0ubuntu1
* New upstream release.
  - Performance was improved in Iagno, Mahjongg & Mines
  - Statusbar was removed from Iagno and Mines
  - Mines has a new game screen
  - Quadrapassel was ported to Vala
  - Quadrapassel has a new option to show where block
    will land
* debian/control.in:
  - Bump vala to valac-0.16 and GTK to 3.3.11
  - Build-Depend on yelp-tools instead of gnome-doc-utils
* Update install files for new help install location
* debian/patches/01_lpi.patch: Refreshed

Show diffs side-by-side

added added

removed removed

Lines of Context:
13
13
<!-- please do not change the id -->
14
14
<!-- translators, change lang to the appropriate code -->
15
15
  <articleinfo>
16
 
    <title>Four-in-a-Row Manual</title>
 
16
    <title lang="en">Four-in-a-Row Manual</title>
17
17
    <abstract role="description">
18
 
      <para>
 
18
      <para lang="en">
19
19
        The object of Four-in-a-Row is to place four pieces in a vertical, 
20
20
        horizontal, or diagonal row while the opponent tries to block and
21
21
        make his/her own row of four. Four-in-a-Row can be played against 
23
23
      </para>
24
24
    </abstract>
25
25
 
26
 
    <copyright>
 
26
    <copyright lang="en">
27
27
      <year>2001-2002</year>
28
28
      <holder>Timothy Musson</holder>
29
29
    </copyright>
42
42
    </publisher> 
43
43
 
44
44
      <legalnotice id="legalnotice">
45
 
        <para>
 
45
        <para lang="en">
46
46
          Permission is granted to copy, distribute and/or modify this
47
47
          document under the terms of the GNU Free Documentation
48
48
          License (GFDL), Version 1.1 or any later version published
51
51
          a copy of the GFDL at this <ulink type="help" url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
52
52
          distributed with this manual.
53
53
         </para>
54
 
         <para> This manual is part of a collection of GNOME manuals
 
54
         <para lang="en"> This manual is part of a collection of GNOME manuals
55
55
          distributed under the GFDL.  If you want to distribute this
56
56
          manual separately from the collection, you can do so by
57
57
          adding a copy of the license to the manual, as described in
58
58
          section 6 of the license.
59
59
        </para>
60
60
 
61
 
        <para>
 
61
        <para lang="en">
62
62
          Many of the names used by companies to distinguish their
63
63
          products and services are claimed as trademarks. Where those
64
64
          names appear in any GNOME documentation, and the members of
67
67
          capital letters.
68
68
        </para>
69
69
 
70
 
        <para>
 
70
        <para lang="en">
71
71
          DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
72
72
          UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
73
73
          WITH THE FURTHER UNDERSTANDING THAT:
74
74
 
75
75
          <orderedlist>
76
76
                <listitem>
77
 
                  <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
 
77
                  <para lang="en">DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
78
78
                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
79
79
                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
80
80
                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
94
94
                  </para>
95
95
                </listitem>
96
96
                <listitem>
97
 
                  <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
 
97
                  <para lang="en">UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
98
98
                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
99
99
                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
100
100
                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
119
119
 
120
120
 
121
121
    <authorgroup>
122
 
      <author>
 
122
      <author lang="en">
123
123
        <firstname>Timothy</firstname>
124
124
        <surname>Musson</surname>
125
125
        <affiliation>
146
146
        <releaseinfo revision="2.26" role="review"/>
147
147
 
148
148
    <revhistory>
149
 
      <revision>
 
149
      <revision lang="en">
150
150
        <revnumber>Four-in-a-Row Manual V2.8</revnumber>
151
 
        <date>Setembre de 2004</date>
 
151
        <date>September 2004</date>
152
152
        <revdescription>
153
 
          <para role="author">Timothy Musson <email>trmusson@ihug.co.nz</email></para>
 
153
          <para role="author" lang="en">Timothy Musson
 
154
            <email>trmusson@ihug.co.nz</email>
 
155
          </para>
154
156
          <para role="publisher"/>
155
157
        </revdescription>
156
158
      </revision>
157
159
    </revhistory>
158
160
 
159
 
    <releaseinfo>This manual describes version 2.12 of Four-in-a-Row.
 
161
    <releaseinfo lang="en">This manual describes version 2.12 of Four-in-a-Row.
160
162
    </releaseinfo>
161
163
 
162
164
    <legalnotice>
163
 
      <title>Feedback</title>
164
 
      <para>To report a bug or make a suggestion regarding the Four-in-a-Row
 
165
      <title lang="en">Feedback</title>
 
166
      <para lang="en">To report a bug or make a suggestion regarding the Four-in-a-Row
165
167
        application or this manual, follow the directions in the
166
168
        <ulink url="ghelp:user-guide?feedback-bugs" type="help">GNOME Feedback Page</ulink>.
167
169
      </para>
178
180
 
179
181
    <title>Introduccion</title>
180
182
 
181
 
    <para>
 
183
    <para lang="en">
182
184
      <application>Four-in-a-Row</application> is a four-in-a-row game for the GNOME Project.
183
185
      The object of the game is to build a line of four of your marbles
184
186
      while trying to stop your opponent (human or computer) building a
186
188
      diagonal.
187
189
    </para>
188
190
 
189
 
    <para>
 
191
    <para lang="en">
190
192
      To run <application>Four-in-a-Row</application>, select
191
193
      <guimenuitem>Four-in-a-Row</guimenuitem> from the
192
194
      <guisubmenu>Games</guisubmenu> submenu of the
194
196
      <command>gnect</command> on the command line.
195
197
    </para>
196
198
 
197
 
    <para>
 
199
    <para lang="en">
198
200
      <application>Four-in-a-Row</application> is included in the <filename>GNOME-games</filename> package,
199
201
      which is part of the GNOME desktop environment. This document describes
200
202
      version 2.8 of <application>Four-in-a-Row</application>.
201
203
    </para>
202
204
 
203
 
   <para>
 
205
   <para lang="en">
204
206
     Four-in-a-Row also features multiplayer support with two 
205
207
     human players in hotseat mode.
206
208
   </para>
214
216
 
215
217
  <sect1 id="usage">
216
218
 
217
 
    <title>Basic Usage</title>
 
219
    <title lang="en">Basic Usage</title>
218
220
 
219
221
    <!-- ===== How to play ===== -->
220
222
 
221
223
    <sect2 id="playing">
222
224
 
223
 
      <title>Playing Four-in-a-Row</title>
 
225
      <title lang="en">Playing Four-in-a-Row</title>
224
226
 
225
 
      <para>
 
227
      <para lang="en">
226
228
        To start a new game of Four-in-a-Row choose <menuchoice><guimenu>Game</guimenu><guimenuitem>New Game</guimenuitem></menuchoice>.
227
229
      </para>
228
230
 
229
 
      <para>
 
231
      <para lang="en">
230
232
        The <interface>game board</interface> consists of seven columns and
231
233
        six rows. Above it, a special row indicates the current player and the marble about to be played. Each move consists of dropping a marble in one of the columns. The marble lands on the topmost empty row of the chosen column.
232
234
      </para>
233
235
        
234
 
      <para>To make a move, click on a column with the mouse. To play with the keyboard, move the marble in the top row with the left and right arrow keys, and drop it in place with the  down arrow key. Your marble will drop into the topmost empty row of that column.
 
236
      <para lang="en">To make a move, click on a column with the mouse. To play with the keyboard, move the marble in the top row with the left and right arrow keys, and drop it in place with the  down arrow key. Your marble will drop into the topmost empty row of that column.
235
237
      </para>
236
238
 
237
239
      <!-- Figure -->
238
 
      <mediaobject id="mainwindow-fig">
 
240
      <mediaobject id="mainwindow-fig" lang="en">
239
241
        <imageobject>
240
242
          <imagedata fileref="figures/mainwindow.png" format="PNG" srccredit="trm"/>
241
243
        </imageobject>
242
244
        <textobject>
243
245
          <phrase>Four-in-a-Row's Main Window</phrase>
244
246
        </textobject>
245
 
        <caption><para>Four-in-a-Row's Main Window</para></caption>
 
247
        <caption><para lang="en">Four-in-a-Row's Main Window</para></caption>
246
248
      </mediaobject>
247
249
 
248
 
      <para>
 
250
      <para lang="en">
249
251
        The game is won when one of the two players manages to line up four
250
252
        of his or her marbles horizontally, vertically or diagonally. If the
251
253
        board fills up without a win, the game ends in a draw.
259
261
      <title>Comandas</title>
260
262
      <anchor id="menubar"/><!-- id for removed section -->
261
263
      
262
 
      <para>To take back a move, choose <menuchoice>
 
264
      <para lang="en">To take back a move, choose <menuchoice>
263
265
                      <shortcut><keycombo>
264
266
                      <keysym>Ctrl</keysym><keycap>Z</keycap>
265
267
                      </keycombo></shortcut>
271
273
            Repeating this will return the board to its initial
272
274
            state.
273
275
      </para>
274
 
      <para>Choose <menuchoice>
 
276
      <para lang="en">Choose <menuchoice>
275
277
                      <shortcut><keycombo>
276
278
                      <keysym>Ctrl</keysym><keycap>H</keycap>
277
279
                      </keycombo></shortcut>
279
281
      </menuchoice> to get a suggestion from the computer for your next move.
280
282
      This is shown in the status bar.</para>
281
283
      
282
 
      <para>
 
284
      <para lang="en">
283
285
        Choose <menuchoice>
284
286
          <guimenuitem>Scores</guimenuitem>
285
287
        </menuchoice> to show a tally of wins and draws
296
298
 
297
299
      <title>Preferéncias</title>
298
300
 
299
 
      <para>
 
301
      <para lang="en">
300
302
        To change the game's settings, select
301
303
        <guimenuitem>Preferences</guimenuitem> from the
302
304
        <guimenu>Settings</guimenu> menu. This opens the
303
305
        <interface>Preferences Dialog</interface>.
304
306
      </para>
305
307
 
306
 
      <para>
 
308
      <para lang="en">
307
309
        Configuration options in the <guilabel>Game</guilabel>
308
310
        tab are:
309
311
 
310
312
        <variablelist>
311
313
 
312
314
          <varlistentry>
313
 
            <term>
 
315
            <term lang="en">
314
316
              <guilabel>Player One</guilabel> and
315
317
              <guilabel>Player Two</guilabel>
316
318
            </term>
317
319
            <listitem>
318
 
              <para>
 
320
              <para lang="en">
319
321
 
320
322
                These two columns tell <application>Four-in-a-Row</application> who's playing and, if it is the computer, how hard they play. To play against a friend, select
321
323
                Human for both Player One and Player Two.
325
327
          </varlistentry>
326
328
 
327
329
          <varlistentry>
328
 
            <term><guilabel>Tèma</guilabel></term>
 
330
            <term lang="en"><guilabel>Theme</guilabel></term>
329
331
            <listitem>
330
 
              <para>
 
332
              <para lang="en">
331
333
                The theme menu lists available themes and lets
332
334
                you choose your favourite.
333
335
              </para>
335
337
          </varlistentry>
336
338
 
337
339
          <varlistentry>
338
 
            <term><guilabel>Enable Animation</guilabel></term>
 
340
            <term lang="en"><guilabel>Enable Animation</guilabel></term>
339
341
            <listitem>
340
 
              <para>
 
342
              <para lang="en">
341
343
                Here you can toggle the game's animation on or off.
342
344
              </para>
343
345
            </listitem>
345
347
 
346
348
        </variablelist>
347
349
      </para>
348
 
      <para>
 
350
      <para lang="en">
349
351
          Finally there is a <guilabel>Controls</guilabel> tab to
350
352
          change the keyboard controls. To change a control, double click the
351
353
          appropriate entry and then press the new key.
360
362
 
361
363
  <sect1 id="custom">
362
364
 
363
 
    <title>Creating New Themes</title>
 
365
    <title lang="en">Creating New Themes</title>
364
366
 
365
 
    <para>
 
367
    <para lang="en">
366
368
      This section's included in case you'd like to make your own themes for
367
369
      <application>Four-in-a-Row</application>. It assumes you're familiar with basic text editing, graphics
368
370
      software and the command line.
372
374
 
373
375
      <title>Imatges</title>
374
376
 
375
 
      <para>
 
377
      <para lang="en">
376
378
        <application>Four-in-a-Row</application>'s tile sets contain six tiles of equal size, lined up
377
379
        horizontally. From left to right:
378
380
      </para>
379
381
 
380
382
      <orderedlist>
381
383
        <listitem>
382
 
          <para>Player One's marble as it appears on the game board</para>
383
 
        </listitem>
384
 
        <listitem>
385
 
          <para>Player Two's marble as it appears on the game board</para>
386
 
        </listitem>
387
 
        <listitem>
388
 
          <para>The game board's background</para>
389
 
        </listitem>
390
 
        <listitem>
391
 
          <para>The top row's background</para>
392
 
        </listitem>
393
 
        <listitem>
394
 
          <para>Player One's marble as it appears on the top row</para>
395
 
        </listitem>
396
 
        <listitem>
397
 
          <para>Player Two's marble as it appears on the top row</para>
 
384
          <para lang="en">Player One's marble as it appears on the game board</para>
 
385
        </listitem>
 
386
        <listitem>
 
387
          <para lang="en">Player Two's marble as it appears on the game board</para>
 
388
        </listitem>
 
389
        <listitem>
 
390
          <para lang="en">The game board's background</para>
 
391
        </listitem>
 
392
        <listitem>
 
393
          <para lang="en">The top row's background</para>
 
394
        </listitem>
 
395
        <listitem>
 
396
          <para lang="en">Player One's marble as it appears on the top row</para>
 
397
        </listitem>
 
398
        <listitem>
 
399
          <para lang="en">Player Two's marble as it appears on the top row</para>
398
400
        </listitem>
399
401
      </orderedlist>
400
402
 
401
403
      <figure id="shot1">
402
 
        <title>An example tile set</title>
 
404
        <title lang="en">An example tile set</title>
403
405
        <screenshot>
404
 
          <screeninfo>This image shows the six tiles in a tile set</screeninfo>
 
406
          <screeninfo lang="en">This image shows the six tiles in a tile set</screeninfo>
405
407
          <graphic format="PNG" fileref="figures/tileset.png" srccredit="TRM"/>
406
408
        </screenshot>
407
409
      </figure>
408
410
 
409
 
      <para>
 
411
      <para lang="en">
410
412
        Tiles three and four will be repeated over the game board and
411
413
        top row unless a full window background image is specified in the
412
414
        theme file.
413
415
      </para>
414
416
 
415
417
      <tip>
416
 
        <title>TIP</title>
417
 
        <para>
 
418
        <title lang="en">TIP</title>
 
419
        <para lang="en">
418
420
          PNG format is recommended for tile sets. The first, second, fifth
419
421
          and sixth tiles should contain some transparency if you want the
420
422
          background to show through. The third and fourth tiles should be
424
426
      </tip>
425
427
 
426
428
      <tip>
427
 
        <title>TIP</title>
428
 
        <para>
 
429
        <title lang="en">TIP</title>
 
430
        <para lang="en">
429
431
          Tiles can be square or rectangular, and any size you like. Most
430
432
          of the tile sets that come with <application>Four-in-a-Row</application> use square tiles measuring
431
433
          50 pixels by 50 pixels.
432
434
        </para>
433
435
      </tip>
434
436
 
435
 
      <para>
 
437
      <para lang="en">
436
438
        For a full window background image, there's a bit more work to do.
437
439
        Let's say your tiles measure 50 by 50 pixels each. The game's display
438
440
        measures 7 by 7 tiles, including the top row, so the ideal background
440
442
      </para>
441
443
 
442
444
      <tip>
443
 
        <title>TIP</title>
444
 
        <para>
 
445
        <title lang="en">TIP</title>
 
446
        <para lang="en">
445
447
          <application>Four-in-a-Row</application> will automatically scale the background image if it doesn't
446
448
          match the tile set. This means you can make "large" and "small"
447
449
          versions of your theme, both using the same background image,
449
451
        </para>
450
452
      </tip>
451
453
 
452
 
      <para>
 
454
      <para lang="en">
453
455
        So, you now have a tile set and perhaps a background image to
454
456
        go with it. The next step is to put them in the right place.
455
457
      </para>
459
461
 
460
462
    <sect2 id="directories">
461
463
 
462
 
      <title>Putting It Together</title>
 
464
      <title lang="en">Putting It Together</title>
463
465
 
464
 
      <para>
 
466
      <para lang="en">
465
467
        The last step is to put your image(s) where <application>Four-in-a-Row</application> can
466
468
        find them. You could put them in Four-in-a-row's install directory (which will
467
469
        depend on your particular system), but your home directory's probably
468
470
        a better idea.
469
471
      </para>
470
472
 
471
 
      <para>
 
473
      <para lang="en">
472
474
        Make a <filename class="directory">~/.gnect</filename> directory,
473
475
        and a <filename class="directory">~/.gnect/pixmaps</filename>
474
476
        directory. Those names are important, as <application>Four-in-a-Row</application> won't look
475
477
        anywhere else.
476
478
      </para>
477
479
 
478
 
      <para>
 
480
      <para lang="en">
479
481
        Copy your image(s) into the pixmaps directory.
480
482
      </para>
481
483
 
482
 
      <para>
 
484
      <para lang="en">
483
485
        If you start <application>Four-in-a-Row</application> from the command line, it'll give you clues about
484
486
        any problems it has with your new theme. If it has none, you'll
485
487
        find your new theme listed the
486
488
        <interface>Preferences Dialog</interface>.
487
489
      </para>
488
490
 
489
 
      <para>Have fun!</para>
 
491
      <para lang="en">Have fun!</para>
490
492
 
491
493
    </sect2>
492
494
 
499
501
 
500
502
  <sect1 id="bugs">
501
503
 
502
 
    <title>Known Bugs and Limitations</title>
 
504
    <title lang="en">Known Bugs and Limitations</title>
503
505
 
504
 
    <para>
 
506
    <para lang="en">
505
507
      Occasionally a marble-dropping animation doesn't look as smooth
506
508
      as it should.
507
509
    </para>
516
518
 
517
519
    <title>Autors</title>
518
520
 
519
 
    <para>
 
521
    <para lang="en">
520
522
      <application>Four-in-a-Row</application> was written by Timothy Musson (<email>trmusson@ihug.co.nz</email>)
521
523
      and David Neary (<email>bolsh@gimp.org</email>). Various others
522
524
      have taken the time to help in many ways since work on <application>Four-in-a-Row</application> began.
523
525
    </para>
524
 
    <para>
 
526
    <para lang="en">
525
527
      The <ulink type="http" url="http://www.ce.unipr.it/~gbe/velena.html">Velena Engine</ulink>,
526
528
      <application>Four-in-a-Row</application>'s main computer player, was written by Giuliano Bertoletti.
527
529
      We're grateful to him for allowing us to include his work, without
528
530
      which <application>Four-in-a-Row</application> wouldn't be nearly as worthwhile.
529
531
    </para>
530
 
    <para>
 
532
    <para lang="en">
531
533
      This manual was written by Timothy Musson.
532
534
    </para>
533
 
    <para>
 
535
    <para lang="en">
534
536
   To report a bug or make a suggestion regarding this application or
535
537
   this manual, follow the directions in this 
536
538
   <ulink url="ghelp:user-guide?feedback-bugs" type="help">document</ulink>.
557
559
 
558
560
    <title>Licéncia</title>
559
561
 
560
 
    <para>
 
562
    <para lang="en">
561
563
      This program is free software; you can redistribute it and/or
562
564
      modify it under the terms of the <citetitle>GNU General Public
563
565
      License</citetitle> as published by the Free Software Foundation;
565
567
      version.
566
568
    </para>
567
569
 
568
 
    <para>
 
570
    <para lang="en">
569
571
      This program is distributed in the hope that it will be useful, but
570
572
      WITHOUT ANY WARRANTY; without even the implied warranty of
571
573
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
572
574
      <citetitle>GNU General Public License</citetitle> for more details.
573
575
    </para>
574
576
 
575
 
    <para>
 
577
    <para lang="en">
576
578
      A copy of the <citetitle>GNU General Public License</citetitle> is
577
579
      included as an appendix to the <citetitle>GNOME Users
578
580
      Guide</citetitle>.  You may also obtain a copy of the
580
582
      Software Foundation by visiting
581
583
      <ulink url="http://www.fsf.org" type="http">their Web site</ulink> or
582
584
      by writing to
583
 
      <address>
 
585
      <address lang="en">
584
586
        Free Software Foundation, Inc.
585
587
        <street>59 Temple Place</street> - Suite 330
586
588
        <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>