<!DOCTYPE article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
        <!-- if not using PNG graphic, replace reference above with
             .....PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
         -->
<!ENTITY version "1.2.0"> <!-- replace with application version -->
]>


<!--
  This is a GNOME documentation template, designed by the GNOME
  Documentation Project Team. Please use it for writing GNOME
  documentation, making obvious changes. In particular, all the words
  written in UPPERCASE (with the exception of GNOME) should be
  replaced. As for "legalnotice", please leave the reference
  unchanged.

  Remember that this is a guide, rather than a perfect model to follow
  slavishly. Make your manual logical and readable.  And don't forget
  to remove these comments in your final documentation!  ;-)
-->

<!--
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 1.0.3
  Template last modified: Nov 16, 2000
-->

<!-- =============Document Header ============================= -->

<article id="index"> <!-- please do not change the id -->

  <artheader>
   <title>Same GNOME player's guide</title>
    <copyright>
      <year>2000</year>
      <holder>Miguel de Icaza</holder>
    </copyright>

  <!-- translators: uncomment this:

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

   -->

  <!-- do not put authorname in the header except in copyright - use
  section "authors" below -->

  <!-- Use this legal notice for online documents which depend on -->
  <!-- core GNOME packages.                                       -->
  <legalnotice id="legalnotice">
   <para>
    Permission is granted to copy, distribute and/or modify this document
    under the terms of the <ulink type="help"
    url="gnome-help:fdl"><citetitle>GNU Free Documentation
    License</citetitle></ulink>, Version 1.1 or any later version
    published by the Free Software Foundation with no Invariant Sections,
    no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
    can be found <ulink type="help" url="gnome-help:fdl">here</ulink>.
   </para>
   <para>
    Many of the names used by companies to distinguish their products and
    services are claimed as trademarks. Where those names appear in any
    GNOME documentation, and those trademarks are made aware to the members
    of the GNOME Documentation Project, the names have been printed in caps
    or initial caps.
   </para>
  </legalnotice>

  <!-- Use this legal notice for documents which are placed on  -->
  <!-- the web, shipped in any way other than online documents  -->
  <!-- (eg. PS, PDF, or RTF), or which do not depend on the     -->
  <!-- core GNOME distribution.                                 -->
  <!--                                                          -->
  <!-- If you use this version, you must place the following    -->
  <!-- line in the document declaration at the top of your      -->
  <!-- document:                                                -->
  <!--   <!ENTITY FDL SYSTEM "fdl.sgml">                        -->
  <!-- and the following line at the bottom of your document    -->
  <!-- after the last </sect1>.                                 -->
  <!--   &FDL;                                                  -->
  <!--
  <legalnotice id="legalnotice">
   <para>
    Permission is granted to copy, distribute and/or modify this document
    under the terms of the <link linkend="fdl"><citetitle>GNU
    Free Documentation License</citetitle></link>, Version 1.1 or any later
    version published by the Free Software Foundation with no Invariant
    Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the
    license can be found in <xref linkend="fdl">.
   </para>
   <para>
    Many of the names used by companies to distinguish their products and
    services are claimed as trademarks. Where those names appear in any
    GNOME documentation, and those trademarks are made aware to the members
    of the GNOME Documentation Project, the names have been printed in caps
    or initial caps.
   </para>
  </legalnotice>
  -->

  <!-- This is the manual version, not application version. -->
  <!--
    <releaseinfo>
       This is version 1.0 of MY-GNOME-APP manual.
    </releaseinfo>
  -->

  </artheader>

 <!-- ============= Document Body ============================= -->

  
  <sect1 id="guide">
    <title>Same GNOME player's guide</title>

    <sect2 id="objective">
      <title>Game objective</title>
      <para>The objective of the game is to get a high score by
      eliminating as many balls as possible in a single stroke.  If
      you eliminate only two balls, you will score zero points.  If
      you eliminate three balls, you will score one point. The more
      balls you eliminate in a single mouse click the higher your
      score will be.</para>

      <para>To faciliate the task of spotting the ball clusters, Same
      GNOME will animate the cluster of balls when the mouse is over
      them (this also indicates that if you click on the cluster, it
      will eliminate the balls)</para>

      <para>Eliminating all of the balls on the board will grant you
      an extra one thousand points</para>
    </sect2>

    <sect2 id="bugs">
      <title>Reporting bugs and sending patches to enhance the
      game</title>
      
      <para>You can contact the authors as
      <symbol>miguel@gnu.org</symbol> and
      <symbol>federico@nuclecu.unam.mx</symbol>.  General discussion
      about this game is carried on the
      <symbol>gnome-list@gnome.org</symbol> mailing list.</para>

    </sect2>

    <sect2 id="Authors">
      <title>Authors and history.</title>

      <para> This GNOME game was originally implemented by Miguel de
      Icaza and Federico Mena at early days of the GNOME project.  It
      was inspired by KDE's samegnome game which in turn was inspired
      by a Macintosh game of a similar name.</para>
      
      <para>A number of tiles were originated from the KDE
      project. The planets tile was rendered by Federico in his
      copious spare time to show the world his masterful control of
      povray command language.</para>

    </sect2>

  </sect1>

  <sect1 id="newthemes">
    <title>Making new themes for Same GNOME</title>
      <para>Making new animation themes for Same GNOME is very simple.
      Each tile should measure forty by forty pixels.  You need to
      provide a graphic image that contains at least 3 rows of 40
      pixels each (for the three different tile colors) and a variable
      number of frames to do your animation (this animation will be
      shown when the mouse cursor is over a cluster of tiles of the
      same color).</para>

      <para>To allow Same-GNOME to pick up your tile set you need to
      install this on the $prefix/pixmaps/same-gnome directory (where
      $prefix stands for the installation prefix used to configure the
      GNOME environment, you can find this out by running the command
      <symbol>gnome-config --prefix</symbol>).</para>

  </sect1>
</article>
