# The &kmenuedit; Handbook

Milos
Prudek

    milos.prudek@worldonline.cz

Lauri
Watts

    vampyr@atconnex.net

Reviewer
2000
Milos Prudek
&FDLNotice;
14/12/2000
0.00.01

&kmenuedit; allows editing of the &kde; Main menu.

KDE
KDE Menu Editor
kmenuedit
application
program
menu
kicker

## Introduction

&kmenuedit; allows editing of &kde; Main menu.

&kmenuedit; can be started either by right-clicking the K Button, or by choosing Menu Edit from the System submenu of the Main menu.

&kmenuedit; allows you to:

- View and edit current Main menu

- Cut, Copy and paste menu items

- Create and delete submenus

### &kmenuedit; Revision History

- 0.0.1 - current release

## Using &kmenuedit;

The left application panel shows the Main menu structure. When you browse items in the left panel, the right panel shows detailed information for the highlighted menu item.

The right panel detailed menu item information is broken into two tabs: General and Advanced.

### General program information

Name

  This is the name of your program as it appears in the Main menu. It can be different from the real executable name. For instance the name of `mc` executable is "Midnight Commander".

Comment

  Describe the program in greater detail in this field. This is entirely optional.

Command

  This is the name of the executable program. Make sure that you have permission to run the program.

Type

  This field is similar to the Comment field. Describe the type of your program here.

Work Path

  Specify the work path of the program. This will be the current path when the program launches. It does not need to be the same as the executable location.

Icon List

  Click this icon to display a choice of icons. Choose an icon for your program.

Run in Terminal

  You must check this if your program requires terminal emulator in order to run. This mainly applies to console applications.

Terminal Options

  Put all terminal options in this field.

Run as different user

  If you want to run this program as a different user (not you), check this checkbox, and provide the username in the Username field.

### Advanced program information

You can assign a special keyboard shortcut to launch your program.

1. Click the Change button.

2. Choose Custom Key.

3. Check the SHIFT, CONTROL, and ALT checkboxes as desired.

4. Click the empty button to the right of the ALT checkbox and press the key on your keyboard that you want to be assigned to your program.

5. Click the OK button.

## Menu Reference

File New Item

  Adds new menu item.

File New Submenu

  Adds new submenu.

Ctrl Q File Quit

  Quits &kmenuedit;.

Ctrl X Edit Cut

  Cuts the current menu item to the clipboard. If you want to move menu item, you should first cut it to the clipboard, move to the destination place using the left panel, and use the Paste function to paste the menu item from the clipboard.

Ctrl C Edit Copy

  Copies the current menu item to the clipboard. You can later use the Paste function to paste the copied menu itemfrom the clipboard to its destination. You can paste the same item many times.

Ctrl V Edit Paste

  Paste menu item from the clipboard to currently selected place in the Main menu. You must first use Cut or Copy before you can Paste.

Edit Delete

  Deletes currently selected menu item.

Help Contents

  Choose Help Contents or click the Help Contents icon to display help pages for &kmenuedit; which you are right now reading.

Help Report Bug

  Choose Report Bug if you believe that you have discovered a bug in &kmenuedit;. A bug reporting window will be shown. Decide how annoying is the bug, and indicate it on Severity buttons. The KDE Team welcomes your bug reports, for they contribute significantly to improving the &kde;.

  You can also ask the &kmenuedit; authors to add additional features to the program. Just choose Wishlist as the Severity, and enter your wish. We are honestly looking forward to receiving your ideas.

Help About KDE Menu Editor

  Choose About KDE Menu Editor to display copyright information about &kmenuedit;, and the author list.

Help About KDE

  Choose About KDE to display copyright information about the &kde;.

### Glossary

Terminal emulator

  Terminal emulator is simply a windowed shell; this is known as "command line window" in some other environments. If you want to use the shell, you should know at least a few of the system-level commands for your operating system.

Applet

  A small application that occupies very little memory and screen space, and at the same time gives you some useful information or provides a control shortcut. For instance the Clock applet shows current time and date (and even a month diary if you click it), and System Monitor applet shows how busy your machine currently is in real-time.

Legacy Application

  An X-window application which was not written with &kde; in mind. Such applications run fine in KDE. However, they are not warned automatically when you shut down your KDE session. You therefore must not forget to save documents open in these applications before you log out from &kde;.

  Additionaly, many of these applications do not support copying and pasting from KDE-compliant applications. Netscape 4.x browser is a prominent example of such application Some GNOME applications may provide limited interoperability with the &kde;..

Console Application

  Application originally written for non-graphic, text oriented environment. Such applications run fine in KDE. They must run within console emulator, like Konsole. They are not warned automatically when you shut down your KDE session. You therefore must not forget to save documents open in these applications before you log out from the &kde;.

  Console applications support copying and pasting from KDE-compliant applications.Simply mark the text in the console application with your mouse, switch to the KDE-compliant application and press Ctrl V to paste the text. If you want to copy from KDE application to a console application, first mark the text with your mouse, press Ctrl C, switch to the console application and press the middle button on your mouse If your mouse does not have a middle button, you must press left and right button at the same time. This is called "middle button emulation" and it must be supported by your operating system to work..

## Credits and License

&kmenuedit;

Program copyright 2000, The KDE Developers

Contributors:

- Matthias Ettrich ettrich@kde.org

- Daniel M. Duley mosfet@kde.org

- Matthias Elter elter@kde.org

- Preston Brown pbrown@kde.org

Documentation copyright 2000 Milos Prudek

&underFDL; &underGPL;

## Installation

### How to obtain &kmenuedit;

&kmenuedit; is part of the &kde; project http://www.kde.org. &kmenuedit; can be found in the kdeubase package on ftp://ftp.kde.org/pub/kde/, the main ftp site of the &kde; project.

### Compilation and installation

In order to compile and install &kmenuedit; on your system, type the following in the base directory of the kdebase distribution:

    % ./configure
    % make
    % make install

Since &kmenuedit; uses autoconf and automake you should have not trouble compiling it. Should you run into problems please report them to the &kde; mailing lists.