<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "2.0">
  <!ENTITY manrevision "2.0">
  <!ENTITY date "March 2002">
  <!ENTITY app "<application>Gnome xBill</application>">
  <!ENTITY appname "Gnome xBill">
  <!ENTITY version "2.0">
 ]
>

<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 12, 2002
-->
 <!-- =============Document Header ============================= -->
 <article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
   <articleinfo>
     <title>&app; Manual V&manrevision;</title>
     <copyright>
       <year>2000</year>
       <holder>Michael Koziarski</holder>
     </copyright>
<!-- translators: uncomment this:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
<!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
    <publisher> 
      <publishername> GNOME Documentation Project </publishername> 
    </publisher> 

   &legal;
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
	any of this. -->

    <authorgroup> 
      <author> 
	<firstname>Michael</firstname> 
	<surname>Koziarski</surname> 
	<affiliation> 
	  <address> <email>michael@koziarski.com</email> </address> 
	</affiliation> 
      </author> 
<!-- This is appropriate place for other contributors: translators,
      maintainers,  etc. Commented out by default.
       <othercredit role="translator">
	<firstname>Latin</firstname> 
	<surname>Translator 1</surname> 
	<affiliation> 
	  <orgname>Latin Translation Team</orgname> 
	  <address> <email>translator@gnome.org</email> </address> 
	</affiliation>
	<contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>

    <revhistory>
      <revision> 
	<revnumber>&appname; Manual V&manrevision;</revnumber> 
	<date>&date;</date> 
	<revdescription> 
	  <para role="author">Michael Koziarski
	    <email>michael@koziarski.com</email>
	  </para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo>This manual describes version &appversion; of &appname;.
    </releaseinfo>
    <!-- The following feedback information only applies to appliactions
    listed in bugzilla.gnome.org and bugzilla.ximian.com. For other
    applications, please provide your own feedback info or remove thsi
    section altogether -->
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the &app; application or
	this manual, follow the directions in the 
	<ulink url="ghelp:gnome-feedback"
	  type="help">GNOME Feedback Page</ulink>. 
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice>
   </articleinfo>

  <indexterm zone="index"> 
    <primary>Gnome xBill</primary> 
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
  <sect1 id="intro"> <title>Introduction</title>
    <para>Gnome xBill is a port of the original xBill to the GNOME desktop
    environment.
    </para>
    <sect2 id="origstory">
      <title>The Story of xBill</title>
      <note>
	<title>Source:</title>
	<para> This section appeared in the original xBill.
	</para>
      </note> 
      <para>
	Yet again, the fate of the world rests in your hands! An evil computer
	hacker, known only by his handle <quote>Bill</quote>, has created the ultimate
	computer virus.  A virus so powerful that it has the power to transmute
	an ordinary computer into a toaster oven.  (oooh!) <quote>Bill</quote>
	has cloned 
	himself into a billion-jillion micro-Bills. Their sole purpose is to 
	deliver the nefarious virus, which has been cleverly disguised as a
	popular operating system. 
      </para>
      
      <para>
	As System Administrator/Exterminator, your job is to keep Bill from
	succeeding at his task. 
      </para>
    </sect2>
    <sect2 id="overview">
      <title>Overview</title>
      <para>
	<application>Gnome xBill </application> is included in the
	<filename>GNOME-games </filename> package, which is part of the
	GNOME desktop environment. This document describes version
	&version; of <application>Gnome xBill</application>.
      </para>
      <para>Simply stated, your mission in Gnome xBill is to maintain the
	stability of your computer systems. To do this you must splat the
	<link linkend="microbill">micro-Bills</link>; restore any removed
	<link linkend="fallenos">operating systems </link>; and dowse any
	sparks being sent from <link linkend="infected">infected computers</link>.
      </para>
    </sect2>
  </sect1>
  <sect1 id="images">
    <title>Entities you will see in Gnome xBill</title>
    <para>Playing Gnome xBill requires interacting with a number of different
    items, in this section you will be introduced to each of them. </para>
    <para>The overall goal is to maintain the stability of your computer system,
    therefore it makes sense that the first entity you are introduced is a
    computer. <xref linkend="computer"/> shows one of the computers you will
    start the game with, this computer has RedHat Linux installed on it but the
    computers you start the game with may have any other unix based
    operating system installed.</para>
    <figure id="computer">
      <title>Computer</title>
      <screenshot>
	 <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/computer.png" format="PNG" srccredit="Michael Koziarski"/>
	</imageobject>
    <textobject> 
      <phrase>Computer.</phrase> 
    </textobject> 
  </mediaobject>
      </screenshot>
    </figure>
    <para>Some of the computers in your system will be connected by a black
    cable (see <xref linkend="cable"/>), these computers are considered
    networked.  Computers on a network are susceptible to a spark attack from an
    infected computer, this is explained in greater detail in <xref
    linkend="attacks"/>.</para>
    <figure id="cable">
      <title>Network Cable</title>
      <screenshot>
	 <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/cable.png" format="PNG" srccredit="Michael Koziarski"/>
	</imageobject>
    <textobject> 
      <phrase>Network Cable.</phrase> 
    </textobject> 
  </mediaobject>
      </screenshot>
    </figure>
    <para><xref linkend="microbill"/> shows your enemies in
    <application>Gnome-xBill</application>. The swarming micro-Bills.  <xref
    linkend="attacks"/> describes the various tactics they'll use against your
    network.  In the event that a computer is infected and it sends a network
    spark (see <xref linkend="attacks"/>) you'll need to use the bucket of <xref
    linkend="bucket"/>
    </para>
    <figure id="microbill">
      <title>micro-Bill</title>
      <screenshot>
	 <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/microbill.png" format="PNG" srccredit="Michael Koziarski"/>
	</imageobject>
    <textobject> 
      <phrase>micro-Bill.</phrase> 
    </textobject> 
  </mediaobject>
      </screenshot>
    </figure>
    <figure id="bucket">
      <title>Bucket</title>
      <screenshot>
	 <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/bucket.png" format="PNG" srccredit="Michael Koziarski"/>
	</imageobject>
    <textobject> 
      <phrase>Bucket.</phrase> 
    </textobject> 
  </mediaobject>
	</screenshot>
    </figure>
  </sect1>
  <sect1 id="usage">
    <title>How to Play</title>
    <para>
      To run <application>Gnome xBill</application>, select
      <menuchoice>
	<guisubmenu>Games</guisubmenu>
	<guimenuitem>Gnome xBill</guimenuitem>
      </menuchoice>
      from the 
      <guimenu>Main Menu</guimenu>, or type
      <command>gnome-xbill</command> on the command line.
      When <application>Gnome xBill</application> starts you will be presented
      with the main window shown in  <xref linkend="mainwindow-fig"/>.
    </para>
    <figure id="mainwindow-fig">
      <title>Gnome xBill Main Window</title>
      <screenshot>
	 <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/mainwin.png" format="PNG" srccredit="Michael Koziarski"/>
	</imageobject>
    <textobject> 
      <phrase>Gnome xBill Main Window.</phrase> 
    </textobject> 
  </mediaobject>
      </screenshot>
    </figure>
    <para>To start a new game of Gnome xBill select 
      <menuchoice>
	<shortcut>
	  <keycombo>
	    <keycap>Ctrl</keycap>
	    <keycap>n</keycap>
	  </keycombo>
	</shortcut> 
	<guimenu>Game</guimenu>
	<guimenuitem>New game </guimenuitem> 
      </menuchoice>
    . If you wish to start from higher level choose
      <menuchoice>
	<guimenu>Game</guimenu>
	<guimenuitem>Warp to level</guimenuitem> 
      </menuchoice>
    </para>
    <para>When the new game begins you'll be presented with a screen like <xref
    linkend="start-game"/>.This screen contains a number of computers each with an
      operating system installed on it. </para>
    <para> The text in the left hand bottom corner of the screen is explained in
    <xref linkend="scoring"/>After a short
      period of time <link linkend="microbill"> micro-Bills </link> will begin
    to attack your network. 
      <figure id="start-game">
	<title>Start of Gnome xBill</title>
	<screenshot>
	   <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/startgame.png" format="PNG" srccredit="Michael Koziarski"/>
	 </imageobject>
    <textobject> 
      <phrase>Start of Gnome xBill.</phrase> 
    </textobject> 
  </mediaobject>
	</screenshot>
      </figure>
    </para>
    <sect2 id="attacks">
      <title> Types of attacks </title>
      <para>When a micro-Bill arrives at one of your computers it will begin to
	uninstall the operating system as shown in <xref linkend="uninstall"/>
	After removing your operating system the micro-Bill will install the
	'virus' on the pc.  An infected computer will have the logo of a certain
      ubiquitous legacy operating system displayed on its screen. An infected
      computer is shown in 
	<xref linkend="infected"/>.
	<figure id="uninstall">
	  <title>Micro-Bill removing OS</title>
	  <screenshot>
	     <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/remove.png" format="PNG" srccredit="Michael Koziarski"/>
	   </imageobject>
    <textobject> 
      <phrase>Micro-Bill removing OS.</phrase> 
    </textobject> 
  </mediaobject>
	  </screenshot>
	</figure>
	<figure id="infected">
	  <title>Infected computer</title>
	  <screenshot>
	     <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/infected.png" format="PNG" srccredit="Michael Koziarski"/>
	   </imageobject>
    <textobject> 
      <phrase>Infected Computer.</phrase> 
    </textobject> 
  </mediaobject>
	  </screenshot>
	</figure>
      </para>
      <para>With the virus installed the micro-Bill will carry your previous OS
      off the screen. A micro-Bill carrying your operating system will look like
      <xref linkend="removeos"/> you should try to <link linkend="splat"> splat
      </link> the micro-Bill before he manages to carry the OS off screen.
	<figure id="removeos">
	  <title>micro-Bill removing OS</title>
	  <screenshot>
	    <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/removeos.png" format="PNG" srccredit="Michael Koziarski"/>
	   </imageobject>
    <textobject> 
      <phrase>micro-Bill removing OS.</phrase> 
    </textobject> 
  </mediaobject>
	  </screenshot>
	</figure>
      </para>
      <para> Once a networked computer has become infected it will periodically
      send sparks along it's network cable, once a spark arrives at it's
      destination the computer will instantly become infected. You can see a
      network spark travelling towards the HURD computer in <xref
      linkend="spark"/>
    <figure id="spark">
      <title>Network Spark</title>
      <screenshot>
	 <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/spark.png" format="PNG" srccredit="Michael Koziarski"/>
	</imageobject>
    <textobject> 
      <phrase>Network Spark.</phrase> 
    </textobject> 
  </mediaobject>
      </screenshot>
    </figure>
    </para>
    </sect2>
    <sect2 id="prevention">
      <title> Methods of attack prevention </title>
      <para>As the game progresses micro-Bills 
	will begin to attack your network. In order to stop their
	assault you need to splat them. To splat a micro-Bill move the hand over
	them and click the first mouse button. If you hit the micro-Bill it will
	explode as in. 
	<figure id="splat">
	  <title>Splatted micro-Bill</title>
	  <screenshot>
	     <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/splat.png" format="PNG" srccredit="Michael Koziarski"/>
	   </imageobject>
    <textobject> 
      <phrase>Splatted micro-Bill.</phrase> 
    </textobject> 
  </mediaobject>
	  </screenshot>
	</figure>
      </para>
      <para>After a micro-Bill has removed your OS he will begin to take it off
      screen. If you splat it the OS will fall onto the ground. 
	<figure id="fallenos">
	  <title>Removed OS on the ground</title>
	  <screenshot>
	     <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/fallenos.png" format="PNG" srccredit="Michael Koziarski"/>
	   </imageobject>
    <textobject> 
      <phrase>Removed OS on the ground.</phrase> 
    </textobject> 
  </mediaobject>
	  </screenshot>
	</figure> You are then able to restore your OS by moving the mouse over
	the OS, pressing down the first mouse button and then dragging the OS to
	its computer. 
      </para>
      <note>
	<title>NOTE</title>
	<para> You can only restore operating systems to their original computer.
	</para>
	</note> 
      <para>As <link linkend="spark">noted earlier</link> an infected computer
	will periodically send
	sparks along any network cables attached to it. To dowse these sparks you
	need to move the hand over the bucket, then press and hold the first mouse
	button. You can now drag the bucket over the spark and release the first
	mouse button to dowse it.
      </para>
    </sect2>
    <sect2 id="gameend">
      <title>Ending your game</title>
      <para>Once all the computers in your system have had the virus installed
      your game is over. You will be presented with the dialog box shown in
      <xref linkend="fakeseg"/>
      </para>
      <note>
	<title>NOTE</title>
	<para> This is not a real application fault.  There's no need to submit
	it to the bug tracking system.
	</para>
      </note> 

    <figure id="fakeseg">
      <title>Gameover Dialog</title>
      <screenshot>
	 <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/fakeseg.png" format="PNG" srccredit="Michael Koziarski"/>
	</imageobject>
    <textobject> 
      <phrase>Gameover Dialog.</phrase> 
    </textobject> 
  </mediaobject>
      </screenshot>
    </figure>
    <para>When your game is over your computers will all have become toasters
    (<xref linkend="toastfig"/>).  If your score was high enough you'll enter
    the <link linkend="scoring">highscore table.</link></para>
    <figure id="toastfig">
      <title>The remains of your system</title>
      <screenshot>
	 <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/toasters.png" format="PNG" srccredit="Michael Koziarski"/>
	</imageobject>
    <textobject> 
      <phrase>The remains of your system.</phrase> 
    </textobject> 
  </mediaobject>
      </screenshot>
    </figure>

    </sect2>
    <sect2 id="scoring">
      <title>Gnome xBill Scoring system</title>
      <para>Your score in <application>Gnome-xBill</application> is based on
      total uptime and the number of micro-Bills you kill. <xref
      linkend="scoreboard"/> shows the scoreboard.</para> 
      <figure id="scoreboard">
	<title>The Scoreboard</title>
	<screenshot>
	   <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/score.png" format="PNG" srccredit="Michael Koziarski"/>
	  </imageobject>
    <textobject> 
      <phrase>The Scoreboard.</phrase> 
    </textobject> 
  </mediaobject>
	</screenshot>
      </figure>
      <para>The scoreboard consists 4 blocks of text.  The last two blocks are
      self explanatory.  The first block is your
      micro-Bill status and is given by a ratio.  The numerator of the ratio is
      the number of micro-Bills currently on screen and the denominator gives
      the number of micro-Bills off screen. </para>
      <para>The second block of text is your network status indicator. The three
      values (from left to right) are:</para>
      <itemizedlist>
	<listitem>
	  <para>
	    Functioning computers, those computers which are still running
	    their original (UNIX based) operating system
	  </para>
	</listitem>
	<listitem>
	  <para>
	    Uninstalled computers, those computers whose UNIX based operating
	    system has been removed and are currently lacking any operating system.
	  </para>
	</listitem>
	<listitem>
	  <para>
	    Infected computers, those computers who have the virus instead of
	    their original operating system.
	  </para>
	</listitem>
      </itemizedlist> 
      <para>Each micro-Bill splatted gives you 5 points. The remainder of your
      score is a function of total uptime.  To maximise your uptime try to stop
      all the micro-Bills before they attempt to uninstall your operating
      systems.
      </para>
      <para>If your score is high enough then when the game is over you will be
      entered in the Highscores (<xref linkend="highscoreboard"/>), to check
      the current high scores chose
	<menuchoice>
	  <guimenu>Game</guimenu>
	  <guimenuitem>Scores</guimenuitem> 
	</menuchoice>
      </para>
      <figure id="highscoreboard">
	<title>The High Scoreboard</title>
	<screenshot>
	   <mediaobject> 
    <imageobject>
  <imagedata fileref="figures/scores.png" format="PNG" srccredit="Michael Koziarski"/>
	  </imageobject>
    <textobject> 
      <phrase>The High Scoreboard.</phrase> 
    </textobject> 
  </mediaobject>
	</screenshot>
      </figure>
    </sect2>
    <sect2 id="help">
      <title> Accessing Help </title>
      <para>To access help for <application>Gnome xBill</application> select 
	<menuchoice>
	  <guimenu>Help</guimenu>
	  <guimenuitem>Manual</guimenuitem>
	</menuchoice>
	<!--finish -->
      </para>
    </sect2>
  </sect1>




