[user-guide] Add KDE managing Software.

FORLOT Romain rforlot at fedoraproject.org
Sun Mar 18 19:36:26 UTC 2012


commit 1aa0fefdc5e95668cedabf010b6238a9432b87cd
Author: FORLOT Romain <rforlot at yahoo.com>
Date:   Sun Mar 18 19:54:07 2012 +0100

    Add KDE managing Software.

 en-US/Managing_software.xml |   94 ++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 92 insertions(+), 2 deletions(-)
---
diff --git a/en-US/Managing_software.xml b/en-US/Managing_software.xml
index 5b640a3..c0c4e95 100644
--- a/en-US/Managing_software.xml
+++ b/en-US/Managing_software.xml
@@ -16,7 +16,7 @@
 			To start <application>PackageKit</application> in the KDE environment, click <menuchoice><guimenu>KMenu</guimenu><guisubmenu>Applications</guisubmenu><guisubmenu>System</guisubmenu><guisubmenu>Software Management</guisubmenu></menuchoice>. This starts the <command>kpackagekit</command> application. The KDE <application>Software Management</application> browse section works similar to a file browser and contains descriptions of the applications. The application uses <guibutton>install</guibutton> and <guibutton>remove</guibutton> buttons and there is a <guibutton>Help</guibutton> icon in the bottom left corner if you need additional assistance.
 		</para>
 
-		<section id="sect-User_Guide-Using_PackageKit-Installing_software">
+		<section id="sect-User_Guide-Using_PackageKit-Installing_software_in_GNOME">
 			<title>Installing Software in GNOME</title>
 			<para>
 				Here is how to install software using <application>Add/Remove Software</application> in the GNOME desktop environment.
@@ -41,7 +41,7 @@
 			</para>
 		</section>
 		
-		<section id="sect-User_Guide-Using_PackageKit-Removing_software">
+		<section id="sect-User_Guide-Using_PackageKit-Removing_software_in_GNOME">
 			<title>Removing software in GNOME</title>
 			<para>
 				To remove software using <application>PackageKit</application>, you should follow the standard installation procedure, but untick boxes beside the programs you wish to uninstall instead of ticking boxes to install new programs.
@@ -67,6 +67,96 @@
 			</para>
 		</section>
 
+                <section id="sec-User_Guide-Using_PackageKit-Installing_software_in_KDE">
+                    <title>Installing  Software in KDE</title>
+                    <para>
+                        PackageKit implementation for KDE is accessible by <application>Software Management</application> under <guilabel>System Administration</guilabel> section in <application>System Setting</application>. You can also launch it by calling <application>apper</application> upon command line. This application may help you to configure software repository too. Refer to inserthere.
+                    </para>
+                    <para>
+                        There is a search field at the top of windows, allowing you to search package that you want install. You can change search criteria using <guibutton>Filters</guibutton> and the mode with arrow of the <guibutton>Find by name</guibutton> button which is default mode of search.
+                    </para>
+                    <para>Type <keycap>Enter</keycap> or click on <guibutton>Find by name</guibutton> (or whatever you choose if you change search mode). This bring result of search, there are ticked packages meaning this package is already installed and unticked packages for those which are not. <mousebutton>Left</mousebutton> click on a package to display its description and appears an <guibutton>Install</guibutton> on line of selected package. Use this button to mark it to install. 
+                    </para>
+                    
+                    <para>
+                        Then it is possible to mark several packages to install, even across multiple successive search. At any moment, use <guibutton>Pending Changes</guibutton> to see what packages you have selected and which action for each of them.
+                    </para>
+
+                    <para>
+                        Rather than use search, packages are splitted into differents <guilabel>Categories </guilabel>, which are :
+                        <itemizedlist mark='bullet'>
+                            <listitem>
+                                <para>
+                                    <guiicon>Application</guiicon> : Avoid listing libraries packages and only present final application packages.
+                                </para>
+                            </listitem>
+                            <listitem>
+                                <para>
+                                    <guiicon>Base System</guiicon> : Contains all packages related to primary needed packages like <guiicon>X Window System</guiicon>, <guiicon>Hardware Support</guiicon>, <guiicon>Administration Tools</guiicon>...
+                                </para>
+                            </listitem>
+                            <listitem>
+                                <para>
+                                    <guiicon>Content</guiicon> : Contains book and guides.
+                                </para>
+                            </listitem>
+                            <listitem>
+                                <para>
+                                    <guiicon>Desktop Environments</guiicon> : Most importants Desktop is listed here and every related packages into sub-categories for each one.
+                                </para>
+                            </listitem>
+                            <listitem>
+                                <para>
+                                    <guiicon>Development</guiicon> : All related development ressources are here.
+                                </para>
+                            </listitem>
+                            <listitem>
+                                <para>
+                                    <guiicon>Languages</guiicon> : Localization packages for your fedora.
+                                </para>
+                            </listitem>
+                            <listitem>
+                                <para>
+                                    <guiicon>Servers</guiicon> : Listing of servers services.
+                                </para>
+                            </listitem>
+                            <listitem>
+                                <para>
+                                    <guiicon>Software Sources</guiicon> : List packages by sources installed.
+                                </para>
+                            </listitem>
+                        </itemizedlist>
+                    </para>
+
+                    <para>
+                        Once all wanted packages if selected, launch the install process by clicking on <guibutton>Apply</guibutton> button. Follow any prompts to install additional packages.
+                    </para>
+
+		    <para>
+	        	Unless an error is displayed, the application is now installed (or removed) on your computer.
+        	    </para>
+                </section>
+
+                <section id="sec-User_Guide-Using_PackageKit-Removing_software_in_KDE">
+                    <title>Removing Software in KDE</title>
+                    <para>
+                        To remove a software using KDE <application>Software Management</application>, you have to click on <guibutton>Remove</guibutton> button of selected software. <guibutton>Remove</guibutton> button is accessible, if software is installed, wherever you are in <application>Software Management</application> : search results, categories listing, etc. But there is an useful shortcut, called <guiicon>Installed Software</guiicon>, which lists you all installed softwares on your system.
+                    </para>
+			<note>
+				<title>Software Installed Outside of PackageKit</title>
+				<para>
+					If the box is already unticked, then the program is probably not already installed. If you are sure that you have selected the right application, but it still appears to not be installed, then it may have been installed using a method other than <application>PackageKit</application>. If, for example, the program was compiled and installed from source, then it may not register as installed in <application>PackageKit</application>. If this is the case, you will need to find an alternate method of removing it. If it was installed from source, you may find more information in the source distribution's <filename>Readme</filename> file.
+				</para>
+			</note>
+
+                        <para>As always, you can see selected actions by using <guibutton>Pending Changes</guibutton> button. Once, you selected all softwares you want to remove, click on <guiicon>Apply</guiicon>. Follow any prompts to remove additional packages, such as dependencies that only your newly uninstalled program relied upon.
+                        </para>
+
+		    <para>
+	        	Unless an error is displayed, the application is now installed (or removed) on your computer.
+        	    </para>
+                </section>
+
 	</section>
 	
 	<section id="sect-User_Guide-Managing_software-Using_the_command_line_interface">


More information about the docs-commits mailing list