<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kvideolist "<application>kvideolist</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="en">
<bookinfo>
<title>The KVideolist Handbook</title>
<authorgroup>
<author>
<firstname>Holger</firstname>
<surname>Hetterich</surname>
<affiliation><address><email><ulink url="mailto:holger.hetterich@erlangen.netsurf.de">holger.hetterich@erlangen.netsurf.de</ulink></email></address></affiliation>
</author>
<author>
<firstname>Christian</firstname>
<surname>Selig</surname>
<affiliation><address><email><ulink url="mailto:christian.selig@bamberg.baynet.de">christian.selig@bamberg.baynet.de</ulink></email></address></affiliation>
</author>
</authorgroup>
<date>v0.9,  12/04/98</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<abstract>
<para>This is the handbook for KVideolist, a small home-video database. It was last
updated for version 0.9.</para>
<para>KDE Documentation English</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>Documentation</keyword>
<keyword>English</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<sect1 id="what-is-kvideolist-">
<title>What is KVideolist ?</title>

<para>Maybe you also have a small home-video collection like me. You can use KVideolist
to collect interesting data about the films, and sort the list of your films in
many ways. KVideolist provides statistics about your collection and you can use a
flexible search on your collection. With this database, based on an index-system,
you will find your videos fast. You can easily answer questions like "How many films
do I have with actor xxx?" or "How many films where made by xxx?", "Which is my
oldest film?" and many more.</para>
</sect1>

<sect1 id="basic-features">
<title>Basic Features</title>

<para><itemizedlist>
<listitem>
<para>Support for up to 21 movie genres</para>
</listitem>
<listitem>
<para>Support for five different sort styles</para>
</listitem>
<listitem>
<para>An easy search engine, allows to search in all kind of relevant data</para>
</listitem>
<listitem>
<para>Differs LP (Longplay) and Normal VHS format</para>
</listitem>
<listitem>
<para>Support for personal rating</para>
</listitem>
<listitem>
<para>Produces useful statistics of your movie collection</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="motivation">
<title>Motivation</title>

<para>Why KVideolist when any of the existing database-products could be fit enough to do
the same task? Well, three reasons: I wanted to learn C++, I wanted to learn
QT/KDE-programming and it was just fun. </para>
</sect1>
</chapter>

<chapter id="first-steps">
<title>First steps</title>

<sect1 id="the-main-window">
<title>The main window</title>

<para>This chapter describes the basic features of KVideolist and helps you to be able to
built your own movie collection.  KVideolist presents you this window, if it is
started without any arguments:</para>

<para><graphic fileref="startup.jpg"></graphic></para>

<para>The white area on the left, with the KVideolist intropicture in it, will
contain your videolist, if you load on or add new entries to the list. </para>
</sect1>

<sect1 id="adding-a-movie">
<title>Adding a movie</title>

<para>Just click on Movies-&gt;Add. You will see a Movie-Entry dialog like this: 
In the text field "Title", you add the name of the movie. The next field
contains the main producer. </para>

<sect2 id="about-genres">
<title>About genres</title>

<para>To the right, you will see two selectable buttons. Click on one of them,
and you will see all the movie genres KVideolist offers. Using these two
buttons, you can categorize your movie. For example, the well known horror
film "Alien" is a "Horror" and "SciFi" movie. If you have a movie, that
exactly fits in only one of the categories, just disable the second
category, select "Nothing" on it. </para>
</sect2>

<sect2 id="the-cast-entry">
<title>The cast entry</title>

<para>There are 5 cast entries next. Enter here the main actors / actresses
that are playing in the movie. Note that you do not have to fill this
out, but you can and you should. You do not have to fill any of the
fields except the movie title and the tape number. </para>
</sect2>

<sect2 id="the-other-entries">
<title>The other entries</title>

<para>The other entries are self-explaining. In the field rating, you can enter
a personal rating for this movie, from 1 to 10 (10= bext, 1=worst), if
you do this on every film in the list, you can later sort your list by
rating in any genre. If you have a large collection, let's say more than
100 movies, this can be interessting. The videotape number describes the
number of the video tape, on which the movie is stored.   The field
"released" contains the Year, when the movie has seen it's first appearance
in cinemas or TV. You should enter 4 digits for the year here, e.g. 1984. </para>
</sect2>

<sect2 id="internet-movie-database">
<title>Internet Movie Database</title>

<para>If you would like to add some of this information, but do not have it by
hand now, just click on "IMDB". This connects you to the
<ulink url="http://www.imdb.com/">Internet Movie Database</ulink> where
you will find the needed information for sure. It contains more than
130.000 entries.</para>

<para>Click on "OK" to add the new entry to the movielist. It is now shown in
the list, and the intro-picture is gone. </para>
</sect2>
</sect1>

