[kde-doc-english] [Bug 137751] typos in kmenuedit doc
Burkhard Lueck
lueck at hube-lueck.de
Thu Nov 23 22:33:19 CET 2006
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
http://bugs.kde.org/show_bug.cgi?id=137751
lueck hube-lueck de changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |RESOLVED
Resolution| |FIXED
------- Additional Comments From lueck hube-lueck de 2006-11-23 22:33 -------
SVN commit 607260 by lueck:
updated docbook, thanks to Natalie for the report
BUG:137751
M +72 -59 index.docbook
--- trunk/KDE/kdebase/doc/kmenuedit/index.docbook #607259:607260
@ -1,10 +1,8 @
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
- <!ENTITY kappname "&kmenuedit;">
<!ENTITY package "kdebase">
<!ENTITY firefox "<application>Firefox</application>">
- <!ENTITY internet "Internet">
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE" > <!-- change language only here -->
]>
@ -32,10 +30,10 @
<legalnotice>&FDLNotice;</legalnotice>
-<date>2000-12-14</date>
-<releaseinfo>0.00.01</releaseinfo>
+<date>2006-11-23</date>
+<releaseinfo>0.7 (&kde; 3.5.5)</releaseinfo>
-<abstract><para>&kmenuedit; allows editing of the &kde; Main menu.
+<abstract><para>&kmenuedit; allows editing of the &kde; &kmenu;.
</para></abstract>
<keywordset>
@ -54,21 +52,20 @
<chapter id="introduction">
<title>Introduction</title>
-<para>&kmenuedit; allows editing of &kde; Main menu.</para>
+<para>&kmenuedit; allows editing of &kde; &kmenu;.</para>
<para>&kmenuedit; can be started either by &RMB; clicking the
-<guiicon>K</guiicon> Menu Button on the panel, or by choosing
-<guimenuitem>Menu Edit</guimenuitem> from the
-<guisubmenu>System</guisubmenu> submenu of the <guimenu>Main</guimenu>
-menu.</para>
+&kmenu; button on the panel and choosing
+<guimenuitem>Menu Editor</guimenuitem>, or by choosing
+<guimenuitem>Menu Editor</guimenuitem> from the
+<guisubmenu>Settings</guisubmenu> submenu of the &kmenu;.</para>
<para>&kmenuedit; allows you to:</para>
<itemizedlist>
-<listitem><para>View and edit current <guimenu>Main</guimenu>
-menu</para></listitem>
+<listitem><para>View and edit the current &kmenu;</para></listitem>
<listitem><para><guimenuitem>Cut</guimenuitem>, <guimenuitem>Copy</guimenuitem>
-and <guimenuitem>paste</guimenuitem> menu items</para></listitem>
+and <guimenuitem>Paste</guimenuitem> menu items</para></listitem>
<listitem><para>Create and delete submenus</para></listitem>
</itemizedlist>
@ -82,29 +79,29 @
</chapterinfo>
<title>A Quick Start Guide to Adding an Entry to the &kmenu;</title>
- <para>In this example, we will add &firefox; to the Internet menu. <note><para>Most applications can be added with &kappfinder;, &firefox; can usually be added that way, but was used for lack of a a better example.</para></note></para>
- <para>To start off, we need to open &kmenuedit;, so &RMB; on the &kmenu;, click <guimenuitem>Menu Editor</guimenuitem> to start &kmenuedit;. After &kmenuedit; has started, select &internet; as shown in picture below.
+ <para>In this example, we will add &firefox; to the <guisubmenu>Internet</guisubmenu> submenu. <note><para>Most applications can be added with &kappfinder;, &firefox; can usually be added that way, but was used for lack of a better example.</para></note></para>
+ <para>To start off, we need to open &kmenuedit;, so &RMB; on the &kmenu;, click <guimenuitem>Menu Editor</guimenuitem> to start &kmenuedit;. After &kmenuedit; has started, select <guisubmenu>Internet</guisubmenu> as shown in picture below.
<screenshot>
-<screeninfo>Select Internet</screeninfo>
+<screeninfo>Select <guisubmenu>Internet</guisubmenu></screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="selectinternet.png" format="PNG" />
</imageobject>
<textobject>
-<phrase>Select Internet</phrase>
+<phrase>Select <guisubmenu>Internet</guisubmenu></phrase>
</textobject>
</mediaobject>
</screenshot></para>
<para>
- Once you have selected &internet;, 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>.
+ 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>.
<screenshot>
-<screeninfo>New Item dialog</screeninfo>
+<screeninfo><guilabel>New Item</guilabel> dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="itemname.png" format="PNG" />
</imageobject>
<textobject>
-<phrase>The new item dialog.</phrase>
+<phrase>The <guilabel>New Item</guilabel> dialog.</phrase>
</textobject>
</mediaobject>
</screenshot>
@ -124,13 +121,13 @
</screenshot></para>
<para>
- Now lets fill in the <guilabel>Description:</guilabel>, in this case type <userinput>Web Browser</userinput>. <note><para>The description and name will be displayed on the &kmenu; as <quote>Web Browser (Firefox)</quote>.</para></note> We will need to fill out executable name in the <guilabel>Command:</guilabel> field, in this instance we will type <userinput><command>firefox</command></userinput>.</para>
+ Now lets fill in the <guilabel>Description:</guilabel>, in this case type <userinput>Web Browser</userinput>. <note><para>The description and name will be displayed on the &kmenu; as <quote>Web Browser (Firefox)</quote>.</para></note> 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>
<note><para>Following the command, you can have several place holders which will be replaced with actual values when the program is run:
<simplelist>
<member>%f - a single file name</member>
<member>%F - a list of files; use for applications that can open several local files at once</member>
-<member>%u - a single URL</member>
-<member>%U - a list of URLs</member>
+<member>%u - a single &URL;</member>
+<member>%U - a list of &URL;s</member>
<member>%d - the folder of a file to open</member>
<member>%D - a list of folders</member>
<member>%i - the icon</member>
@ -140,13 +137,13 @
<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>
<para>We would like to have a more creative icon, so we will click the generic icon sitting beside <guilabel>Name:</guilabel>. It will bring the <guilabel>Select Icon</guilabel> dialog which will let us choose the new icon, as shown below.
<screenshot>
-<screeninfo>Select Icon dialog</screeninfo>
+<screeninfo><guilabel>Select Icon</guilabel> dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="selecticon.png" format="PNG" />
</imageobject>
<textobject>
-<phrase>The select icon dialog.</phrase>
+<phrase>The <guilabel>Select Icon</guilabel> dialog.</phrase>
</textobject>
</mediaobject>
</screenshot></para>
@ -164,16 +161,16 @
</mediaobject>
</screenshot></para>
-<para>Click <menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice>, wait for the <guilabel>Updating System</guilabel> dialog to get finished, you should find &firefox; in the &kmenu; <guisubmenu>&internet;</guisubmenu> sub menu!</para>
-
+<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 &kmenu; <guisubmenu>Internet</guisubmenu> submenu!</para>
+
</chapter>
<chapter id="using-kmenuedit">
<title>Using &kmenuedit;</title>
-<para>The left application panel shows the Main menu structure. When
+<para>The left application panel shows the &kmenu; structure. When
you browse items in the left panel, the right panel shows detailed
information for the highlighted menu item.</para>
@ -182,32 +179,39 @
<variablelist>
<varlistentry>
-<term><guilabel>Name</guilabel></term>
+<term><guilabel>Name:</guilabel></term>
<listitem><para>This is the name of your program as it appears in the
-<guimenu>Main</guimenu> menu. It can be different from the real executable
+&kmenu; menu. It can be different from the real executable
name. For instance the name of <command>mc</command> executable is
"<application>Midnight Commander</application>".</para></listitem>
</varlistentry>
<varlistentry>
-<term><guilabel>Comment</guilabel></term>
+<term><guilabel>Description:</guilabel></term>
+<listitem><para>The description will be displayed together with the name in the &kmenu;. This is
+entirely optional.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Comment:</guilabel></term>
<listitem><para>Describe the program in greater detail in this field. This is
entirely optional.</para></listitem>
</varlistentry>
<varlistentry>
-<term><guilabel>Command</guilabel></term>
+<term><guilabel>Command:</guilabel></term>
<listitem><para>This is the name of the executable program. Make sure that you
have permission to run the program.</para></listitem>
</varlistentry>
<varlistentry>
-<term><guilabel>Type</guilabel></term>
-<listitem><para>This field is similar to the Comment field. Describe
-the type of your program here.</para></listitem>
+<term><guilabel>Enable launch feedback</guilabel></term>
+<listitem><para>If this box is checked, this will display feedback when an application is started
+</para></listitem>
</varlistentry>
<varlistentry>
-<term><guilabel>Work Path</guilabel></term>
-<listitem><para>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.</para></listitem>
+<term><guilabel>Place in system tray</guilabel></term>
+<listitem><para>When checked, the application's icon will show up in the panel system tray.
+You will then be able to hide or show the application by clicking on the system
+tray icon. Clicking on it using the &RMB; will allow also you to undock, or quit the
+application.
+</para></listitem>
</varlistentry>
<varlistentry>
<term><guiicon>Icon List</guiicon></term>
@ -216,43 +220,49 @
program.</para></listitem>
</varlistentry>
<varlistentry>
-<term><guilabel>Run in Terminal</guilabel></term>
+<term><guilabel>Work path:</guilabel></term>
+<listitem><para>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.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Run in terminal</guilabel></term>
<listitem><para>You must check this if your program requires terminal emulator
in order to run. This mainly applies to <link
linkend="gloss-console-application">console
applications</link>.</para></listitem>
</varlistentry>
<varlistentry>
-<term><guilabel>Terminal Options</guilabel></term>
+<term><guilabel>Terminal options:</guilabel></term>
<listitem><para>Put all terminal options in this field.</para></listitem>
</varlistentry>
<varlistentry>
-<term><guilabel>Run as different user</guilabel></term>
+<term><guilabel>Run as a different user</guilabel></term>
<listitem><para>If you want to run this program as a different user (not you),
check this checkbox, and provide the username in the
-<guilabel>Username</guilabel> field.</para></listitem>
+<guilabel>Username:</guilabel> field.</para></listitem>
</varlistentry>
</variablelist>
<para>You can assign a special keyboard shortcut to launch your program.</para>
-<para>Click the empty button to the right of the <guilabel>Current
-key</guilabel> checkbox and press the key combination on your keyboard
-that you want to be assigned to your program.</para>
+<para>Click the <guibutton>None</guibutton> button to the right of the <guilabel>Current
+shortcut key:</guilabel> checkbox.</para>
-<para>A dialog box will pop up, allowing you to assign a second
+<para>A dialog box will pop up, allowing you to assign a <guilabel>Primary shortcut:</guilabel>
+by pressing the key combination on your keyboard that you want to be assigned to your program.
+It might be useful to assign a second
keybinding to the same item by checking the
-<guilabel>Alternate</guilabel> button. This might be useful, for
+<guilabel>Alternate shortcut:</guilabel> button, for
example, if you often switch keyboard maps, and some shortcuts are not
as convenient to type at all times.</para>
<para>Click the <guiicon>x</guiicon> to clear the shortcut, if you
-made a mistake. Check the <guilabel>Multi-Key</guilabel> box if you
+made a mistake. Check the <guilabel>Multi-key mode</guilabel> box if you
want to assign a shortcut that uses more than one key.</para>
-<para>By default the <guilabel>Auto-Close</guilabel> box is checked,
-and the dialog will close when you have selected a keybinding.
-Uncheck it if you want the dialog to stay open.</para>
+<para>The dialog will close when you have selected a keybinding.
+</para>
</sect1>
@ -263,8 +273,10 @
<variablelist>
<varlistentry id="file-new-item">
-<term><menuchoice> <guimenu>
-File</guimenu> <guimenuitem>New Item</guimenuitem>
+<term><menuchoice>
+<shortcut><keycombo
+action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
+<guimenu>File</guimenu> <guimenuitem>New Item...</guimenuitem>
</menuchoice></term> <listitem><para><action>Adds new menu
item.</action></para></listitem>
</varlistentry>
@ -272,7 +284,7 @
<varlistentry id="file-new-submenu">
<term><menuchoice>
<guimenu>File</guimenu>
-<guimenuitem>New Submenu</guimenuitem>
+<guimenuitem>New Submenu...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Adds new submenu.</action></para></listitem>
</varlistentry>
@ -351,6 +363,7 @
<varlistentry id="edit-delete">
<term><menuchoice>
+<shortcut><keycap>Delete</keycap></shortcut>
<guimenu>Edit</guimenu> <guimenuitem>Delete</guimenuitem>
</menuchoice></term>
<listitem><para><action>Deletes currently selected menu
@ -360,9 +373,9 @
<varlistentry id="settings-hide-toolbar">
<term><menuchoice>
<guimenu>Settings</guimenu>
-<guimenuitem>Hide Toolbar</guimenuitem>
+<guimenuitem>Show/Hide Toolbar</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Hide the toolbar</action></para></listitem>
+<listitem><para><action>Show or hide the toolbar</action></para></listitem>
</varlistentry>
<varlistentry id="settings-configure-shortcuts">
@ -476,8 +489,8 @
the &kde;.</para>
<para>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
+&kde;-compliant applications.Simply mark the text in the console
+application with your mouse, switch to the &kde;-compliant application
and press <keycombo action="simul">&Ctrl;
<keycap>V</keycap></keycombo> to paste the text. If you want to copy
from &kde; application to a console application, first mark the text
More information about the kde-doc-english
mailing list