<!-- ============= Authors ================================ -->

  <sect1 id="authors">
    <title>Authors</title>
    <para>
      <application>Gnome xBill</application> was written by James Henstridge
      (<email>james@daa.com.au</email>).  Please send all comments, suggestions, and bug
      reports to the <ulink url="http://bugs.gnome.org" type="http">GNOME
      bug tracking database</ulink>. (Instructions for submitting bug
      reports can be found <ulink url="http://bugs.gnome.org/Reporting.html" type="http">
      on-line</ulink>.)  You can also use <application>Bug Report
      Tool</application>
      (<command>bug-buddy</command>), available in the
    <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
    Menu</guimenu>, for submitting bug reports.
   </para>

    <para>
      This manual was written by Michael Koziarski
      (<email>michael@koziarski.com</email>). Please send all comments and
      suggestions regarding this manual to the <ulink type="http"
      url="http://developer.gnome.org/projects/gdp">GNOME Documentation 
      Project</ulink> by sending an email to 
      <email>docs@gnome.org</email>. You can also add your comments online 
      by using the <ulink type="http" 
      url="http://www.gnome.org/gdp/doctable/">GNOME Documentation Status
      Table</ulink>.
    </para>
  </sect1>


  <!-- ============= Application License ============================= -->

  <sect1 id="license">
   <title>License</title>
   <para>
    This program is free software; you can redistribute it and/or
    modify it under the terms of the <citetitle>GNU General Public
    License</citetitle> as published by the Free Software Foundation;
    either version 2 of the License, or (at your option) any later
    version.
   </para>
   <para>
    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    <citetitle>GNU General Public License</citetitle> for more details.
   </para>
   <para>
    A copy of the <citetitle>GNU General Public License</citetitle> is
    included as an appendix to the <citetitle>GNOME Users
    Guide</citetitle>.  You may also obtain a copy of the
    <citetitle>GNU General Public License</citetitle> from the Free
    Software Foundation by visiting <ulink type="http"
    url="http://www.fsf.org">their Web site</ulink> or by writing to
    <address>
     Free Software Foundation, Inc.
     <street>59 Temple Place</street> - Suite 330
     <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
     <country>USA</country>
    </address>
   </para>
  </sect1>
</article>




