GNOME.org
 

[gnome-games/gsoc-seed-games] [lightsoff] Add (as-yet-unwritten) LO manual. Copied from Gnometris, so there's some extra words lef

commit 9e00b635e358dea50270afd94c6fccee98f557bf
Author: Tim Horton <hortont svn gnome org>
Date:   Sun Jul 5 18:08:40 2009 -0400

    [lightsoff] Add (as-yet-unwritten) LO manual. Copied from Gnometris, so there's some extra words left over.

 configure.in                    |    1 +
 lightsoff/Makefile.am           |    2 +-
 lightsoff/help/C/legal.xml      |   76 +++++++++++++
 lightsoff/help/C/lightsoff.xml  |  222 +++++++++++++++++++++++++++++++++++++++
 lightsoff/help/Makefile.am      |   12 ++
 lightsoff/help/lightsoff.omf.in |    9 ++
 6 files changed, 321 insertions(+), 1 deletions(-)
---
diff --git a/configure.in b/configure.in
index 61e7f4a..6922f06 100644
--- a/configure.in
+++ b/configure.in
@@ -1093,6 +1093,7 @@ same-gnome-clutter/same-gnome-clutter.desktop.in
 same-gnome-clutter/same-gnome-clutter-c.desktop.in
 same-gnome-clutter/light.js
 lightsoff/Makefile
+lightsoff/help/Makefile
 lightsoff/src/lightsoff
 lightsoff/lightsoff.desktop.in
 lightsoff/src/main.js
diff --git a/lightsoff/Makefile.am b/lightsoff/Makefile.am
index 03df54e..37ef86a 100644
--- a/lightsoff/Makefile.am
+++ b/lightsoff/Makefile.am
@@ -1,4 +1,4 @@
-SUBDIRS = data/themes
+SUBDIRS = data/themes help
 
 lightsoffdir = $(pkgdatadir)/lightsoff
 lightsoff_DATA = \
