~ubuntu-branches/ubuntu/trusty/gcompris/trusty

« back to all changes in this revision

Viewing changes to docs/C/gcompris.html

  • Committer: Bazaar Package Importer
  • Author(s): Yann Dirson
  • Date: 2002-04-21 16:16:27 UTC
  • Revision ID: james.westby@ubuntu.com-20020421161627-s07yahahm817qxs6
Tags: upstream-1.0.3
ImportĀ upstreamĀ versionĀ 1.0.3

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<HTML>
 
2
<HEAD>
 
3
<!-- Created by texi2html 1.56k from gcompris.texi on 18 April 2002 -->
 
4
 
 
5
<TITLE>GCompris Documentation</TITLE>
 
6
</HEAD>
 
7
<BODY>
 
8
<H1>GCompris Documentation</H1>
 
9
<ADDRESS>Written By Bruno Coudoin</ADDRESS>
 
10
<P>
 
11
<P><HR><P>
 
12
<H1>Table of Contents</H1>
 
13
<UL>
 
14
<LI><A NAME="TOC1" HREF="gcompris.html#SEC1">Introduction</A>
 
15
<UL>
 
16
<LI><A NAME="TOC2" HREF="gcompris.html#SEC2">Why GCompris</A>
 
17
</UL>
 
18
<LI><A NAME="TOC3" HREF="gcompris.html#SEC3">User Manual</A>
 
19
<UL>
 
20
<LI><A NAME="TOC4" HREF="gcompris.html#SEC4">Control</A>
 
21
<LI><A NAME="TOC5" HREF="gcompris.html#SEC5">Gameplay</A>
 
22
<UL>
 
23
<LI><A NAME="TOC6" HREF="gcompris.html#SEC6">Main window</A>
 
24
<LI><A NAME="TOC7" HREF="gcompris.html#SEC7">Starting a game</A>
 
25
<LI><A NAME="TOC8" HREF="gcompris.html#SEC8">Ending a game</A>
 
26
<LI><A NAME="TOC9" HREF="gcompris.html#SEC9">Game status</A>
 
27
</UL>
 
28
</UL>
 
29
<LI><A NAME="TOC10" HREF="gcompris.html#SEC10">Internationalization Issues</A>
 
30
<UL>
 
31
<LI><A NAME="TOC11" HREF="gcompris.html#SEC11">Is my language supported?</A>
 
32
<LI><A NAME="TOC12" HREF="gcompris.html#SEC12">How to translate GCompris for my language</A>
 
33
</UL>
 
34
<LI><A NAME="TOC13" HREF="gcompris.html#SEC13">Developers Guide</A>
 
35
<UL>
 
36
<LI><A NAME="TOC14" HREF="gcompris.html#SEC14">Why adding boards to GCompris</A>
 
37
<LI><A NAME="TOC15" HREF="gcompris.html#SEC15">How to add boards to GCompris</A>
 
38
<UL>
 
39
<LI><A NAME="TOC16" HREF="gcompris.html#SEC16">The whole picture</A>
 
40
<LI><A NAME="TOC17" HREF="gcompris.html#SEC17">GCompris API</A>
 
41
<LI><A NAME="TOC18" HREF="gcompris.html#SEC18">Example of duplicating an existing board to create your own</A>
 
42
</UL>
 
43
</UL>
 
44
<LI><A NAME="TOC19" HREF="gcompris.html#SEC19">GNU Free Documentation License</A>
 
45
<UL>
 
46
<UL>
 
47
<LI><A NAME="TOC20" HREF="gcompris.html#SEC20">ADDENDUM: How to use this License for your documents</A>
 
48
</UL>
 
49
</UL>
 
50
<LI><A NAME="TOC21" HREF="gcompris.html#SEC21">Concept Index</A>
 
51
</UL>
 
52
<P><HR><P>
 
53
 
 
54
 
 
55
<H1><A NAME="SEC1" HREF="gcompris.html#TOC1">Introduction</A></H1>
 
56
 
 
57
 
 
58
<H2><A NAME="SEC2" HREF="gcompris.html#TOC2">Why GCompris</A></H2>
 
59
<P>
 
60
GCompris intent is to provide a central location where a user can find different kind of small educational content called 'boards'.
 
61
 
 
62
 
 
63
<P>
 
64
Today there is already a lot of free software that provides a small education content.
 
65
Unfortunatly, it is difficult to track, intall and use them because they do not evolve
 
66
at the same speed and offer their own user interface.
 
67
 
 
68
 
 
69
<P>
 
70
GCompris aims to provide a unique user interface that gives access to different boards.
 
71
 
 
72
 
 
73
<P>
 
74
GCompris is part of the GNU project.
 
75
 
 
76
 
 
77
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
 
78
<body text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#000080" alink="#FF0000">
 
79
</body>
 
80
 
 
81
<P>
 
82
<A NAME="IDX1"></A>
 
83
 
 
84
 
 
85
 
 
86
 
 
87
<H1><A NAME="SEC3" HREF="gcompris.html#TOC3">User Manual</A></H1>
 
88
 
 
89
 
 
90
<H2><A NAME="SEC4" HREF="gcompris.html#TOC4">Control</A></H2>
 
91
<P>
 
92
All controls are designed to be user friendly for the youngest. For this reason, GCompris does not stick to the Gnome standard for user interfaces.
 
93
GCompris is controlled with a mouse. It cannot be used without a mouse or a pointer device.
 