<sect1 id="editing-a-movie">
<title>Editing a Movie</title>

<para>If you select one movie in the list, KVideolist immediately shows all
its infos in its main window. The selected movie can be edited by simply
doubleclicking on it or selecting Movies-&gt;Edit from the menubar. You
will then see exactly the same window as by adding a new movie, except
that the contents are filled. </para>
</sect1>

<sect1 id="deleting-a-movie">
<title>Deleting a Movie</title>

<para>You can delete one movie from the list, if you select Movies-&gt;Delete.
The current selected movie will be deleted and the list will be resorted. </para>
</sect1>

<sect1 id="about-sorting-and-sort-modes">
<title>About sorting and sort-modes</title>

<para>If you want to follow this introduction, it needs to enter at least 3
movie entries, so you can see how sorting works. Select Sort and choose
what kind of sort you want. Sort by name means sorting the list in
alphabetical order. The others are self-explanatory.</para>

<para>Let's sort the list by tape number. You can always change the sort direction
in any sort mode, just select Sort-&gt;Change sort direction. The tapes
are now sorted either from the highest to the lowest or from the lowest
to the highest tape number.</para>

<para>Every sort mode and sort direction will stay as long as you choose another one.</para>
</sect1>

<sect1 id="searching-movies-and-search-mode">
<title>Searching movies and search mode</title>

<para>In the next step we will search the list for any kind of data. Select
Movies-&gt;Search and KVideolist will offer you a search selection window. </para>

<para>In the button named "no Search" you can choose what detailed data
type you search for. In the field "contains" you enter the data you
search for. Click on "Search" to enter the search mode. Like the sort
modes, KVideolist will not change the search mode until you select
Movies-&gt;Search and leave the data-type button on "no Search". This means
that from now on, only the movies where the search found an item will be shown.
These results are also sorted with the current sort mode and so on.
The search is always case-sensitive.
For example searching the producers for "Stephen Spielberg" and sorting by
rating shows you your best and worst movies produced by Stephen Spielberg. </para>

<para>Now, that you have built up a small movie collection, save the file using
File-&gt;Save. </para>
</sect1>

<sect1 id="the-toolbar">
<title>The toolbar</title>

<para><graphic fileref="toolbar.jpg"></graphic></para>

<para>You can reach all these functions very fast using KVideolists toolbar,
just hold the mouse longer over an item, to see what it does. </para>
</sect1>

<sect1 id="genrechooser">
<title>Genrechooser</title>

<para>If you want to limit the list to a specific genre, use the genrechooser
select Movies-&gt;Choose Genre. In this window, you can choose one of 21 genres
and from now on, only movies of this genre are shown. Note that if you have
selected a second genre, you will also see this film. For example, if "Alien"
is stored as a SciFi and Horror movie, "Alien" will be shown if you select
Movies-&gt;Choose Genre-&gt;Horror.
This function also works like search and sort, it is not changed until
you select Movies-&gt;Choose Genre-&gt;View All. </para>

<para>The usage of the sort, search, genrechooser functions together enables lots of
very interesting cominations. Just try it out.</para>
</sect1>

<sect1 id="producing-statistics">
<title>Producing statistics</title>

<para>You can sum up your complete movie collection by selecting Movies-&gt;Statistics.
This opens a large window, where you can see how much movies you have, how much
of them are in the VHS longplay format, and how much videos you have per genre.
Note that the count per genre also counts movies where two genres are stored.
That means, "Alien" (stored as "SciFi" and "Horror") will be counted in "SciFi"
and "Horror". So the sum of the count per genre will most likely not be the
same as the total number of movies. </para>
</sect1>
</chapter>

<chapter id="epilogue">
<title>Epilogue</title>

<sect1 id="features-in-next-release">
<title>Features in next release</title>

<para>As of this early version of KVideolist, printing is
not enabled. Anyway, it will hopefully support automated label-printing and
printing of your sorted lists in the upcoming versions.</para>
</sect1>

<sect1 id="contacting-the-author">
<title>Contacting the author</title>

<para>I you have any questions, or comments about KVideolist, feel free to E-Mail me: 
<ulink url="mailto:holger.hetterich@erlangen.netsurf.de">holger.hetterich@erlangen.netsurf.de</ulink></para>
</sect1>

<sect1 id="copyright">
<title>Copyright</title>

<para>KVideolist</para>

<para>Copyright 1998  Holger Hetterich, &lt;holger.hetterich@erlangen.netsurf.de&gt;</para>

<para>This program is free software; you can redistribute it and/or modify 
it under the terms of the GNU General Public License 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 GNU General Public License for more details.</para>

<para>You should have received a copy of the GNU General Public License 
along with this program; if not, write to the Free Software 
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
</sect1>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->