diff --git a/lightsoff/help/C/legal.xml b/lightsoff/help/C/legal.xml
new file mode 100644
index 0000000..ac97e1d
--- /dev/null
+++ b/lightsoff/help/C/legal.xml
@@ -0,0 +1,76 @@
+  <legalnotice id="legalnotice">
+	<para>
+	  Permission is granted to copy, distribute and/or modify this
+	  document under the terms of the GNU Free Documentation
+	  License (GFDL), 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.  You can find
+	  a copy of the GFDL at this <ulink type="help"
+	  url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
+	  distributed with this manual.
+         </para>
+         <para> This manual is part of a collection of GNOME manuals
+          distributed under the GFDL.  If you want to distribute this
+          manual separately from the collection, you can do so by
+          adding a copy of the license to the manual, as described in
+          section 6 of the license.
+	</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 the members of
+	  the GNOME Documentation Project are made aware of those
+	  trademarks, then the names are in capital letters or initial
+	  capital letters.
+	</para>
+
+	<para>
+	  DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
+	  UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
+	  WITH THE FURTHER UNDERSTANDING THAT:
+
+	  <orderedlist>
+		<listitem>
+		  <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
+                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
+                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
+                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
+                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
+                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
+                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
+                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
+                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
+                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
+                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
+                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
+                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
+                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
+                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
+                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
+                    EXCEPT UNDER THIS DISCLAIMER; AND
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
+                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
+                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
+                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
+                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
+                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
+                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
+                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
+                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
+                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
+                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
+                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
+                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
+                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
+                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
+                       THE POSSIBILITY OF SUCH DAMAGES.
+		  </para>
+		</listitem>
+	  </orderedlist>
+	</para>
+  </legalnotice>
+
diff --git a/lightsoff/help/C/lightsoff.xml b/lightsoff/help/C/lightsoff.xml
new file mode 100644
index 0000000..315f668
--- /dev/null
+++ b/lightsoff/help/C/lightsoff.xml
@@ -0,0 +1,222 @@
+<?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.28">
+  <!ENTITY manrevision "1.0">
+  <!ENTITY date "July 2009">
+  <!ENTITY app "<application>Lights Off</application>">
+  <!ENTITY appname "Lights Off">
+  <!ENTITY version "1.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</title>
+
+    <abstract role="description">
+      <para>
+	Lights Off is ...
+      </para>
+    </abstract>
+
+    <copyright>
+      <year>2009</year>
+      <holder>John Doe</holder>
+    </copyright>
+
+  <!-- translators: uncomment this:
+
+  <copyright>
+   <year>2000</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 role="maintainer"> 
+	<firstname>John</firstname> 
+	<surname>Doe</surname> 
+	<affiliation> 
+	  <address> <email>email example 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>
+	
+	<releaseinfo revision="2.26" role="review"/>
+
+    <revhistory>
+      <revision> 
+	<revnumber>&appname; Manual V&manrevision;</revnumber> 
+	<date>&date;</date> 
+	<revdescription> 
+	  <para role="author">???
+	    <email>email example 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 applications
+    listed in bugzilla.gnome.org and bugzilla.ximian.com. For other
+    applications, please provide your own feedback info or remove this
+    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:user-guide?feedback-bugs"
+	  type="help">GNOME Feedback Page</ulink>. 
+      </para>
+<!-- Translators may also add here feedback address for translations -->
+    </legalnotice>
+
+  </articleinfo>
+
+  <indexterm zone="index"> 
+    <primary>Lights Off</primary> 
+  </indexterm>
+
+<!-- ==============================Document Body==================-->
+
+<sect1 id="s1-intro">
+ <title>Introduction</title>
+
+<!--synopsis of game-->
+  <para><application>Lights Off</application> ...</para>
+
+<!--running game-->
+   <para>To run <application>Lights Off</application>, select <menuchoice><guimenu>Applications</guimenu><guisubmenu>Games</guisubmenu><guimenuitem>Lights Off</guimenuitem></menuchoice>, or type <command>lightsoff</command> in the command line.</para>
+
+<!--part of gnome-games-->
+   <para><application>Lights Off</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>Lights Off</application>.</para>
+</sect1>
+
+<sect1 id="s1-playing">
+ <title>Playing <application>Lights Off</application></title>
+  <para>You can score through two actions: completing lines and dropping blocks quickly. </para>
+   <sect2 id="s2-block-moving">
+     <title> Moving the Blocks</title>
+      <para>To play the game, you only need the four arrow keys.</para>
+       <itemizedlist>
+        <listitem>
+         <para><keycap>Left</keycap> and <keycap>Right</keycap> move the block correspondingly across the screen.</para>
+        </listitem>
+        <listitem>
+         <para><keycap>Up</keycap> rotates the block. The default rotation is counterclockwise. You can change the rotation under <menuchoice><guimenu>Settings</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> and deselecting <guilabel>Rotate blocks counterclockwise</guilabel>.</para>
+        </listitem>
+        <listitem>
+         <para><keycap>Down</keycap> and the <keycap>Space Bar</keycap> move the block down the screen faster.<keycap>Down</keycap> moves the block down faster. <keycap>Space-bar</keycap> moves the block directly to the bottom.</para>
+        </listitem>
+       </itemizedlist> 
+   </sect2>
+   <sect2 id="s2-newgame">
+     <title>Starting a New Game</title>
+      <para>To begin a new game, go to <menuchoice><guimenu>Game</guimenu><guimenuitem>New Game</guimenuitem></menuchoice>. The game will begin dropping blocks from the center of the top of the window. The default start-up of the game has no blocks in the game window and shows the next block that will fall in the upper right hand corner. <guilabel>Score</guilabel> shows the number of points you have earned. <guilabel>Lines</guilabel> shows the number of lines you have completed. <guilabel>Level</guilabel> shows the level of difficulty you are on.</para>
+    </sect2>
+</sect1>
+
+ 
+<sect1 id="s1-customizegame">
+ <title>Customizing <application>Lights Off</application></title>
+   <sect2 id="s2-customlook">
+    <title>Customizing the Look of <application>Lights Off</application></title>
+    <para>Under <menuchoice><guimenu>Settings</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>, you can customize the look of <application>Lights Off</application>: images for the blocks.</para>
+     <sect3 id="s3-blockimage">
+      <title>Block Image</title>
+       <para>You can change the style of the blocks, including image and size. There are a variety of pre-made styles.</para>
+     </sect3>
+     <sect3 id="s3-background">
+       <title>Background</title> <para>If you drag your favorite image
+       into the <application>Lights Off</application> window it will be
+       used as the background. If you want a solid color as the
+       background drag one in from either the color picker or from
+       <application>nautlilus'</application> <guimenuitem>Backgrounds
+       and Emblems</guimenuitem> dialog (the reset item from that
+       dialog also works).</para>
+     </sect3>
+    </sect2>
+   </sect1>
+
+<sect1 id="authors">
+  <title>Authors</title>
+  <para>
+   <application>Lights Off</application> was written by Tim Horton
+   in 2009 and maintained by Gnome Games Team since then. This manual was
+   written by ?.
+   To report a bug or make a suggestion regarding this application or
+   this manual, follow the directions in this
+   <ulink url="ghelp:user-guide?feedback-bugs" type="help">document</ulink>.
+  </para>
+
+  <!-- For translations: uncomment this:
+
+  <para>
+   Latin translation was done by ME
+   (<email>MYNAME MYADDRESS</email>). Please send all  comments  and
+   suggestions regarding this translation to SOMEWHERE.
+  </para>
+
+  -->
+</sect1>
+
+
+ <!-- ============= Application License ============================= -->
+
+ <sect1 id="s1-license">
+  <title>License</title>
+  <para>This program is free software; you can redistribute it and/or modify it under the terms of the  <ulink type="help" url="gnome-help:gpl"> <citetitle>GNU General Public License</citetitle></ulink> 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>
diff --git a/lightsoff/help/Makefile.am b/lightsoff/help/Makefile.am
new file mode 100644
index 0000000..7e57c6e
--- /dev/null
+++ b/lightsoff/help/Makefile.am
@@ -0,0 +1,12 @@
+include $(top_srcdir)/gnome-doc-utils.make
+
+DOC_LINGUAS = 
+
+DOC_MODULE = lightsoff
+
+DOC_ENTITIES = \
+	legal.xml
+
+DOC_FIGURES =
+
+dist-hook: doc-dist-hook
diff --git a/lightsoff/help/lightsoff.omf.in b/lightsoff/help/lightsoff.omf.in
new file mode 100644
index 0000000..eb4a97e
--- /dev/null
+++ b/lightsoff/help/lightsoff.omf.in
@@ -0,0 +1,9 @@
+<?xml version="1.0" standalone="no"?>
+<omf>
+  <resource>
+    <subject category="GNOME|Games"/>
+    <type>manual</type>
+    <relation seriesid="6de12070-69ae-11de-8a39-0800200c9a66"/>
+    <rights type="GNU FDL" license.version="1.1" holder="Tim Horton"/>
+  </resource>
+</omf>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]