<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kappname "&ksmiletris;">
 <!ENTITY % English "INCLUDE">
 <!ENTITY % addindex "IGNORE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
  %ents;
]>

<book lang="&language;">
<bookinfo>
<title>&ksmiletris; User Manual</title>
<authorgroup>
<author>
<firstname>Sandro</firstname>
<surname>Sigala</surname>
<affiliation>
<address><email>ssigala@globalnet.it</email></address>
</affiliation>
</author>
</authorgroup>

<copyright><year>1998</year><year>2000</year>
<holder>Sandro Sigala</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>01/01/1998</date>
<releaseinfo>1.00.00</releaseinfo>

<abstract>
<para>KSmiletris is a Tetris-like game written for the K Desktop Environment
using the QT and KDE libraries.</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>Tetris</keyword>
<keyword>game</keyword>
<keyword>entertainment</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>
<para>KSmiletris is a Tetris-like game written for the K Desktop Environment using the QT and KDE libraries. It has been tested under the Beta 4 release of KDE and should be considered stable. </para>
<para>I release it under an open source code license. If you like this program, send me a postcard from your hometown :-).</para>
<para><programlisting>Sandro Sigala
Viale De Gasperi, 8
25041 Darfo Boario Terme
Brescia, Italy</programlisting>
</para>
<sect1 id="how-to-play">
<title>How to play</title>
<para>The only keys you need to use are the four arrow keys plus the space bar. The objective of the game is to control and to place the falling blocks, so that two blocks vertically have matching patterns.
This sequence and the blocks behind are then removed, and the above blocks will fall down. </para>

      <screenshot>
	<screeninfo>KSmiletris</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="ksmiletris.png" format="PNG">
	  </imageobject>
	  <textobject>
	    <phrase>KSmiletris</phrase>
	  </textobject>
	</mediaobject>
      </screenshot>

</sect1>
</chapter>

<chapter id="developement">
<title>Developement</title>
<sect1 id="where-to-find-the-sources">
<title>Where to find the sources</title>
<para>The main FTP site is <ulink url="ftp://ftp.vix.com/guests/ssigala/pub/">ftp.vix.com</ulink>, where you can find the latest sources of this program plus
the sources of other programs written by me. The other available FTP site is KDE
main site <ulink url="ftp://ftp.kde.org/pub/kde/">ftp.kde.org</ulink>, or any
other mirror.</para>
</sect1>
<sect1 id="changes">
<title>Changes</title>
<sect2>
<title>Changes from version 0.4 to version 1.0</title>
<para><itemizedlist>
<listitem>
<para>Fixed a Makefile bug, that prevented the icons from being distribuited in
the package.</para>
</listitem>
<listitem>
<para>Added sounds (the KDE interface is inadequate, though).</para>
</listitem>
<listitem>
<para>Added the High Score board. </para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2>
<title>Changes from version 0.3 to version 0.4</title>
<para><itemizedlist>
<listitem>
<para>Updated the configure files synchronizing with the kexample example of KDE
SDK package.</para>
</listitem>
<listitem>
<para>As a consequence of the above change, the source files are renamed from
.cc to .cpp. </para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2>
<title>Changes from version 0.2 to version 0.3</title>
<para><itemizedlist>
<listitem>
<para>Added a more nice breaking and deleting graphic sequence. </para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2>
<title>Changes from version 0.1 to version 0.2</title>
<para><itemizedlist>
<listitem>
<para>The  GameWidget() destructor was defined but not declared. This (correcly)
generates an error if compiled with EGCS.</para>
</listitem>
<listitem>
<para>Added automatic save and load of user options. </para>
</listitem>
</itemizedlist>
</para>
</sect2>
</sect1>
<sect1 id="to-do">
<title>To Do</title>
<para><itemizedlist>
<listitem>
<para>The KDE audio interface is inadequate for complex sound applications like
games. Need to find a best method for playing sounds.</para>
</listitem>
<listitem>
<para>Make the High Score board global, not local (this requires making the
score data globally writable).</para>
</listitem>
<listitem>
<para>Add keys redefinition support.</para>
</listitem>
<listitem>
<para>Comment the source code with kdoc. </para>
</listitem>
<listitem>
<para>Rewrite this documentation with the KDE SGML tools.</para>
</listitem>
<listitem>
<para>Internationalization. </para>
</listitem>
<listitem>
<para></para>
</listitem>
<listitem>
<para></para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>
<chapter id="Epilogue">
<title>Epilogue</title>
<sect1 id="author">
<title>Author</title>
<para><literal remap="tt">Sandro Sigala, <ulink url="mailto:ssigala@globalnet.it">mailto:ssigala@globalnet.it</ulink></literal></para>
</sect1>
<sect1 id="credits">
<title>Credits</title>
<para><literal remap="tt">Christian Tibirna <ulink url="mailto:ctibirna@gch.ulaval.ca">ctibirna@gch.ulaval.ca</ulink> for the &tilde;GameWidget() destructor inconsistency
bug.</literal></para>
<para><literal remap="tt">Christoph Gottfried Berndl, <ulink url="mailto:winniepu@diddl.tuwien.ac.at">winniepu@diddl.tuwien.ac.at</ulink></literal></para>
<para><literal remap="tt">Christopher Menzel, <ulink url="mailto:cmenzel@tamu.edu">cmenzel@tamu.edu</ulink></literal></para>
</sect1>
<sect1 id="license">
<title>License</title>
<para>Copyright &copy; 1998 Sandro Sigala, <ulink
url="mailto:ssigala@globalnet.it">ssigala@globalnet.it</ulink></para>

&underFDL;

<para>All rights reserved.</para>

<para>Permission to use, copy, modify, and distribute this software
and its documentation for any purpose and without fee is hereby
granted, provided that the above copyright notice appear in all
copies and that both that the copyright notice and this
permission notice and warranty disclaimer appear in supporting
documentation, and that the name of the author not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission.</para>
<para>The author disclaim all warranties with regard to this
software, including all implied warranties of merchantability
and fitness.  In no event shall the author be liable for any
special, indirect or consequential damages or any damages
whatsoever resulting from loss of use, data or profits, whether
in an action of contract, negligence or other tortious action,
arising out of or in connection with the use or performance of
this software.</para>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
