Manual tests for the 'dash custom home screen' functionality
============================================================

How to test
-----------

To test the functionality, create the folder $HOME/.config/unity/, and copy the
three files HomeShortcutsCustomized*.json there.

Then for each of them repeat the following steps:

    cd $HOME/.config/unity/
    rm HomeShortcutsCustomized.json
    ln -s $FILE HomeShortcutsCustomized.json # replace $FILE with the json file being considered
    # restart unity
    # open the dash
    # check the visual appearance against the expected results detailed below


Expected results
----------------

With 'HomeShortcutsCustomized-4-entries.json', the home screen of the dash
contains 4 icons that fill the first row. The second row is empty.
Those icons are:
 - "Software Center": launches the Ubuntu Software Center, the icon is the
   Ubuntu Circle Of Friends, and if you are running with a French locale the
   name is localized to "Logithèque".
 - "Rock Music": opens the music lens with the genre filter set to "Rock".
 - "Vidéos": opens the files lens with the type filter set to "videos", the icon
   is a yellow star.
 - "Transmission BitTorrent Client": launches transmission-gtk.

With 'HomeShortcutsCustomized-8-entries.json', the home screen of the dash
contains 8 icons that fill the two rows. The first row contains the exact same
icons as 'HomeShortcutsCustomized-4-entries.json' (see details above). The icons
on the second row are:
 - "Eye Of Gnome": launches eog, if you are running with a German locale the
   name is localized to "Auge des Zwergs".
 - "Jockey": launches jockey-gtk.
 - "gwibber": launches gwibber.
 - "Giggle": this icon appears only if giggle is installed, it launches giggle.

With 'HomeShortcutsCustomized-broken.json', the home screen of the dash contains
the default icons because the file fails to be parsed.