94
 
 
95
 
 
96
 
 
97
 
 
98
<H2><A NAME="SEC5" HREF="gcompris.html#TOC5">Gameplay</A></H2>
 
99
<P>
 
100
<A NAME="IDX2"></A>
 
101
<A NAME="IDX3"></A>
 
102
 
 
103
 
 
104
 
 
105
 
 
106
<H3><A NAME="SEC6" HREF="gcompris.html#TOC6">Main window</A></H3>
 
107
<P>
 
108
Once started, GCompris presents a graphical view that includes from top to bottom:
 
109
 
 
110
<OL>
 
111
<LI>
 
112
 
 
113
A menu.
 
114
 
 
115
From the menu, you can Quit GCompris. There is also an entry where you can find the help.
 
116
<LI>
 
117
 
 
118
Boards icon list
 
119
 
 
120
Each icon represent a board. When you move the mouse over them, they are highlighted and the name and description of the board is displayed in the board description area.
 
121
<LI>
 
122
 
 
123
<EM>Boards description area</EM>
 
124
 
 
125
Display a small description of what the highlited board icon is about.
 
126
Note that the descriptions are internationalized which means translated in a target language (See section <A HREF="gcompris.html#SEC10">Internationalization Issues</A> for more information on Internationalization).
 
127
 
 
128
<LI>
 
129
 
 
130
Control bar:
 
131
<A NAME="IDX4"></A>
 
132
The control bar is always present in GCompris. This icons are contextual which means that when an icon is not meaningfull in a specific contect, it is simply not displayed.
 
133
 
 
134
The control bar contains the icons from left to right:
 
135
 
 
136
<OL>
 
137
<LI>
 
138
 
 
139
Help:
 
140
<A NAME="IDX5"></A>
 
141
In some case, a board can be too complex to be described in the <EM>Board description area</EM>. In this case this will provide access to the additionnal instructions.
 
142
 
 
143
<LI>
 
144
 
 
145
Level:
 
146
<A NAME="IDX6"></A>
 
147
Some boards provide different level. The number of levels is board dependant.
 
148
 
 
149
<LI>
 
150
 
 
151
OK:
 
152
<A NAME="IDX7"></A>
 
153
Some boards do not automatically detect that the child has finish the given task. Clicking here is similar to entering <KBD>RET</KBD> on the keyboard and thus the <KBD>RET</KBD> key is a shortcut.
 
154
 
 
155
<LI>
 
156
 
 
157
End:
 
158
<A NAME="IDX8"></A>
 
159
End the current board if any, otherwise Exit GCompris.
 
160
When entered at the board menu level, it will create a dialog window to confirm the Exit of GCompris.
 
161
<A NAME="IDX9"></A>
 
162
 
 
163
<LI>
 
164
 
 
165
About:
 
166
<A NAME="IDX10"></A>
 
167
Display the about box for gcompris with the version number, the author, the licence and links to online resources.
 
168
<A NAME="IDX11"></A>
 
169
 
 
170
<LI>
 
171
 
 
172
Configure:
 
173
<A NAME="IDX12"></A>
 
174
Display the configuration box for gcompris. Configuration can be done at gcompris level when no boards is selected.
 
175
If a board is selected, it can provides configuration options.
 
176
Configuration is persistent and saved in the gnome file in the user home directory under .gnome/gcompris.
 
177
<A NAME="IDX13"></A>
 
178
 
 
179
</OL>
 
180
 
 
181
</OL>
 
182
 
 
183
 
 
184
 
 
185
<H3><A NAME="SEC7" HREF="gcompris.html#TOC7">Starting a game</A></H3>
 
186
<P>
 
187
At the menu level, just click on the board icon.
 
188
 
 
189
 
 
190
 
 
191
 
 
192
<H3><A NAME="SEC8" HREF="gcompris.html#TOC8">Ending a game</A></H3>
 
193
<P>
 
194
In the control bar, select the right most icon.
 
195
 
 
196
 
 
197
 
 
198
 
 
199
<H3><A NAME="SEC9" HREF="gcompris.html#TOC9">Game status</A></H3>
 
200
<P>
 
201
The bottom of the GCompris window
 
202
 
 
203
 
 
204
 
 
205
 
 
206
<H1><A NAME="SEC10" HREF="gcompris.html#TOC10">Internationalization Issues</A></H1>
 
207
 
 
208
 
 
209
<H2><A NAME="SEC11" HREF="gcompris.html#TOC11">Is my language supported?</A></H2>
 
210
<P>
 
211
GCompris is internationalized and today it already supports different languages.
 
212
 
 
213
 
 
214
<P>
 
215
To be sure you're one is done, you can check the 'po' directory found within GCompris source package. If your language is translated, it will contain a file of the form <TT>`fr.po'</TT> where fr means French.
 
216
 
 
217
 
 
218
<P>
 
219
If your language is not supported, you can provide help by doing it for GCompris. For instructions, contact the official project maintainer.
 
220
 
 
221
 
 
222
 
 
223
 
 
224
<H2><A NAME="SEC12" HREF="gcompris.html#TOC12">How to translate GCompris for my language</A></H2>
 
225
<P>
 
226
From the GCompris source file, get the file <TT>`gcompris.pot'</TT>, copy it to a file named <TT>`XX.po'</TT> where XX stands for your locale like 'it' for Italian.
 
