Manual testing of Dimbola
=========================

**Note: This version is for the upcoming 0.0.2 release.**

Dimbola has an automatic unit test suite with decent coverage. It does
not test everything, however, and particularly the UI parts of the code
are untested. Thus, for a Dimbola release, the following manual test
manuscript is supposed to be followed. It also does not cover everything,
but ensures at least that the basics work. As Dimbola evolves, this test
manuscript will evolve with it, to match the new or changed stuff in a
new release.


Update test manuscript for new release
--------------------------------------

If you are testing in preparation for a new release, first update
this test manuscript to match the upcoming release.


Setup
-----

Get the Dimbola test images from 
<http://files.liw.fi/dimbola-test-images.tar> and unpack them
in a location that is suitable for you.

If you have a default.dimbola file, please rename it for the
duration of this test manuscript, or run dimbola with
a filename for a new database file.

Start Dimbola, either from the command line or the GNOME menus.
Verify that there are no folders and no tags.


Importing
---------

Import all photos in dimbola-test-images (which you unpacked
in the setup section). 

Verify that all folders exist and images have a thumbnail, and can
be viewed in full size.


Browsing
--------

Select some photos. Verify that they have relevant EXIF data
which looks correct or at least does not not look obviously
incorrect.


Exporting
---------

Select some photos and export them twice: once as the original
files, and once as JPEGs. Export each to a different (preferably
new) folder.

Verify that the exported files look correct by opening them in
a suitable image viewer.


Tagging
-------

Create some tags. Arrange them in a hierarchy by dragging and dropping
them.

Add tags to photos by dragging and dropping to them, and to the 
currently selected photos' tag list. Select several tags, and
several photos, and drag the tags to the photos. Verify all
photos got all tags.

Remove tags from the photos' tag list using the popup menu.

Remove tags from the global list. Also remove a tag that apply to
some photos, and verify they get removed from the photos as well.


Rating
------

Select photos and add ratings to them. Then change the ratings.
Verify that they ratings stick if you select some other photo and
then go back.


Searching
---------

With some photos and tags and ratings in the database, search for
them with various criteria. Verify that you find the right ones.