summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorgregory guy <gregory-tde@laposte.net>2020-08-25 13:57:07 +0200
committergregory guy <gregory-tde@laposte.net>2020-08-25 13:57:07 +0200
commitd923b6d2082daa7605487a93f7f867ecc5054e94 (patch)
tree7b266b72f900fcc1aea7a4d6c3e3e7916e77d518 /doc
parenta212e6154c5d748ef6068fc3539790d4c806bfc5 (diff)
downloadtdepacman-d923b6d2082daa7605487a93f7f867ecc5054e94.tar.gz
tdepacman-d923b6d2082daa7605487a93f7f867ecc5054e94.zip
Rework of the help page.
Add a screenshot. Signed-off-by: gregory guy <gregory-tde@laposte.net>
Diffstat (limited to 'doc')
-rw-r--r--doc/en/CMakeLists.txt2
-rw-r--r--doc/en/index.docbook94
-rw-r--r--doc/en/screenshot.pngbin0 -> 14577 bytes
3 files changed, 28 insertions, 68 deletions
diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt
index de864ad..192dddc 100644
--- a/doc/en/CMakeLists.txt
+++ b/doc/en/CMakeLists.txt
@@ -1,7 +1,7 @@
file( GLOB _files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.html )
install(
- FILES ${_files} kpacman.gif
+ FILES ${_files} kpacman.gif screenshot.png
DESTINATION ${HTML_INSTALL_DIR}/en/${PROJECT_NAME}
)
diff --git a/doc/en/index.docbook b/doc/en/index.docbook
index c039dc5..d70e3b1 100644
--- a/doc/en/index.docbook
+++ b/doc/en/index.docbook
@@ -117,8 +117,12 @@ problems. Basically a long version of the abstract. Don't include a
revision history. (see installation appendix comment) -->
<para>
-&kapp; is a program that lets you do absolutely nothing. Please report
-any problems or feature requests to the KDE mailing lists.
+&kapp; is a classic arcade game from the 80s in which you have
+to finish the tables by eating all the pac-gums (dots) to score as many points
+as possible.
+</para>
+<para>Eat the dots and escape the ghosts with our hero.
+You can eat the big spot when needed and eat the ghosts when the color changes.
</para>
</chapter>
@@ -128,7 +132,8 @@ any problems or feature requests to the KDE mailing lists.
<!-- This chapter should tell the user how to use your app. You should use as
many sections (Chapter, Sect1, Sect3, etc...) as is necessary to fully document
your application. -->
-
+<para>Use the arrows from the keyboard to move &kapp;.</para>
+<para>Here is a screenshot of the game.</para>
<para>
<!-- Note that all graphics should be in .png format. Use no gifs because of
@@ -140,9 +145,6 @@ patent issues. -->
<imageobject>
<imagedata fileref="screenshot.png" format="PNG"/>
</imageobject>
- <imageobject>
- <imagedata fileref="screenshot.eps" format="EPS"/>
- </imageobject>
<textobject>
<phrase>Screenshot</phrase>
</textobject>
@@ -150,27 +152,6 @@ patent issues. -->
</screenshot>
</para>
-
-<sect1 id="kapp-features">
-<title>More Kapp features</title>
-
-<para>It slices! It dices! and it comes with a free toaster!</para>
-<para>
-The Stquiggle Tool <guiicon><inlinemediaobject>
- <imageobject>
- <imagedata fileref="stquiggle.png" format="PNG"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="stquiggle.eps" format="EPS"/>
- </imageobject>
- <textobject>
- <phrase>Stquiggle</phrase>
- </textobject>
-</inlinemediaobject></guiicon> is used to draw stquiggly lines all over
-the &kpacman; main window. It's not a bug, it's a feature!
-</para>
-
-</sect1>
</chapter>
<chapter id="commands">
@@ -236,8 +217,7 @@ used for apps that use plugins or that provide their own scripting hooks
and/or development libraries. -->
<para>
-Programming &kpacman; plugins is a joy to behold. Just read through the next
-66 pages of API's to learn how!
+Doc to make plugins has yet to be written...
</para>
<!-- Use refentries to describe APIs. Refentries are fairly complicated and you
@@ -268,19 +248,10 @@ application work. -->
<para>My Mouse doesn't work. How do I quit &kapp;?</para>
</question>
<answer>
-<para>You silly goose! Check out the <link linkend="commands">Commands
+<para>Please Check out the <link linkend="commands">Commands
Section</link> for the answer.</para>
</answer>
</qandaentry>
-<qandaentry>
-<question>
-<para>Why can't I twiddle my documents?</para>
-</question>
-<answer>
-<para>You can only twiddle your documents if you have the foobar.lib
-installed.</para>
-</answer>
-</qandaentry>
</qandaset>
</chapter>
@@ -338,11 +309,9 @@ Documentation copyright 1999 George N. Ugnacious <email>gnu@kde.org</email>
<title>How to obtain Kpacman</title>
<para>
-&kpacman; is part of the KDE project
-<ulink url="http://www.kde.org">http://www.kde.org</ulink>.
-&kpacman; can be found in the tdeutils package on
-<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, the
-main ftp site of the KDE project. </para>
+&kpacman; is part of the TDE project
+<ulink url="https://mirror.git.trinitydesktop.org/gitea/TDE/kpacman.git">https://mirror.git.trinitydesktop.org/gitea/TDE/kpacman</ulink>.
+</para>
</sect1>
<sect1 id="requirements">
@@ -360,22 +329,19 @@ information here.
-->
<para>
-In order to successfully use &kpacman;, you need KDE 1.1. Foobar.lib is required
-in order to support the advanced &kpacman; features. &kpacman; uses about 5 megs of
-memory to run, but this may vary depending on your platform and
-configuration.
+In order to successfully build &kapp;, the tdelibs and libtdegames libraries from the TDE project are required.
</para>
<para>
-All required libraries as well as &kpacman; itself can be found
-on <ulink url="ftp://ftp.kapp.org">The &kpacman; home page</ulink>.
+All required libraries as well as &kapp; itself can be found
+on <ulink url="https://mirror.git.trinitydesktop.org/gitea/explore/repos">The TDE's home dev page</ulink>.
</para>
<!-- For a list of updates, you may refer to the application web site
or the ChangeLog file, or ... -->
<para>
-You can find a list of changes at <ulink
-url="http://apps.kde.org/kapp">http://apps.kde.org/kapp</ulink>.
+You can find a list of changes (not currently updated) at <ulink
+url="https://mirror.git.trinitydesktop.org/gitea/TDE/kpacman/src/branch/master/ChangeLog">Changelog</ulink>.
</para>
</sect1>
@@ -383,25 +349,19 @@ url="http://apps.kde.org/kapp">http://apps.kde.org/kapp</ulink>.
<title>Compilation and Installation</title>
<para>
-In order to compile and install KApp on your system, type the following in the base
-directory of the Icon Editor distribution:
+In order to compile and install &kapp; on your system, type the following in the base
+directory of the &kapp; sources:
<screen width="40">
-<prompt>%</prompt> <userinput>./configure</userinput>
-<prompt>%</prompt> <userinput>make</userinput>
-<prompt>%</prompt> <userinput>make install</userinput>
+<prompt>%</prompt> <userinput>mkdir -p build</userinput>
+<prompt>%</prompt> <userinput>cd build</userinput>
+<prompt>%</prompt> <userinput>cmake ../</userinput>
+<prompt>%</prompt> <userinput>make V=1</userinput>
+<prompt>#</prompt> <userinput>make install</userinput>
</screen>
</para>
-<para>Since KApp uses autoconf and automake you should have not trouble compiling it.
-Should you run into problems please report them to the KDE mailing lists.</para>
-
-</sect1>
-
-<sect1 id="configuration">
-<title>Configuration</title>
-
-<para>Don't forget to tell your system to start the <filename>dtd</filename>
-dicer-toaster daemon first, or KApp won't work !</para>
+<para>Since &kapp; uses Cmake, you should have not trouble compiling it.</para>
+<para> Please have a look on the 'install' file for more options.</para>
</sect1>
diff --git a/doc/en/screenshot.png b/doc/en/screenshot.png
new file mode 100644
index 0000000..3e8ddb3
--- /dev/null
+++ b/doc/en/screenshot.png
Binary files differ