227
 
 
228
 
 
229
<P>
 
230
Read the file, it contains all the english text found in GCompris. You just need to write your translation in the empty area after each Engish sentence.
 
231
 
 
232
 
 
233
<P>
 
234
Then, send the translation the the GCompris maintainer. He/She will add it into the next official release.
 
235
 
 
236
 
 
237
 
 
238
 
 
239
<H1><A NAME="SEC13" HREF="gcompris.html#TOC13">Developers Guide</A></H1>
 
240
 
 
241
 
 
242
<H2><A NAME="SEC14" HREF="gcompris.html#TOC14">Why adding boards to GCompris</A></H2>
 
243
<P>
 
244
If you have a game idea that you feel suitable for children, you can create a new project, let's call it gIdea. If you start from scratch, you will have to implement a menu, a status bar, user feedback mecanism and so on.
 
245
 
 
246
 
 
247
<P>
 
248
If gIdea is not a complex and huge program, it can be easier and faster for you to implement your gIdea as a GCompris board.
 
249
This way, you benefit from all the current infrastucture and can focus only on your very Idea.
 
250
 
 
251
 
 
252
<P>
 
253
For the end user, it is also easier to have a unique interface to a bunch of different boards instead of having to install gIdea1 gIdea2 and so on.
 
254
 
 
255
 
 
256
<P>
 
257
It is not the intent of GCompris to becomes a new programming language. It is implemented in C and boards are implemented in C also. Boards and GCompris dynamically linked at runtime (plugins) which makes it possible to distribute new boards independently of the gcompris core.
 
258
 
 
259
 
 
260
<P>
 
