# The &tastymenu; Handbook

## Introduction

&tastymenu; is a TMenu replacement aiming to provide the maximum usability, or at least to be a testbed for usability concepts and ideas for a future TMenu replacement.

## Using &tastymenu;

Here's a screenshot of &tastymenu; Screenshot

The left part of the menu is very similar to the Novell idea(http://www.novell.com/products/desktop/preview.html): you have a search box that is always selected when the menu is opened (the search result are displayed in the leftmost listview), followed by a combobox that decides what the following listview: favourite applications (default), most used applications, recently used applications and recent documents.

The right part contains the whole TMenu and takes the aspect from KBFX, the middle column contains the top level categorization (plus in the current TMenu arrangment there are also the control center, home folder and find files, but i think there should be present only categories). in the left-most listview there is the content of the category currently selected in the middle column. I think in this way even if it has the same number of items it appears less huge than with a popup menu/submenu structure. Every items have two row, for the name and for the description, in order to make a more it more informative. On each selected item appears an action icon on the right, at the moment they are "add bookmark" on application icons and &remove bookmark &on favourite apps list.

The bottom buttons are the usual switch user, lock session and logout. In a first time I didn't want to put them, I tought that these function should be delegate to another applet like http://kde-apps.org/content/show.php?content=26150 , but it seems that the multiple menus concept it's a thing that doesn't work very well in practice, it needs more real-world testing.

The left-most btton contains the user name and icon, and clicking on it it opens the kcm used to edit the user's profile. I know it seems silly, but It's only an experiment, probably it will be merged with the switch user button.

### More &tastymenu; features

To do

## Command Reference

### The main &tastymenu; window

#### The search field

To do

## Questions and Answers

To do

## Credits and License

&tastymenu;

Program copyright 2006 Marco Martin notmart@gmail.com

Contributors:

- some code from Kbfx Spinx (http://www.kbfx.org) copyright (c) 2006 Kbfx team.

- dmctl.h and dmctl.c Copyright (c) 2004-2006 Oswald Buddenhagen and Stephan Kulow

- some code of the TastyListView from the statistics list view of Amarok (c) 2005-2006 Seb Ruiz

Documentation copyright 2006 Marco Martin notmart@gmail.com

&underFDL; &underLGPL;

## Installation

### How to obtain &tastymenu;

The latest &tastymenu; sources can be found at &homepage;

### Requirements

In order to successfully use &tastymenu;, you need at least &kde; 3.4 (didn't tested it under older &kde; versions, but it could compile anyway). it should suffice a stock &kde; found on most distributions, without special requirements

You can find a list of changes at &homepage;.

### Compilation and Installation

&install.compile.documentation;
&documentation.index;