3) "remembering konsole is case sensitive"

It's not konsole, it's the command interpreter (bash) that cares about upper and lower case.

4) After pressing Tab, konsole will try to guess the name of 
the program you wish to launch. 

Again, it's not konsole that does autocompletion, it's the command interpreter. If you run e.g. tcsh in konsole, autocompletion won't work anymore.

I agree that from the user's point of view, it makes little difference which program does what, but nethertheless it's not a reason for mixing up things.

5) "In almost every KDE program you will find a File => Open"

"Open" should be replaced with "Open...".

Created attachment 14046 [details]
Patch for the suggested changes

Thank you very much; your help is much appreciated.

Thank you very much for your very quick answer and for the patch
to the source docbook file, which I suppose will be applied very soon.

And happy new year! :-)

SVN commit 491775 by annma:

apply patch for bug 119051
CCBUG=119051


 M  +9 -9      programs-and-documents.docbook  


--- branches/KDE/3.5/kdebase/doc/userguide/programs-and-documents.docbook #491774:491775
@@ -41,7 +41,7 @@
 <para>Launchers to programs may also be placed on the desktop. To create a
 new launcher, <mousebutton>right</mousebutton> click on the desktop, and
 choose <menuchoice><guimenu>Create
-New</guimenu><guisubmenu>File</guisubmenu><guimenuitem>Link to
+New</guimenu><guimenuitem>Link to
 Application</guimenuitem></menuchoice>. On the &kdesktop; properties dialog
 box, type in the name of the program on the <guilabel>General</guilabel>
 tab. You may also wish to choose a custom icon by clicking on the gear icon.
@@ -50,24 +50,24 @@
 <guilabel>Command</guilabel> textbox, type the name of the program (case
 sensitive), and any command line options you wish to use. Choose
 <guibutton>OK</guibutton>, and your new program launcher will be created on
-your desktop. Just double click the new launcher on the desktop and the
-associated program will run.</para>
+your desktop.  Simply click on the new launcher on the desktop and the
+ associated program will run.</para>
 
 <para>To launch a program using &konsole;, click the &kmenu; and choose
 <menuchoice><guisubmenu>System</guisubmenu><guisubmenu>Terminals
 </guisubmenu><guimenuitem>Konsole</guimenuitem></menuchoice>. Once &konsole;
 appears on the screen, simply type the name of the program you wish to
-launch (remembering &konsole; is case sensitive) and press
+launch ((remembering that <application>bash</application>, the command language interpreter that &konsole; uses, is case-sensitive) and press
 <keycap>Enter</keycap>. If you are unsure about the name of a program, type
 the first few letters then press the &Tab; key on your keyboard. By pressing
-&Tab;, &konsole; will try to guess the name of the program you wish to
-launch. If &konsole; finds more then one matching program, a list of
-matching programs will be printed on the screen. Type the name of the
-program from the list and press <keycap>Enter</keycap> to launch.</para>
+&Tab;, <application>bash</application> (through &konsole;) will try to guess the name of the program you wish to
+launch. If it finds more then one matching program, a list of
+ matching programs will be printed on the screen. Type the name of the
+ program from the list and press <keycap>Enter</keycap> to launch.</para>
 
 <para>Whichever way you choose, launching a program is a simple affair with
 &kde;. From the &kmenu;, to &konsole;, all your programs are just a few
-clicks or key presses away.</para>
+clicks or key-presses away.</para>
 
 <!-- Add links to "further reading" here -->
 <itemizedlist>

For future reference: don't close the bug report until the patch *is* applied.

OK, will do that next time, thanks for telling.

I am reopening this bug report because I have detected other problems with this document:

6) "Konqueror has four toolbars, Main, Extra, Location and Bookmark."

I have counted twelve toolbars (!). If this count is correct, then the sentence should either be rephrased, or another example than Konqueror should be used.

7) "Something about Settings => Configure Notifications..."

This placeholder should be replaced with real content. Please apologize if you have already planned to do so.

8) I suspect that many <guimenuitem>s lack the "...". I have not  systematically checked though.

9) "To do so, click on the Settings menu, choose Toolbars, and then uncheck the Bookmark Toolbar entry (do this just by clicking on the menu item)."

First, there is no "Bookmark" toolbar in Konqueror at my place (KDE 3.4.2b).

Second, that does not work at my place. The only way to deactivate a whole menu bar is to right-click on this menu bar, choose Toolbars in the context menu that appears, and then uncheck the correct entry. The Toolbars menu does not seem to allow to deactivate the whole toolbar, I was only able to use it to fine-tune the toolbar contents.

Please ignore latest paragraph. I mixed up the menus.

Still, there is no "Bookmarks" toolsbar at my place.

10) "Its orientation, so that instead of appearing at the top of the window under the menu bar you can place it on the left, right or bottom of the window."

The "Orientation" menu now also allows to make the toolbar float, or to minimize it.

Ah, OK, the two additional "orientations" are explaned later on. That's a bit strange though. Minimizing and floating are not really "orientations". But I suppose it's a rather a GUI issue than a documentation issue.

11) "Its orientation, so that the toolbar is squashed into a little flat grip that you can re-open by double-clicking on it"

Clicking only once is enough in my version of KDE.

12) "To restore the defalt toolbar layout"

This one is just a typo. Replace with "defaut".

This documentation seems to have improved significantly in the intervening years.  Please let us know if you see anything else wrong with it.