Warning, /plasma/kmenuedit/doc/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
0003 "dtd/kdedbx45.dtd" [
0004  <!ENTITY kappname "&kde; Menu Editor">
0005   <!ENTITY package "kdebase">
0006   <!ENTITY firefox "<application>Firefox</application>">
0007   <!ENTITY % addindex "IGNORE">
0008   <!ENTITY % English "INCLUDE" > <!-- change language only here -->
0009 ]>
0010 
0011 <book id="kmenuedit" lang="&language;">
0012 
0013 <bookinfo>
0014 
0015 <title>The &kde; Menu Editor Handbook</title>
0016 
0017 <authorgroup>
0018 <author>&Milos.Prudek; &Milos.Prudek.mail;</author>
0019 <author>&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</author>
0020 <othercredit role="reviewer">
0021 &Lauri.Watts; &Lauri.Watts.mail;
0022 <!-- <contrib>Reviewer</contrib> -->
0023 </othercredit>
0024 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0025 </authorgroup>
0026 
0027 <copyright>
0028 <year>2000</year>
0029 <holder>&Milos.Prudek;</holder>
0030 </copyright>
0031 <copyright>
0032 <year>2008</year>
0033 <holder>&Anne-Marie.Mahfouf;</holder>
0034 </copyright>
0035 
0036 <legalnotice>&FDLNotice;</legalnotice>
0037 
0038 <date>2015-04-27</date>
0039 <releaseinfo>Plasma 5.3</releaseinfo>
0040 
0041 <abstract><para>&kmenuedit; allows editing one of the &kde; application launchers.
0042 </para></abstract>
0043 
0044 <keywordset>
0045 <keyword>KDE</keyword>
0046 <keyword>KDE Menu Editor</keyword>
0047 <keyword>kmenuedit</keyword>
0048 <keyword>application</keyword>
0049 <keyword>program</keyword>
0050 <keyword>menu</keyword>
0051 <keyword>kickoff</keyword>
0052 <keyword>Lancelot</keyword>
0053 </keywordset>
0054 
0055 </bookinfo>
0056 <chapter id="introduction">
0057 <title>Introduction</title>
0058 
0059 <para>&kmenuedit; allows editing the menu of &kde; application launchers.</para>
0060 
0061 <para>&kmenuedit; can be started either by &RMB; clicking the application launcher
0062 button on the panel and choosing <guimenuitem>Edit
0063 Applications...</guimenuitem>, or
0064 by typing <userinput>kmenuedit</userinput> in the &krunner; line.</para>
0065 
0066 <para>&kmenuedit; allows you to:</para>
0067 
0068 <itemizedlist>
0069 <listitem><para>View and edit the menu used by the current application launcher</para></listitem>
0070 <listitem><para><guimenuitem>Cut</guimenuitem>, <guimenuitem>Copy</guimenuitem>
0071 and <guimenuitem>Paste</guimenuitem> submenus and items</para></listitem>
0072 <listitem><para>Create and delete submenus and items</para></listitem>
0073 <listitem><para>Change the order of submenus and items</para></listitem>
0074 <listitem><para>Hide items and add new submenus and items</para></listitem>
0075 </itemizedlist>
0076 
0077 <para>By default all applications installed on the computer appear in the application launchers menu of all users.
0078 Applications may appear more than once in several different menus. 
0079 Empty submenu categories defined in the desktop menu specification will show up as well, 
0080 but are not visible in application launchers unless you install applications belonging to these categories.
0081 </para>
0082 
0083 <para>The tree view has two different entry types:</para>
0084 <itemizedlist>
0085 <listitem><para>Submenu: Only <guilabel>Name</guilabel>, <guilabel>Comment</guilabel> and 
0086 <guilabel>Description</guilabel> fields and the button to select an icon 
0087 are enabled, the <guilabel>Advanced</guilabel> tab is disabled. 
0088 Any submenu can hold additional submenus and/or items.
0089 </para></listitem>
0090 <listitem><para>Items: Use this entry to enter the data for the application you want to add. 
0091 For detailed information see <link linkend="using-kmenuedit">Using &kmenuedit;</link>.
0092 </para></listitem>
0093 </itemizedlist>
0094 
0095 <para>&kmenuedit; has two tree view modes - normal and with hidden entries. To see the latter check the option 
0096 <guilabel>Show hidden entries</guilabel> in the configuration dialog on the <guilabel>General options</guilabel> page.
0097 </para>
0098 <para>Many additional entries appear in hidden view mode in the tree. Several hidden entries seem to be just duplicates 
0099 but have different command options. Usually you should never change these hidden entries or you risk to break some 
0100 functionality of the system.
0101 </para>
0102 <para>In hidden mode you will have a special submenu <guilabel>.hidden [Hidden]</guilabel> as top level 
0103 item in the tree. This special submenu is not editable. In this submenu all deleted items will be shown at the next 
0104 start of &kmenuedit;.</para>
0105 <para>It is not possible to delete entries using the &GUI; in this special submenu. They will reappear at the 
0106 next start of &kmenuedit;.
0107 </para>
0108 
0109 <sect1 id="use-cases">
0110 <title>Use Cases</title>
0111 
0112 <sect2 id="use-cases-adapt">
0113 <title>Adapt the Menu for a User</title> 
0114 
0115 <sect3 id="use-cases-adapt-order">
0116 <title>Reorder Items</title> 
0117 
0118 <para>This should be done in hidden view mode where only the submenus and items visible in the application 
0119 launcher menu are displayed.
0120 </para>
0121 <para>By default the menu is sorted alphabetically using the English names or descriptions. Using another language 
0122 than English some submenus and items therefore will appear in an unsorted order.
0123 </para>
0124 <para>Use the options in <menuchoice><guimenu>Edit</guimenu><guimenuitem>Sort</guimenuitem></menuchoice>
0125 to sort either by name or description. If you use the classic application launcher you have to select the 
0126 corresponding <guilabel>Format</guilabel> option in the settings dialog. In the &kickoff; launcher check 
0127 <guilabel>Show applications by name</guilabel> if you sort them by name here.
0128 </para>
0129 <para>Grouping your frequently used submenus or items together &eg; at the top of the menu makes selecting them easier. 
0130 To change the order of particular items or submenus in the tree use the <guibutton>Move Up</guibutton> or 
0131 <guibutton>Move Down</guibutton> button in the toolbar or these actions in the menu. 
0132 </para>
0133 <para>All application launchers will use the order of submenus defined in &kmenuedit;.
0134 </para>
0135 </sect3>
0136 
0137 <sect3 id="use-cases-adapt-hide">
0138 <title>Remove Items from the Menu View</title> 
0139 
0140 <para>Having shown all applications installed on a computer may be confusing for some users so you may 
0141 want to hide some less frequently used items or submenus. There are two different ways to do that:
0142 </para>
0143 
0144 <para>Switch to normal view mode without hidden entries. If you delete items they are moved to the 
0145 <guilabel>.hidden [Hidden]</guilabel> submenu. You can move them back into the tree to have them in the menu again.
0146 </para>
0147 <para>If you delete a submenu it will be really deleted with all its submenus and items. 
0148 To recreate them you can use <menuchoice><guimenu>Edit</guimenu><guimenuitem>Restore to System 
0149 Menu</guimenuitem></menuchoice>, but this will remove all your custom submenus and items
0150 and the corresponding <filename class="extension">.desktop</filename> files are deleted too. This action cannot be reverted.
0151 </para>
0152 
0153 <para>The preferred way to remove submenus and items in the menu of an application launcher is to check <guilabel>Hidden 
0154 entry</guilabel> on the <guilabel>General</guilabel> tab and switch to the hidden view mode. 
0155 In this mode it is easy to revert changes without destroying the menu structure.
0156 The only drawback is that you have to hide all entries in a submenu manually to 
0157 hide the whole submenu from the view.
0158 </para>
0159 </sect3>
0160 
0161 </sect2>
0162 
0163 <sect2 id="use-cases-additems">
0164 <title>Adding Custom Items</title> 
0165 
0166 <para>To add custom items (submenu or item) use the actions in the menu or toolbar.
0167 Items need a Name and a Command, without a command entry an item will not be saved and your addition gets lost.
0168 </para>
0169 <para>If you add an entry it is inserted as sub entry at the actual highlighted position in the tree.
0170 Move an entry by dragging it with the mouse or using the <guibutton>Move Down</guibutton> button 
0171 to the bottom of the tree to make it a top level entry.
0172 </para>
0173 
0174 </sect2>
0175 
0176 <sect2 id="use-cases-transfer">
0177 <title>Transfer application launcher settings</title> 
0178 
0179 <para>There is no way to transfer menu settings using the &GUI;, you have to do that manually 
0180 and copy the following files to the target user:</para>
0181 <para>&kmenuedit; stores the menu hierarchy in 
0182 <filename>menus/applications-kmenuedit.menu</filename> in the folder <filename class="directory">$(qtpaths --paths
0183 GenericConfigLocation)</filename>
0184 and <filename class="directory">desktop-directories</filename> in the folder <filename class="directory">$(qtpaths --paths
0185 GenericDataLocation)</filename> contains desktop files for submenus you created.
0186 In <filename class="directory">applications/</filename> in the folder <filename class="directory">$(qtpaths --paths
0187 GenericDataLocation)</filename> you find the desktop files for the custom items you created.
0188 </para>
0189 <para>The shortcuts for each application are stored in <filename>kglobalshortcutsrc</filename>
0190 in the folder <filename class="directory">$(qtpaths --paths GenericConfigLocation)</filename>, 
0191 but export/import does not work because the UUIDs of the shortcuts do not match up between systems, even though the 
0192 <filename class="extension">.desktop</filename> files are the same. You have to assign all shortcuts manually again.
0193 </para>
0194 
0195 </sect2>
0196 
0197 </sect1>
0198 </chapter>
0199 
0200 <chapter id="quickstart">
0201 <chapterinfo>
0202 <authorgroup>
0203 <author>&Virgil.J.Nisly; &Virgil.J.Nisly.mail;</author>
0204 </authorgroup>
0205 </chapterinfo>
0206 <title>Adding a Menu Entry</title>
0207 
0208   <para>In this example, we will add &firefox; to the <guisubmenu>Internet</guisubmenu> submenu.</para>
0209   <para>To start off, we need to open &kmenuedit;, so &RMB; on the application
0210 launcher menu, click <guimenuitem>Edit Applications...</guimenuitem> to start
0211 &kmenuedit;. After &kmenuedit; has started, select <guisubmenu>Internet</guisubmenu> as shown in picture below.
0212 <screenshot>
0213 <screeninfo>Select <guisubmenu>Internet</guisubmenu></screeninfo>
0214 <mediaobject>
0215 <imageobject>
0216 <imagedata fileref="selectinternet.png" format="PNG" />
0217 </imageobject>
0218 <textobject>
0219 <phrase>Select <guisubmenu>Internet</guisubmenu></phrase>
0220 </textobject>
0221 </mediaobject>
0222 </screenshot></para>
0223   <para>
0224     Once you have selected <guisubmenu>Internet</guisubmenu>, click on <menuchoice><guimenu>File</guimenu><guimenuitem>New Item...</guimenuitem></menuchoice>, opening the <guilabel>New Item</guilabel> dialog, as shown below. Type the name of the program you want to add, in this case, type <userinput>firefox</userinput>.
0225 <screenshot>
0226 <screeninfo><guilabel>New Item</guilabel> dialog</screeninfo>
0227 <mediaobject>
0228 <imageobject>
0229 <imagedata fileref="itemname.png" format="PNG" />
0230 </imageobject>
0231 <textobject>
0232 <phrase>The <guilabel>New Item</guilabel> dialog.</phrase>
0233 </textobject>
0234 </mediaobject>
0235 </screenshot>
0236 </para>
0237 <para>
0238 Press return, and you should see something like the picture below in the main window.
0239 <screenshot>
0240 <screeninfo>New Item</screeninfo>
0241 <mediaobject>
0242 <imageobject>
0243 <imagedata fileref="new.png" format="PNG" />
0244 </imageobject>
0245 <textobject>
0246 <phrase>The new item created.</phrase>
0247 </textobject>
0248 </mediaobject>
0249 </screenshot></para>
0250 
0251 <para>
0252 Now lets fill in the <guilabel>Description:</guilabel>, in this case type <userinput>Web Browser</userinput>. 
0253 <note><para>The appearance how description and name will be displayed depends on the settings in the application 
0254 launcher &eg; <quote>Web Browser (Firefox)</quote> or <quote>Firefox (Web Browser)</quote>.</para></note> 
0255 We will need to fill in the executable name in the <guilabel>Command:</guilabel> field, in this instance we will type <userinput><command>firefox</command></userinput>.</para>
0256 <para>The command has to be in your <envar>PATH</envar> variable or you have to specify the full path to the executable.
0257 If you do not know the executable name of an application use the <userinput><command>locate</command></userinput>
0258 command to search for the desktop file and enter the string from the Exec line as command here.
0259 </para>
0260 <note><para>Following the command, you can have several place holders which will be replaced with actual values when the program is run:
0261 <simplelist>
0262 <member>%f - a single file name</member>
0263 <member>%F - a list of files; use for applications that can open several local files at once</member>
0264 <member>%u - a single &URL;</member>
0265 <member>%U - a list of &URL;s</member>
0266 <member>%d - the folder of a file to open</member>
0267 <member>%D - a list of folders</member>
0268 <member>%i - the icon</member>
0269 <member>%m - the mini icon</member>
0270 <member>%c - the caption</member>
0271 </simplelist></para>
0272 <informalexample><para>For example: if you want to firefox to start your web browsing at www.kde.org - instead of <command>firefox</command> you would type <command>firefox %u www.kde.org</command>.</para></informalexample></note>
0273 <para>Most applications accept additional options &eg; the name of a defined profile like &konqueror; or &konsole;.
0274 To see all options for an application launch <userinput><command><replaceable>applicationname</replaceable></command> <option>--help</option></userinput> in &konsole;.</para>
0275 <para>We would like to have a more creative icon, so we will click the generic icon sitting beside <guilabel>Name:</guilabel> (note, the default icon may be blank, in which case click in the area to the right of the name entry box.) It will bring the <guilabel>Select Icon</guilabel> dialog which will let us choose the new icon, as shown below.
0276 <screenshot>
0277 <screeninfo><guilabel>Select Icon</guilabel> dialog</screeninfo>
0278 <mediaobject>
0279 <imageobject>
0280 <imagedata fileref="selecticon.png" format="PNG" />
0281 </imageobject>
0282 <textobject>
0283 <phrase>The <guilabel>Select Icon</guilabel> dialog.</phrase>
0284 </textobject>
0285 </mediaobject>
0286 </screenshot></para>
0287 
0288   <para>We choose the firefox icon from the list, and press &Enter;. Your finished screen should probably look something like the screenshot below.
0289 <screenshot>
0290 <screeninfo>Done screenshot</screeninfo>
0291 <mediaobject>
0292 <imageobject>
0293 <imagedata fileref="done.png" format="PNG" />
0294 </imageobject>
0295 <textobject>
0296 <phrase>This is what the completed menu item should looks like.</phrase>
0297 </textobject>
0298 </mediaobject>
0299 </screenshot></para>
0300 
0301 <para>The place of the new menu item can now be changed using <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton> buttons on the &kmenuedit; toolbar or by dragging with the mouse.</para>
0302  <para>The submenu items can be sorted using <guibutton>Sort</guibutton> button on the &kmenuedit; toolbar or <menuchoice><guimenu>Edit</guimenu><guisubmenu>Sort</guisubmenu></menuchoice> submenu items.</para>
0303 
0304 <para>Click <menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice>, wait for the <guilabel>Updating System Configuration</guilabel> dialog to get finished, you should find &firefox; in the application launcher <guisubmenu>Internet</guisubmenu> submenu.</para>
0305 
0306 </chapter>
0307 
0308 <chapter id="using-kmenuedit">
0309 <title>Using &kmenuedit;</title>
0310 
0311 <para>The left application panel shows the application launcher structure. When
0312 you browse items in the left panel, the right panel shows detailed
0313 information for the highlighted menu item.</para>
0314 
0315 <sect1 id="details-general">
0316 <title>General tab</title>
0317 
0318 <variablelist>
0319 <varlistentry>
0320 <term><guilabel>Name:</guilabel></term>
0321 <listitem><para>This is the name of your program as it appears in the
0322 application launcher menu. It can be different from the real executable
0323 name. For instance the name of <command>mc</command> executable is
0324 "<application>Midnight Commander</application>".</para></listitem>
0325 </varlistentry>
0326 <varlistentry>
0327 <term><guilabel>Description:</guilabel></term>
0328 <listitem><para>The description will be displayed together with the name in the application launcher. This is entirely optional.</para></listitem>
0329 </varlistentry>
0330 <varlistentry>
0331 <term><guilabel>Comment:</guilabel></term>
0332 <listitem><para>Describe the program in greater detail in this field. This is
0333 entirely optional.</para></listitem>
0334 </varlistentry>
0335 <varlistentry>
0336 <term><guilabel>Command:</guilabel></term>
0337 <listitem><para>This is the name of the executable program. Make sure that you
0338 have permission to run the program.</para></listitem>
0339 </varlistentry>
0340 <varlistentry>
0341 <term><guilabel>Enable launch feedback</guilabel></term>
0342 <listitem><para>If this box is checked, this will display feedback when an application is started.
0343 </para></listitem>
0344 </varlistentry>
0345 <varlistentry>
0346 <term><guilabel>Only show in &kde;</guilabel></term>
0347 <listitem><para>When checked, the application entry will only be visible in all &kde; application launchers but not in other desktops environments.
0348 </para></listitem>
0349 </varlistentry>
0350 <varlistentry>
0351 <term><guilabel>Hidden entry</guilabel></term>
0352 <listitem><para>Remove an entry from the menu view in the application launcher. </para></listitem>
0353 </varlistentry>
0354 </variablelist>
0355 </sect1>
0356 
0357 <sect1 id="details-advanced">
0358 <title>Advanced tab</title>
0359 
0360 <variablelist>
0361 <varlistentry>
0362 <term><guilabel>Work path:</guilabel></term>
0363 <listitem><para>Specify the work path of the program. This will be the current
0364 path when the program launches. It does not need to be the same as the
0365 executable location.</para></listitem>
0366 </varlistentry>
0367 <varlistentry>
0368 <term><guilabel>Run in terminal</guilabel></term>
0369 <listitem><para>You must check this if your program requires terminal emulator
0370 in order to run. This mainly applies to <link
0371 linkend="gloss-console-application">console
0372 applications</link>.</para></listitem>
0373 </varlistentry>
0374 <varlistentry>
0375 <term><guilabel>Terminal options:</guilabel></term>
0376 <listitem><para>Put all terminal options in this field.</para></listitem>
0377 </varlistentry>
0378 <varlistentry>
0379 <term><guilabel>Run as a different user</guilabel></term>
0380 <listitem><para>If you want to run this program as a different user (not you),
0381 check this checkbox, and provide the username in the
0382 <guilabel>Username:</guilabel> field.</para></listitem>
0383 </varlistentry>
0384 
0385 <varlistentry>
0386 <term><guilabel>Current shortcut key:</guilabel></term>
0387 <listitem><para>You can assign a special keyboard shortcut to launch your program.</para>
0388 
0389 <para>Click the <guibutton>None</guibutton> button to the right of the <guilabel>Current
0390 shortcut key:</guilabel> checkbox.</para>
0391 
0392 <para>The button text will change to <guilabel>Input...</guilabel>
0393 and you can press the key combination on your keyboard that you want to be assigned to your program.
0394 </para>
0395 <para>You can reset the shortcut to <guilabel>None</guilabel> by using this button: <inlinemediaobject><imageobject> <imagedata
0396 fileref="reset.png" format="PNG"/></imageobject></inlinemediaobject>.
0397 </para>
0398 
0399 <para>Don't forget to save your setting by clicking the toolbar <guiicon>Save</guiicon> icon or using the <menuchoice>
0400 <guimenu>File</guimenu><guimenuitem>Save</guimenuitem>
0401 </menuchoice> menu item.</para>
0402 
0403 </listitem>
0404 </varlistentry>
0405 </variablelist>
0406 </sect1>
0407 
0408 </chapter>
0409 
0410 <chapter id="menu-reference">
0411 <title>Menu Reference</title>
0412 
0413 <para>Most actions in the menubar are also available in the context menu opened with a &RMB; 
0414 click on an item in the tree view.</para>
0415 
0416 <variablelist>
0417 <varlistentry id="file-new-item">
0418 <term><menuchoice>
0419 <shortcut><keycombo
0420 action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
0421 <guimenu>File</guimenu> <guimenuitem>New Item...</guimenuitem>
0422 </menuchoice></term> <listitem><para><action>Adds new menu
0423 item.</action></para></listitem>
0424 </varlistentry>
0425 
0426 <varlistentry id="file-new-submenu">
0427 <term><menuchoice>
0428 <guimenu>File</guimenu>
0429 <guimenuitem>New Submenu...</guimenuitem>
0430 </menuchoice></term>
0431 <listitem><para><action>Adds new submenu.</action></para></listitem>
0432 </varlistentry>
0433 
0434 <varlistentry id="file-save">
0435 <term><menuchoice>
0436 <shortcut><keycombo
0437 action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut>
0438 <guimenu>File</guimenu><guimenuitem>Save</guimenuitem>
0439 </menuchoice></term>
0440 <listitem>
0441 <para><action>Saves the menu</action></para>
0442 </listitem>
0443 </varlistentry>
0444 
0445 <varlistentry id="file-quit">
0446 <term><menuchoice>
0447 <shortcut>
0448 <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
0449 </shortcut>
0450 <guimenu>File</guimenu>
0451 <guimenuitem>Quit</guimenuitem>
0452 </menuchoice></term>
0453 <listitem><para><action>Quits</action> &kmenuedit;.</para></listitem>
0454 </varlistentry>
0455 
0456 <varlistentry id="edit-move-up">
0457 <term><menuchoice>
0458 <guimenu>Edit</guimenu>
0459 <guimenuitem>Move Up</guimenuitem>
0460 </menuchoice></term>
0461 <listitem><para><action>Moves</action> the selected item up in its submenu.</para></listitem>
0462 </varlistentry>
0463 
0464 <varlistentry id="edit-move-down">
0465 <term><menuchoice>
0466 <guimenu>Edit</guimenu>
0467 <guimenuitem>Move Down</guimenuitem>
0468 </menuchoice></term>
0469 <listitem><para><action>Moves</action> the selected item down in its submenu.</para></listitem>
0470 </varlistentry>
0471 
0472 
0473 <varlistentry id="edit-cut">
0474 <term><menuchoice>
0475 <shortcut>
0476 <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
0477 </shortcut>
0478 <guimenu>
0479 Edit</guimenu> <guimenuitem>Cut</guimenuitem>
0480 </menuchoice></term>
0481 <listitem><para><action>Cuts the current menu item to the clipboard.</action> If
0482 you want to move menu item, you should first cut it to the clipboard, move to
0483 the destination place using the left panel, and use the
0484 <guimenuitem>Paste</guimenuitem> function to paste the menu item from the
0485 clipboard.</para></listitem>
0486 </varlistentry>
0487 
0488 <varlistentry id="edit-copy">
0489 <term><menuchoice>
0490 <shortcut>
0491 <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
0492 </shortcut>
0493 <guimenu>
0494 Edit</guimenu> <guimenuitem>Copy</guimenuitem>
0495 </menuchoice></term>
0496 <listitem><para><action>Copies the current menu item to the
0497 clipboard</action>. You can later use the <guimenuitem>Paste</guimenuitem>
0498 function to paste the copied menu item from the clipboard to its destination. You
0499 can paste the same item many times.</para></listitem>
0500 </varlistentry>
0501 
0502 <varlistentry id="edit-paste">
0503 <term><menuchoice>
0504 <shortcut>
0505 <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
0506 </shortcut>
0507 <guimenu>Edit</guimenu>
0508 <guimenuitem>Paste</guimenuitem> </menuchoice></term>
0509 <listitem><para><action>Paste menu item from the clipboard</action> to currently
0510 selected place in the main menu. You must first use
0511 <guimenuitem>Cut</guimenuitem> or <guimenuitem>Copy</guimenuitem> before you can
0512 <guimenuitem>Paste</guimenuitem>.</para></listitem>
0513 </varlistentry>
0514 
0515 <varlistentry id="edit-delete">
0516 <term><menuchoice>
0517 <shortcut><keycap>Del</keycap></shortcut>
0518 <guimenu>Edit</guimenu> <guimenuitem>Delete</guimenuitem>
0519 </menuchoice></term>
0520 <listitem><para><action>Deletes currently selected menu
0521 item.</action></para></listitem>
0522 </varlistentry>
0523 
0524 <varlistentry id="edit-sort">
0525 <term><menuchoice>
0526 <guimenu>Edit</guimenu>
0527 <guisubmenu>Sort</guisubmenu>
0528 </menuchoice></term>
0529 <listitem><para><action>Opens</action> submenu to sort selected submenu or all menu tree. There are two sorting methods implemented, namely, by the name and by the description.</para></listitem>
0530 </varlistentry>
0531 
0532 <varlistentry id="edit-restore">
0533 <term><menuchoice>
0534 <guimenu>Edit</guimenu> <guimenuitem>Restore to System Menu</guimenuitem>
0535 </menuchoice></term>
0536 <listitem><para><action>This will restore the application launcher as it was as default and remove all your custom settings. A message box will ask you if you really want to do that.</action></para></listitem>
0537 </varlistentry>
0538 
0539 </variablelist>
0540 
0541 <para>
0542 &kmenuedit; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
0543 menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings"
0544 >Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
0545 of the &kde; Fundamentals.
0546 </para>
0547 
0548 </chapter>
0549 
0550 <chapter id="credits">
0551 
0552 <title>Credits and License</title>
0553 
0554 <para>
0555 &kmenuedit;
0556 </para>
0557 <para>Program copyright &copy; 2002, &Raffaele.Sandrini;</para>
0558 
0559 <para>Contributors:</para>
0560 <itemizedlist>
0561 <listitem><para>&Matthias.Elter; &Matthias.Elter.mail; - Original
0562 Author</para>
0563 </listitem>
0564 <listitem><para>&Matthias.Ettrich; &Matthias.Ettrich.mail;</para>
0565 </listitem>
0566 <listitem><para>&Daniel.M.Duley; &Daniel.M.Duley.mail;</para>
0567 </listitem>
0568 <listitem><para>&Preston.Brown; &Preston.Brown.mail;</para>
0569 </listitem>
0570 </itemizedlist>
0571 
0572 <para>Documentation copyright &copy; 2000 &Milos.Prudek;</para>
0573 <para>Documentation copyright &copy; 2008 &Anne-Marie.Mahfouf;</para>
0574 <para>Updated for &kde; 3.0 by &Lauri.Watts; &Lauri.Watts.mail;
0575 2002</para>
0576 
0577 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
0578 
0579 &underFDL;
0580 &underGPL;
0581 
0582 </chapter>
0583 
0584 <glossary id="glossary">
0585 <title>Glossary</title>
0586 
0587 <glossentry id="gloss-console-application">
0588 <glossterm>Console Application</glossterm>
0589 <glossdef>
0590 
0591 <para>Application originally written for non-graphic, text oriented
0592 environment. Such applications run fine in &kde;. They must run within
0593 console emulator, like &konsole;. They are not warned automatically
0594 when you shut down your &kde; session. You therefore must not forget
0595 to save documents open in these applications before you log out from
0596 the &kde;.</para>
0597 
0598 <para>Console applications support copying and pasting from
0599 &kde;-compliant applications.Simply mark the text in the console
0600 application with your mouse, switch to the &kde;-compliant application
0601 and press <keycombo action="simul">&Ctrl;
0602 <keycap>V</keycap></keycombo> to paste the text. If you want to copy
0603 from &kde; application to a console application, first mark the text
0604 with your mouse, press <keycombo action="simul">&Ctrl;
0605 <keycap>C</keycap></keycombo>, switch to the console application and
0606 press the middle button on your mouse<footnote><para>If your mouse
0607 does not have a middle button, you must press
0608 <mousebutton>left</mousebutton> and <mousebutton>right</mousebutton>
0609 button at the same time. This is called <quote>middle button
0610 emulation</quote> and it must be supported by your operating system to
0611 work.</para></footnote>.</para>
0612 
0613 </glossdef>
0614 </glossentry>
0615 
0616 </glossary>
0617 
0618 &documentation.index;
0619 
0620 </book>
0621 <!--
0622 Local Variables:
0623 mode: sgml
0624 sgml-minimize-attributes: nil
0625 sgml-general-insert-case: lower
0626 End:
0627 -->
0628