From c90c389a8a8d9d8661e9772ec4144c5cf2039f23 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegames@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/kbattleship/Makefile.am | 3 + doc/kbattleship/index.docbook | 485 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 488 insertions(+) create mode 100644 doc/kbattleship/Makefile.am create mode 100644 doc/kbattleship/index.docbook (limited to 'doc/kbattleship') diff --git a/doc/kbattleship/Makefile.am b/doc/kbattleship/Makefile.am new file mode 100644 index 00000000..41691557 --- /dev/null +++ b/doc/kbattleship/Makefile.am @@ -0,0 +1,3 @@ +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kbattleship/index.docbook b/doc/kbattleship/index.docbook new file mode 100644 index 00000000..9e380d17 --- /dev/null +++ b/doc/kbattleship/index.docbook @@ -0,0 +1,485 @@ + + + + + +]> + + + +The &kbattleship; Handbook + + + +&Daniel.Molkentin; &Daniel.Molkentin.mail; + + + +&Nikolas.Zimmermann; &Nikolas.Zimmermann.mail; + + + +&Frerich.Raabe; + +&Frerich.Raabe.mail; + + + + + + +&FDLNotice; + + +2001 +&Daniel.Molkentin; + + +2001 +&Nikolas.Zimmermann; + + +2001 +Kevin Krammer + + + +2005-12-14 +1.1 + + + +&kbattleship; is a network-enabled implementation of the famous Battle Ship game for &kde;. + + + +KDE +kdegames +kbattleship +game +battleship +battle + + + + + +Introduction + + +Features + +Network Gaming +Computer Player (AI) +Sounds +Chat +Statistics +Highscore List + + + + +&kbattleship; uses an &XML; based communication protocol so you can write +clients for every platform and in any language. If you want to write +one in your favorite programming language or/and environment, contact +us. We would really like to hear of it. + + + + + + + +Using &kbattleship; + + +If you want to play &kbattleship;, you will need two players, either play +against the computer or in a network against another player. + +In a network game one player has to open the game via +Game Start +Server or by pressing F3. + + + +A dialog box opens which will ask you for for a +Nick name: and Port:. Normally, +&kbattleship; will suggest your login name but you can enter any string +you want. The predefined port should be OK. However, if you encounter +problems, you can choose any other free ports above 1024. + + + +You need to tell the other player in case you use a port other than +the default as both players need to use the same port in order to be able +to establish a connection. + + + +The other player has to choose Game +Connect to Server, or press +F2. Again, a Nick name: is +suggested, but you can choose any name you like. + + + +An important point is the field Server:. Here, you +have to enter the host name of the server (the machine of the player +that initiated the game). + + + +Another possibility is to play &kbattleship; against your +computer. Select Single Player from the +Game Menu, or press F4. + + + +When you are done, you can start the game. Simply follow the +instructions in the statusbar. It will issue hints and suggest what to +do next. When you now look at the screen, you will find two grid fields, +the so-called battle areas. The left area belongs to +you. This is where you place your ships and where you can follow the +military actions of your enemy. The right area is where your enemy's +fleet is located. When it's your turn to fire, you need to click on a +certain sector (a field of the battle area) where you suppose the ships +to be located. + + + +First, you need to place your ships. The game initiator starts. When +he/she is done, player two sets his/her ships. + + + +Ship placement is very easy: Simply click on the field where you want to +place your ship. The first one will have a length of four squares, the next +will be three squares long &etc;. Click on the field where you want to start +the placement. If you click with the &LMB; the ship will be placed horizontally, +a &Shift; &LMB; click will cause it to be placed +vertically. &Shift; itself will flip the ship placement preview. + + + +Now you can blindly fire with a &LMB; click on the enemy battle area. The status bar indicates +who is about to shoot. + + + +The first player destroying all their opponents ships wins the game! + + + + + +The Menus + + +The <guimenu>Game</guimenu> menu + + + + + +F2 +Game +Connect to Server... + + + + +Initiate a connection to another player's server. + + + + + + + +F3 +Game +Start Server... + + + + +Start the server so another player can connect to you. + + + + + + + +F4 +Game +Single Player... + + + + +Start a game with your computer as the opponent. + + + + + + + +&Ctrl;H +Game +Show Highscores + + + + +Show the highest scores so far. + + + + + + + +F11 +Game +Enemy Info + + +Show the enemy's client (might also be &Mac;), the client +version, a short description and the protocol version used. + + + + + + + +&Ctrl;Q + +Game +Quit + + + + +Exit &kbattleship; + + + + + + + +The <guimenu>Settings</guimenu> menu + + + + + +Settings +Show Statusbar + + + + +Toggle on or off the display of the statusbar. The +default is on. + + + + + + + + +Settings +Show Grid + + + + +Toggle on and off the display of a grid on the playing +field. The default is off. + + + + + + + +Settings +Play Sounds + + + + +Toggle whether sounds (played when shooting) should be played. +The default is on. + + + + + + + +Settings +Configure Shortcuts... + + + + +Configure the keyboard shortcuts used by &kbattleship;. + + + + + + + +Settings +Configure Notifications... + + + + +Configure the audio and visual notifications used by &kbattleship;. + + + + + + + + + +The <guimenu>Help</guimenu> menu + +&help.menu.documentation; + + + + + +Questions, Answers, and Tips + + +Frequently asked questions + + +I get the error: Couldn't connect to &arts; +Soundserver. Sound deactivated. + + +&kbattleship; relies on &arts;, &kde;'s soundserver, to play any +sound. Enable &arts; in the &kcontrolcenter; by browsing to +Sound & Multimedia +Sound System and making sure that +the box labelled Enable the sound system is checked. + + + + + +I have a question that is likely to become a &FAQ;. Who should I +contact? + + +Contact the authors. They will most likely add it here. + + + + + + + +Credits and Licenses + +&kbattleship; Copyright 2000, 2001 + + +Authors + + +&Nikolas.Zimmermann; &Nikolas.Zimmermann.mail; + + + + +&Daniel.Molkentin; &Daniel.Molkentin.mail; + + + + +Kevin Krammer kevin.krammer@gmx.at + + + + + +Contributors + + +Benjamin Adler benadler@bigfoot.de + + + + +Nils Trzebin nils.trzebin@stud.uni-hannover.de + + + + +Elmar Hoefner elmar.hoefner@uibk.ac.at + + + + +Documentation updated for &kde; 3.4 by +BrianBeck +brian.beck@mchsi.com + + + +&underFDL; +&underGPL; + + + + +Installation + +&install.intro.documentation; + + +Requirements + + +At the time of writing, &kbattleship; requires &kde; 3.x or greater and +&Qt; 3.x or greater. + + + + + +Compiling + +&install.compile.documentation; + + + + + + + + -- cgit v1.2.1