261
Current implementation is based on the Gnome Canvas widget (see <A HREF="http://www.gnome.org">http://www.gnome.org</A> documentations). The Gnome Canvas provides a high level
 
262
widget that free programmers of bitmap manipulation when doing graphical application. In current implementation, it
 
263
is not possible to write boards using another widget. If it appears that the Canvas is not powerfull enough, GCompris
 
264
will have to be modified to support other widgets.
 
265
 
 
266
 
 
267
<P>
 
268
Another approach is to have smarter boards that can read data files and behaves accordingly. In this case we can envision a GCompris board editor that will let non
 
269
programmer add content to GCompris. Since the target of GCompris is definitly teachers and educators, this option seems very promising. Note that following this track, the shape board already receives its data through an XML file.
 
270
 
 
271
 
 
272
 
 
273
 
 
274
<H2><A NAME="SEC15" HREF="gcompris.html#TOC15">How to add boards to GCompris</A></H2>
 
275
 
 
276
 
 
277
 
 
278
<H3><A NAME="SEC16" HREF="gcompris.html#TOC16">The whole picture</A></H3>
 
279
 
 
280
<P>
 
281
<IMG SRC="overview.jpg" ALT="overview">
 
282
 
 
283
 
 
284
 
 
285
<H3><A NAME="SEC17" HREF="gcompris.html#TOC17">GCompris API</A></H3>
 
286
 
 
287
<P>
 
288
GCompris provides several sercices to boards developpers.
 
289
These services are described in the file gcompris/gcompris.h
 
290
 
 
291
 
 
292
 
 
293
<UL>
 
294
 
 
295
<LI>
 
296
 
 
297
<CODE>GnomeCanvasItem *gcompris_set_background(GnomeCanvasGroup *parent, gchar *file);</CODE>
 
298
 
 
299
Set the background image for your game. You can get help from gameutil.h
 
300
to load the image.
 
301
 
 
302
<LI>
 
303
 
 
304
<CODE>void gcompris_bar_set_level (GcomprisGame *gcomprisGame);</CODE>
 
305
 
 
306
The user did fine and has to go to the next level. 
 
307
Before calling it, <CODE>gcomprisGame-&#62;level</CODE> must be updated by the
 
308
board.
 
309
 
 
310
<LI>
 
311
 
 
312
<CODE>void gcompris_bar_set_timer (guint time);</CODE>
 
313
 
 
314
The timer is a progress bar that is usually used to inform the user
 
315
of were he/she is in the board. This value must be in the range
 
316
0 to 'maxtimer' given with <CODE>bar_set_maxtimer()</CODE>
 
317
 
 
318
<LI>
 
319
 
 
320
<CODE>void bar_set_maxtimer (guint time);</CODE>
 
321
 
 
322
Set the max value of the progress bar.
 
323
 
 
324
So when you create a board, you must include gcompris/plugin.h to have
 
325
access to those methods (this is already included in gcompris/gcompris.h).
 
326
 
 
327
plugin.h also define the BoardPlugin structure. It is the heart
 
328
of GCompris. Each board creates its own BoardPlugin and give it back to
 
329
Gcompris when called in the get_bplugin_info() entry point:
 
330
 
 
331
<CODE>BoardPlugin* *get_bplugin_info ();</CODE>
 
332
 
 
333
The BoardPlugin returned structure must contains callbacks to your 
 
334
implementation methods.
 
335
 
 
336
The BoardPlugin structure must provide callbaks to at
 
337
least:
 
338
 
 
339
</UL>
 
340
 
 
341
 
 
342
<UL>
 
343
 
 
344
<LI>
 
345
 
 
346
<CODE>void *GcomprisStartBoard     (GcomprisBoard *gcomprisBoard);</CODE>
 
347
 
 
348
This is called by GCompris when this board has been requested by the user
 
349
 
 
350
<LI>
 
351
 
 
352
<CODE>void *GcomprisEndBoard      (void);</CODE>
 
353
 
 
354
This is called by GCompris when the user clicked 'end' in the control bar.
 
355
 
 
356
</UL>
 
357
 
 
358
<P>
 
359
Optionnaly, a GComprisGame structure can contains callbacks to:
 
360
 
 
361
 
 
362
 
 
363
<UL>
 
364
 
 
365
<LI>
 
366
 
 
367
<CODE>gint *GcomprisKeyPress     (guint keyval);</CODE>
 
368
 
 
369
If the board wants to receive user keypress, it must provide this
 
370
callback method. The keyval is not filtered and is returned as
 
371
Gnome return it. Check the Gnome documentation to understand how
 
372
to manipulate it.
 
373
 
 
374
<LI>
 
375
 
 
376
<CODE>void *GcomprisOK           (void);</CODE>
 
377
 
 
378
This method is called when the user click the 'OK' button in the control
 
379
bar. It is a good practice to make the enter and return key behaves
 
380
as the 'ok' button, but it may not be always appropriate. For this reason,
 
381
it is the responsibility of the board implementation to do it.
 
382
 
 
383
<LI>
 
384
 
 
385
<CODE>void *GcomprisSetLevel     (guint level);</CODE>
 
386
 
 
387
This is called with the level requested by the user.
 
388
You provide the maximum number of level you support in <CODE>gcomprisGame-&#62;maxlevel</CODE>.
 
389
 Gcompris will take care to call it only with a valid level value.
 
390
 
 
391
</UL>
 
392
 
 
393
 
 
394
 
 
395
<H3><A NAME="SEC18" HREF="gcompris.html#TOC18">Example of duplicating an existing board to create your own</A></H3>
 
396
 
 
397
<P>
 
398
This describes all the steps required to add a new board to GCompris.
 
399
 
 
400
 
 
401
<P>
 
402
As an example, I describe here how I created the clock game.
 
403
 
 
404
 
 
405
 
 
406
<OL>
 
407
<LI>
 
408
 
 
409
Copy an existing game (closest to your new board).
 
410
<CODE>cp algebra.c clockgame.c</CODE>
 
411
 
 
412
<LI>
 
413
 
 
414
Edit src/boards/Makefile.am and add the file to the list of lib_LTLIBRARIES
 
415
Then add at the end the entries for libclockgame_la_LDFLAGS, 
 
416
libclockgame_la_LIBADD and libclockgame_la_SOURCES. Look at examples in src/boards/Makefile.am
 
417
to see how to do that.
 
418
 
 
419
<LI>
 
420
 
 
421
In clockgame.c replace all 'algebra' by 'clockgame'
 
422
 
 
423
<LI>
 
424
 
 
425
In clockgame.c set the proper information for the new game:
 
426
 
 
427
<CODE>if(g_strcasecmp(gcomprisBoard-&#62;type, "clockgame")==0)</CODE>
 
428
 
 
429
  You must then create or copy the board description to the proper location
 
430
 
 
431
<CODE>cp boards/algebra.xml boards/clockgame.xml</CODE>
 
432
 
 
433
  Then edit clockgame.xml with a proper description and icon.
 
434
  Set the icon file at the location given in clockgame.xml.
 
435
 
 
436
<LI>
 
437
 
 
438
In boards/menu.xml add the entry point for the new game:
 
439
 
 
440
<CODE>&#60;Data filename="clockgame.xml"/&#62;</CODE>
 
441
 
 
442
<LI>
 
443
 
 
444
make should compile everything fine.
 
445
 
 
446
<LI>
 
447
 
 
448
make install is mandatory or the icon won't be find at runtime.
 
449
 
 
450
<LI>
 
451
 
 
452
Now running gcompris should show up the new icon and you should be able
 
453
to play the game you did copy. Now it's time to code the board
 
454
in clockgame.c
 
455
 
 
456
<LI>
 
457
 
 
458
Update the po files:
 
459
 
 
460
<CODE>cd gcompris/po</CODE>
 
461
 
 
462
<CODE>edit POTFILES.in and add src/clockgame.c)</CODE>
 
463
 
 
464
<CODE>make</CODE>
 
465
 
 
466
<CODE>make update-po</CODE>
 
467
 
 
468
<LI>
 
469
 
 
470
Now you can add the translation in the po files.
 
471
      
 
472
<LI>
 
473
 
 
474
'make' and then 'make install' will compile and install your translation.
 
475
 
 
476
</OL>
 
477
 
 
478
 
 
479
 
 
480
<H1><A NAME="SEC19" HREF="gcompris.html#TOC19">GNU Free Documentation License</A></H1>
 
481
 
 
482
<P>
 
483
<A NAME="IDX14"></A>
 
484
Version 1.1, March 2000
 
485
 
 
486
 
 
487
 
 
488
<PRE>
 
489
Copyright (C) 2000 Free Software Foundation, Inc.
 
490
59 Temple Place, Suite 330, Boston, MA  02111-1307, USA
 
491
 
 
492
Everyone is permitted to copy and distribute verbatim copies
 
493
of this license document, but changing it is not allowed.
 
494
</PRE>
 
495
 
 
496
 
 
497
<OL>
 
498
<LI>
 
499
 
 
500
PREAMBLE
 
501
 
 
502
The purpose of this License is to make a manual, textbook, or other
 
503
written document <EM>free</EM> in the sense of freedom: to assure everyone
 
504
the effective freedom to copy and redistribute it, with or without
 
505
modifying it, either commercially or noncommercially.  Secondarily,
 
506
this License preserves for the author and publisher a way to get
 
507
credit for their work, while not being considered responsible for
 
508
modifications made by others.
 
509
 
 
510
This License is a kind of "copyleft", which means that derivative
 
511
works of the document must themselves be free in the same sense.  It
 
512
complements the GNU General Public License, which is a copyleft
 
513
license designed for free software.
 
514
 
 
515
We have designed this License in order to use it for manuals for free
 
516
software, because free software needs free documentation: a free
 
517
program should come with manuals providing the same freedoms that the
 
518
software does.  But this License is not limited to software manuals;
 
519
it can be used for any textual work, regardless of subject matter or
 
520
whether it is published as a printed book.  We recommend this License
 
521
principally for works whose purpose is instruction or reference.
 
522
 
 
523
<LI>
 
524
 
 
525
APPLICABILITY AND DEFINITIONS
 
526
 
 
527
This License applies to any manual or other work that contains a
 
528
notice placed by the copyright holder saying it can be distributed
 
529
under the terms of this License.  The "Document", below, refers to any
 
530
such manual or work.  Any member of the public is a licensee, and is
 
531
addressed as "you".
 
532
 
 
533
A "Modified Version" of the Document means any work containing the
 
534
Document or a portion of it, either copied verbatim, or with
 
535
modifications and/or translated into another language.
 
536
 
 
537
A "Secondary Section" is a named appendix or a front-matter section of
 
538
the Document that deals exclusively with the relationship of the
 
539
publishers or authors of the Document to the Document's overall subject
 
540
(or to related matters) and contains nothing that could fall directly
 
541
within that overall subject.  (For example, if the Document is in part a
 
542
textbook of mathematics, a Secondary Section may not explain any
 
543
mathematics.)  The relationship could be a matter of historical
 
544
connection with the subject or with related matters, or of legal,
 
545
commercial, philosophical, ethical or political position regarding
 
546
them.
 
547
 
 
548
The "Invariant Sections" are certain Secondary Sections whose titles
 
549
are designated, as being those of Invariant Sections, in the notice
 
550
that says that the Document is released under this License.
 
551
 
 
552
The "Cover Texts" are certain short passages of text that are listed,
 
553
as Front-Cover Texts or Back-Cover Texts, in the notice that says that
 
554
the Document is released under this License.
 
555
 
 
556
A "Transparent" copy of the Document means a machine-readable copy,
 
557
represented in a format whose specification is available to the
 
558
general public, whose contents can be viewed and edited directly and
 
559
straightforwardly with generic text editors or (for images composed of
 
560
pixels) generic paint programs or (for drawings) some widely available
 
561
drawing editor, and that is suitable for input to text formatters or
 
562
for automatic translation to a variety of formats suitable for input
 
563
to text formatters.  A copy made in an otherwise Transparent file
 
564
format whose markup has been designed to thwart or discourage
 
565
subsequent modification by readers is not Transparent.  A copy that is
 
566
not "Transparent" is called "Opaque".
 
567
 
 
568
Examples of suitable formats for Transparent copies include plain
 
569
ASCII without markup, Texinfo input format, LaTeX input format,
 
570
@acronym{SGML} or @acronym{XML} using a publicly available
 
571
@acronym{DTD}, and standard-conforming simple @acronym{HTML} designed
 
572
for human modification.  Opaque formats include PostScript,
 
573
@acronym{PDF}, proprietary formats that can be read and edited only by
 
574
proprietary word processors, @acronym{SGML} or @acronym{XML} for which
 
575
the @acronym{DTD} and/or processing tools are not generally available,
 
576
and the machine-generated @acronym{HTML} produced by some word
 
577
processors for output purposes only.
 
578
 
 
579
The "Title Page" means, for a printed book, the title page itself,
 
580
plus such following pages as are needed to hold, legibly, the material
 
581
this License requires to appear in the title page.  For works in
 
582
formats which do not have any title page as such, "Title Page" means
 
583
the text near the most prominent appearance of the work's title,
 
584
preceding the beginning of the body of the text.
 
585
 
 
586
<LI>
 
587
 
 
588
VERBATIM COPYING
 
589
 
 
590
You may copy and distribute the Document in any medium, either
 
591
commercially or noncommercially, provided that this License, the
 
592
copyright notices, and the license notice saying this License applies
 
593
to the Document are reproduced in all copies, and that you add no other
 
594
conditions whatsoever to those of this License.  You may not use
 
595
technical measures to obstruct or control the reading or further
 
596
copying of the copies you make or distribute.  However, you may accept
 
597
compensation in exchange for copies.  If you distribute a large enough
 
598
number of copies you must also follow the conditions in section 3.
 
599
 
 
600
You may also lend copies, under the same conditions stated above, and
 
601
you may publicly display copies.
 
602
 
 
603
<LI>
 
604
 
 
605
COPYING IN QUANTITY
 
606
 
 
607
If you publish printed copies of the Document numbering more than 100,
 
608
and the Document's license notice requires Cover Texts, you must enclose
 
609
the copies in covers that carry, clearly and legibly, all these Cover
 
610
Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
 
611
the back cover.  Both covers must also clearly and legibly identify
 
612
you as the publisher of these copies.  The front cover must present
 
613
the full title with all words of the title equally prominent and
 
614
visible.  You may add other material on the covers in addition.
 
615
Copying with changes limited to the covers, as long as they preserve
 
616
the title of the Document and satisfy these conditions, can be treated
 
617
as verbatim copying in other respects.
 
618
 
 
619
If the required texts for either cover are too voluminous to fit
 
620
legibly, you should put the first ones listed (as many as fit
 
621
reasonably) on the actual cover, and continue the rest onto adjacent
 
622
pages.
 
623
 
 
624
If you publish or distribute Opaque copies of the Document numbering
 
625
more than 100, you must either include a machine-readable Transparent
 
626
copy along with each Opaque copy, or state in or with each Opaque copy
 
627
a publicly-accessible computer-network location containing a complete
 
628
Transparent copy of the Document, free of added material, which the
 
629
general network-using public has access to download anonymously at no
 
630
charge using public-standard network protocols.  If you use the latter
 
631
option, you must take reasonably prudent steps, when you begin
 
632
distribution of Opaque copies in quantity, to ensure that this
 
633
Transparent copy will remain thus accessible at the stated location
 
634
until at least one year after the last time you distribute an Opaque
 
635
copy (directly or through your agents or retailers) of that edition to
 
636
the public.
 
637
 
 
638
It is requested, but not required, that you contact the authors of the
 
639
Document well before redistributing any large number of copies, to give
 
640
them a chance to provide you with an updated version of the Document.
 
641
 
 
642
<LI>
 
643
 
 
644
MODIFICATIONS
 
645
 
 
646
You may copy and distribute a Modified Version of the Document under
 
647
the conditions of sections 2 and 3 above, provided that you release
 
648
the Modified Version under precisely this License, with the Modified
 
649
Version filling the role of the Document, thus licensing distribution
 
650
and modification of the Modified Version to whoever possesses a copy
 
651
of it.  In addition, you must do these things in the Modified Version:
 
652
 
 
653
 
 
654
<OL>
 
655
<LI>
 
656
 
 
657
Use in the Title Page (and on the covers, if any) a title distinct
 
658
from that of the Document, and from those of previous versions
 
659
(which should, if there were any, be listed in the History section
 
660
of the Document).  You may use the same title as a previous version
 
661
if the original publisher of that version gives permission.
 
662
 
 
663
<LI>
 
664
 
 
665
List on the Title Page, as authors, one or more persons or entities
 
666
responsible for authorship of the modifications in the Modified
 
667
Version, together with at least five of the principal authors of the
 
668
Document (all of its principal authors, if it has less than five).
 
669
 
 
670
<LI>
 
671
 
 
672
State on the Title page the name of the publisher of the
 
673
Modified Version, as the publisher.
 
674
 
 
675
<LI>
 
676
 
 
677
Preserve all the copyright notices of the Document.
 
678
 
 
679
<LI>
 
680
 
 
681
Add an appropriate copyright notice for your modifications
 
682
adjacent to the other copyright notices.
 
683
 
 
684
<LI>
 
685
 
 
686
Include, immediately after the copyright notices, a license notice
 
687
giving the public permission to use the Modified Version under the
 
688
terms of this License, in the form shown in the Addendum below.
 
689
 
 
690
<LI>
 
691
 
 
692
Preserve in that license notice the full lists of Invariant Sections
 
693
and required Cover Texts given in the Document's license notice.
 
694
 
 
695
<LI>
 
696
 
 
697
Include an unaltered copy of this License.
 
698
 
 
699
<LI>
 
700
 
 
701
Preserve the section entitled "History", and its title, and add to
 
702
it an item stating at least the title, year, new authors, and
 
703
publisher of the Modified Version as given on the Title Page.  If
 
704
there is no section entitled "History" in the Document, create one
 
705
stating the title, year, authors, and publisher of the Document as
 
706
given on its Title Page, then add an item describing the Modified
 
707
Version as stated in the previous sentence.
 
708
 
 
709
<LI>
 
710
 
 
711
Preserve the network location, if any, given in the Document for
 
712
public access to a Transparent copy of the Document, and likewise
 
713
the network locations given in the Document for previous versions
 
714
it was based on.  These may be placed in the "History" section.
 
715
You may omit a network location for a work that was published at
 
716
least four years before the Document itself, or if the original
 
717
publisher of the version it refers to gives permission.
 
718
 
 
719
<LI>
 
720
 
 
721
In any section entitled "Acknowledgments" or "Dedications",
 
722
preserve the section's title, and preserve in the section all the
 
723
substance and tone of each of the contributor acknowledgments
 
724
and/or dedications given therein.
 
725
 
 
726
<LI>
 
727
 
 
728
Preserve all the Invariant Sections of the Document,
 
729
unaltered in their text and in their titles.  Section numbers
 
730
or the equivalent are not considered part of the section titles.
 
731
 
 
732
<LI>
 
733
 
 
734
Delete any section entitled "Endorsements".  Such a section
 
735
may not be included in the Modified Version.
 
736
 
 
737
<LI>
 
738
 
 
739
Do not retitle any existing section as "Endorsements"
 
740
or to conflict in title with any Invariant Section.
 
741
</OL>
 
742
 
 
743
If the Modified Version includes new front-matter sections or
 
744
appendices that qualify as Secondary Sections and contain no material
 
745
copied from the Document, you may at your option designate some or all
 
746
of these sections as invariant.  To do this, add their titles to the
 
747
list of Invariant Sections in the Modified Version's license notice.
 
748
These titles must be distinct from any other section titles.
 
749
 
 
750
You may add a section entitled "Endorsements", provided it contains
 
751
nothing but endorsements of your Modified Version by various
 
752
parties--for example, statements of peer review or that the text has
 
753
been approved by an organization as the authoritative definition of a
 
754
standard.
 
755
 
 
756
You may add a passage of up to five words as a Front-Cover Text, and a
 
757
passage of up to 25 words as a Back-Cover Text, to the end of the list
 
758
of Cover Texts in the Modified Version.  Only one passage of
 
759
Front-Cover Text and one of Back-Cover Text may be added by (or
 
760
through arrangements made by) any one entity.  If the Document already
 
761
includes a cover text for the same cover, previously added by you or
 
762
by arrangement made by the same entity you are acting on behalf of,
 
763
you may not add another; but you may replace the old one, on explicit
 
764
permission from the previous publisher that added the old one.
 
765
 
 
766
The author(s) and publisher(s) of the Document do not by this License
 
767
give permission to use their names for publicity for or to assert or
 
768
imply endorsement of any Modified Version.
 
769
 
 
770
<LI>
 
771
 
 
772
COMBINING DOCUMENTS
 
773
 
 
774
You may combine the Document with other documents released under this
 
775
License, under the terms defined in section 4 above for modified
 
776
versions, provided that you include in the combination all of the
 
777
Invariant Sections of all of the original documents, unmodified, and
 
778
list them all as Invariant Sections of your combined work in its
 
779
license notice.
 
780
 
 
781
The combined work need only contain one copy of this License, and
 
782
multiple identical Invariant Sections may be replaced with a single
 
783
copy.  If there are multiple Invariant Sections with the same name but
 
784
different contents, make the title of each such section unique by
 
785
adding at the end of it, in parentheses, the name of the original
 
786
author or publisher of that section if known, or else a unique number.
 
787
Make the same adjustment to the section titles in the list of
 
788
Invariant Sections in the license notice of the combined work.
 
789
 
 
790
In the combination, you must combine any sections entitled "History"
 
791
in the various original documents, forming one section entitled
 
792
"History"; likewise combine any sections entitled "Acknowledgments",
 
793
and any sections entitled "Dedications".  You must delete all sections
 
794
entitled "Endorsements."
 
795
 
 
796
<LI>
 
797
 
 
798
COLLECTIONS OF DOCUMENTS
 
799
 
 
800
You may make a collection consisting of the Document and other documents
 
801
released under this License, and replace the individual copies of this
 
802
License in the various documents with a single copy that is included in
 
803
the collection, provided that you follow the rules of this License for
 
804
verbatim copying of each of the documents in all other respects.
 
805
 
 
806
You may extract a single document from such a collection, and distribute
 
807
it individually under this License, provided you insert a copy of this
 
808
License into the extracted document, and follow this License in all
 
809
other respects regarding verbatim copying of that document.
 
810
 
 
811
<LI>
 
812
 
 
813
AGGREGATION WITH INDEPENDENT WORKS
 
814
 
 
815
A compilation of the Document or its derivatives with other separate
 
816
and independent documents or works, in or on a volume of a storage or
 
817
distribution medium, does not as a whole count as a Modified Version
 
818
of the Document, provided no compilation copyright is claimed for the
 
819
compilation.  Such a compilation is called an "aggregate", and this
 
820
License does not apply to the other self-contained works thus compiled
 
821
with the Document, on account of their being thus compiled, if they
 
822
are not themselves derivative works of the Document.
 
823
 
 
824
If the Cover Text requirement of section 3 is applicable to these
 
825
copies of the Document, then if the Document is less than one quarter
 
826
of the entire aggregate, the Document's Cover Texts may be placed on
 
827
covers that surround only the Document within the aggregate.
 
828
Otherwise they must appear on covers around the whole aggregate.
 
829
 
 
830
<LI>
 
831
 
 
832
TRANSLATION
 
833
 
 
834
Translation is considered a kind of modification, so you may
 
835
distribute translations of the Document under the terms of section 4.
 
836
Replacing Invariant Sections with translations requires special
 
837
permission from their copyright holders, but you may include
 
838
translations of some or all Invariant Sections in addition to the
 
839
original versions of these Invariant Sections.  You may include a
 
840
translation of this License provided that you also include the
 
841
original English version of this License.  In case of a disagreement
 
842
between the translation and the original English version of this
 
843
License, the original English version will prevail.
 
844
 
 
845
<LI>
 
846
 
 
847
TERMINATION
 
848
 
 
849
You may not copy, modify, sublicense, or distribute the Document except
 
850
as expressly provided for under this License.  Any other attempt to
 
851
copy, modify, sublicense or distribute the Document is void, and will
 
852
automatically terminate your rights under this License.  However,
 
853
parties who have received copies, or rights, from you under this
 
854
License will not have their licenses terminated so long as such
 
855
parties remain in full compliance.
 
856
 
 
857
<LI>
 
858
 
 
859
FUTURE REVISIONS OF THIS LICENSE
 
860
 
 
861
The Free Software Foundation may publish new, revised versions
 
862
of the GNU Free Documentation License from time to time.  Such new
 
863
versions will be similar in spirit to the present version, but may
 
864
differ in detail to address new problems or concerns.  See
 
865
<A HREF="http://www.gnu.org/copyleft/">http://www.gnu.org/copyleft/</A>.
 
866
 
 
867
Each version of the License is given a distinguishing version number.
 
868
If the Document specifies that a particular numbered version of this
 
869
License "or any later version" applies to it, you have the option of
 
870
following the terms and conditions either of that specified version or
 
871
of any later version that has been published (not as a draft) by the
 
872
Free Software Foundation.  If the Document does not specify a version
 
873
number of this License, you may choose any version ever published (not
 
874
as a draft) by the Free Software Foundation.
 
875
</OL>
 
876
 
 
877
 
 
878
 
 
879
<H3><A NAME="SEC20" HREF="gcompris.html#TOC20">ADDENDUM: How to use this License for your documents</A></H3>
 
880
 
 
881
<P>
 
882
To use this License in a document you have written, include a copy of
 
883
the License in the document and put the following copyright and
 
884
license notices just after the title page:
 
885
 
 
886
 
 
887
 
 
888
<PRE>
 
889
  Copyright (C)  <VAR>year</VAR>  <VAR>your name</VAR>.
 
890
  Permission is granted to copy, distribute and/or modify this document
 
891
  under the terms of the GNU Free Documentation License, Version 1.1
 
892
  or any later version published by the Free Software Foundation;
 
893
  with the Invariant Sections being <VAR>list their titles</VAR>, with the
 
894
  Front-Cover Texts being <VAR>list</VAR>, and with the Back-Cover Texts being <VAR>list</VAR>.
 
895
  A copy of the license is included in the section entitled ``GNU
 
896
  Free Documentation License''.
 
897
</PRE>
 
898
 
 
899
<P>
 
900
If you have no Invariant Sections, write "with no Invariant Sections"
 
901
instead of saying which ones are invariant.  If you have no
 
902
Front-Cover Texts, write "no Front-Cover Texts" instead of
 
903
"Front-Cover Texts being <VAR>list</VAR>"; likewise for Back-Cover Texts.
 
904
 
 
905
 
 
906
<P>
 
907
If your document contains nontrivial examples of program code, we
 
908
recommend releasing these examples in parallel under your choice of
 
909
free software license, such as the GNU General Public License,
 
910
to permit their use in free software.
 
911
 
 
912
 
 
913
 
 
914
 
 
915
<H1><A NAME="SEC21" HREF="gcompris.html#TOC21">Concept Index</A></H1>
 
916
<P>
 
917
     
 
918
Jump to:
 
919
<A HREF="#cindex_a">a</A>
 
920
-
 
921
<A HREF="#cindex_c">c</A>
 
922
-
 
923
<A HREF="#cindex_e">e</A>
 
924
-
 
925
<A HREF="#cindex_f">f</A>
 
926
-
 
927
<A HREF="#cindex_g">g</A>
 
928
-
 
929
<A HREF="#cindex_i">i</A>
 
930
-
 
931
<A HREF="#cindex_o">o</A>
 
932
<P>
 
933
<H2><A NAME="cindex_a">a</A></H2>
 
934
<DIR>
 
935
<LI><A HREF="gcompris.html#IDX11">About GCompris</A>
 
936
</DIR>
 
937
<H2><A NAME="cindex_c">c</A></H2>
 
938
<DIR>
 
939
<LI><A HREF="gcompris.html#IDX13">Configuring GCompris</A>
 
940
<LI><A HREF="gcompris.html#IDX4">Control bar</A>
 
941
</DIR>
 
942
<H2><A NAME="cindex_e">e</A></H2>
 
943
<DIR>
 
944
<LI><A HREF="gcompris.html#IDX9">Exiting from GCompris</A>
 
945
</DIR>
 
946
<H2><A NAME="cindex_f">f</A></H2>
 
947
<DIR>
 
948
<LI><A HREF="gcompris.html#IDX14">FDL, GNU Free Documentation License</A>
 
949
</DIR>
 
950
<H2><A NAME="cindex_g">g</A></H2>
 
951
<DIR>
 
952
<LI><A HREF="gcompris.html#IDX3">GUI</A>
 
953
</DIR>
 
954
<H2><A NAME="cindex_i">i</A></H2>
 
955
<DIR>
 
956
<LI><A HREF="gcompris.html#IDX10">Icon About</A>
 
957
<LI><A HREF="gcompris.html#IDX12">Icon Configure</A>
 
958
<LI><A HREF="gcompris.html#IDX8">Icon End</A>
 
959
<LI><A HREF="gcompris.html#IDX5">Icon Help</A>
 
960
<LI><A HREF="gcompris.html#IDX6">Icon Level</A>
 
961
<LI><A HREF="gcompris.html#IDX7">Icon OK</A>
 
962
<LI><A HREF="gcompris.html#IDX2">Interface</A>
 
963
</DIR>
 
964
<H2><A NAME="cindex_o">o</A></H2>
 
965
<DIR>
 
966
<LI><A HREF="gcompris.html#IDX1">Objective of Gcompris</A>
 
967
</DIR>
 
968
 
 
969
 
 
970
<P><HR><P>
 
971
This document was generated on 18 April 2002 using
 
972
<A HREF="http://wwwinfo.cern.ch/dis/texi2html/">texi2html</A>&nbsp;1.56k.
 
973
</BODY>
 
974
</HTML>