Merge lp:~littlergirl/kubuntu-docs/contribute into lp:kubuntu-docs/precise

Proposed by Little Girl
Status: Merged
Approved by: Jonathan Jesse
Approved revision: 262
Merge reported by: Jonathan Jesse
Merged at revision: not available
Proposed branch: lp:~littlergirl/kubuntu-docs/contribute
Merge into: lp:kubuntu-docs/precise
Diff against target: 829 lines (+241/-182)
3 files modified
docs/basics/C/basics.xml (+27/-28)
docs/contribute/C/contribute.xml (+98/-58)
docs/manage-software/C/manage-software.xml (+116/-96)
To merge this branch: bzr merge lp:~littlergirl/kubuntu-docs/contribute
Reviewer Review Type Date Requested Status
Jonathan Jesse (community) Approve
Review via email: mp+98080@code.launchpad.net

Description of the change

* Corrected grammar and punctuation.
* Updated some links and instructions.

To post a comment you must log in.
Revision history for this message
Jonathan Jesse (jjesse) wrote :

Thanks of rthe changes and the merge request. Please continue to do so. Merging this request

review: Approve
Revision history for this message
Jonathan Jesse (jjesse) wrote :

Merged thanks for the review and please submit more, committed to lp:kubuntu-docs revision 260

review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
=== modified file 'docs/basics/C/basics.xml'
--- docs/basics/C/basics.xml 2011-09-14 08:01:10 +0000
+++ docs/basics/C/basics.xml 2012-03-18 00:38:31 +0000
@@ -40,19 +40,18 @@
40</para>40</para>
41</note>41</note>
42<para>42<para>
43A filesystem is a method of storing and organizing files, not only in Linux43A filesystem is a method of storing and organizing files &mdash; not only in
44but also in other computer operating systems. In Linux, most files are44Linux, but also in other computer operating systems. In Linux, most files are
45<quote>regular files</quote>, except <emphasis>directories</emphasis>,45<quote>regular files</quote>, except <emphasis>directories</emphasis>,
46<emphasis>special files</emphasis>, <emphasis>links</emphasis>,46<emphasis>special files</emphasis>, <emphasis>links</emphasis>,
47<emphasis>sockets</emphasis>, and <emphasis>named pipes</emphasis>. The most47<emphasis>sockets</emphasis>, and <emphasis>named pipes</emphasis>. The most
48common filetypes that users interact with are regular files, directories and48common filetypes that users interact with are regular files, directories, and
49links.49links.
50</para>50</para>
51<para>51<para>
52Opening a terminal (in &kubuntu; this is52Opening a terminal (in &kubuntu; this is called
53called <application>Konsole</application>) and typing53<application>Konsole</application>) and typing
54<screen>ls /</screen>54<screen>ls /</screen> brings up a list similar to the following:
55brings up a list similar to the following:
56<screen>55<screen>
57bin56bin
58boot57boot
@@ -114,10 +113,10 @@
114<para>113<para>
115A <abbrev>symlink</abbrev> or <quote>symbolic link</quote> to <filename114A <abbrev>symlink</abbrev> or <quote>symbolic link</quote> to <filename
116class="directory">/media/cdrom</filename>, which itself is a115class="directory">/media/cdrom</filename>, which itself is a
117<abbrev>symlink</abbrev> to <filename116<abbrev>symlink</abbrev> to <filename
118class="directory">/media/cdrom0</filename>. If a <acronym>CD</acronym> is placed117class="directory">/media/cdrom0</filename>. If a <acronym>CD</acronym> is placed
119into the <acronym>CDROM</acronym> drive, the contents of that CD will be118into the <acronym>CDROM</acronym> drive, the contents of that CD will be
120available in <filename class="directory">/media/cdrom0</filename> directory.119available in the <filename class="directory">/media/cdrom0</filename> directory.
121</para>120</para>
122</listitem>121</listitem>
123</varlistentry>122</varlistentry>
@@ -133,8 +132,8 @@
133<varlistentry><term><filename class="directory">etc</filename></term>132<varlistentry><term><filename class="directory">etc</filename></term>
134<listitem>133<listitem>
135<para>134<para>
136Contains all system-related configuration files, used to control135Contains all system-related configuration files used to control the
137the operation of programs.136operation of programs.
138</para>137</para>
139</listitem>138</listitem>
140</varlistentry>139</varlistentry>
@@ -142,8 +141,8 @@
142<listitem>141<listitem>
143<para>142<para>
144Contains a home directory for each user on the system. A user's home directory143Contains a home directory for each user on the system. A user's home directory
145can contain personal configuration files and files such as documents, music,144can contain personal configuration files, documents, music, videos, and other
146video, and other user-defined directories and files.145user-defined directories and files.
147</para>146</para>
148</listitem>147</listitem>
149</varlistentry>148</varlistentry>
@@ -158,8 +157,8 @@
158<varlistentry><term><filename class="directory">lib</filename></term>157<varlistentry><term><filename class="directory">lib</filename></term>
159<listitem>158<listitem>
160<para>159<para>
161Contains the kernel modules in addition to shared library images needed to boot160Contains the kernel modules and shared library images needed to boot the
162the system and run commands.161system and run commands.
163</para>162</para>
164</listitem>163</listitem>
165</varlistentry>164</varlistentry>
@@ -182,7 +181,7 @@
182<varlistentry><term><filename class="directory">lost+found</filename></term>181<varlistentry><term><filename class="directory">lost+found</filename></term>
183<listitem>182<listitem>
184<para>183<para>
185Contains the results of any recovery operation due to an improper shutdown of184Contains the results of any recovery operation due to an improper shut-down of
186the system or a system crash.185the system or a system crash.
187</para>186</para>
188</listitem>187</listitem>
@@ -190,7 +189,7 @@
190<varlistentry><term><filename class="directory">media</filename></term>189<varlistentry><term><filename class="directory">media</filename></term>
191<listitem>190<listitem>
192<para>191<para>
193Contains the subdirectories which are used as mount points for removable media192Contains the subdirectories which are used as mount points for removable media,
194such as <acronym>CDROM</acronym> drives, <acronym>USB</acronym> disks, floppy193such as <acronym>CDROM</acronym> drives, <acronym>USB</acronym> disks, floppy
195disks.194disks.
196</para>195</para>
@@ -200,7 +199,7 @@
200<listitem>199<listitem>
201<para>200<para>
202Generic mount point for filesystems or devices. In most cases, <filename201Generic mount point for filesystems or devices. In most cases, <filename
203class="directory">/media</filename> is where most devices will be automounted.202class="directory">/media</filename> is where most devices will be auto-mounted.
204</para>203</para>
205</listitem>204</listitem>
206</varlistentry>205</varlistentry>
@@ -239,7 +238,7 @@
239<varlistentry><term><filename class="directory">selinux</filename></term>238<varlistentry><term><filename class="directory">selinux</filename></term>
240<listitem>239<listitem>
241<para>240<para>
242A pseudo-filesystem containing the commands used by the kernel subsystem for the241A pseudo-filesystem containing the commands used by the kernel sub-system for the
243Security-Enhanced Linux feature.242Security-Enhanced Linux feature.
244</para>243</para>
245</listitem>244</listitem>
@@ -270,7 +269,7 @@
270<listitem>269<listitem>
271<para>270<para>
272Contains the largest share of data on the system, including read-only user271Contains the largest share of data on the system, including read-only user
273data, as well as files and programs and such as program binaries, documentation,272data, as well as files and programs, such as program binaries, documentation,
274libraries, header files, and more.273libraries, header files, and more.
275</para>274</para>
276</listitem>275</listitem>
@@ -278,7 +277,7 @@
278<varlistentry><term><filename class="directory">var</filename></term>277<varlistentry><term><filename class="directory">var</filename></term>
279<listitem>278<listitem>
280<para>279<para>
281Contains variable data such as system log files, mail and printer spool280Contains variable data, such as system log files, mail and printer spool
282directories, as well as transient and temporary files.281directories, as well as transient and temporary files.
283</para>282</para>
284</listitem>283</listitem>
@@ -300,7 +299,7 @@
300Since Linux is a true multi-user system, the principles of both299Since Linux is a true multi-user system, the principles of both
301<emphasis>users</emphasis> and <emphasis>groups</emphasis> are important to the300<emphasis>users</emphasis> and <emphasis>groups</emphasis> are important to the
302internal operation of the system, and also to the day-to-day use of the system.301internal operation of the system, and also to the day-to-day use of the system.
303Linux handling of users and groups is the reason it is one of the most secure302The way Linux handles users and groups makes it one of the most secure
304operating systems.303operating systems.
305</para>304</para>
306<sect2 id="users">305<sect2 id="users">
@@ -319,7 +318,7 @@
319<para>318<para>
320<emphasis role="strong">Logical Users</emphasis> are not tied to a person, but319<emphasis role="strong">Logical Users</emphasis> are not tied to a person, but
321instead are tied to a system function that are used by applications to perform320instead are tied to a system function that are used by applications to perform
322specific tasks. Daemons, mail, news are examples of logical users.321specific tasks. Daemons, mail, and news are examples of logical users.
323</para>322</para>
324</listitem>323</listitem>
325</itemizedlist>324</itemizedlist>
@@ -328,9 +327,9 @@
328<title>Groups</title>327<title>Groups</title>
329<para>328<para>
330Groups are logical expressions of organization. They tie users together and329Groups are logical expressions of organization. They tie users together and
331provide group-based, rather than user-based permissions. Common groups330provide group-based, rather than user-based, permissions. Common groups
332include <emphasis>admin</emphasis>,331include <emphasis>admin</emphasis>,
333<emphasis>audio</emphasis>, <emphasis>mail</emphasis>.332<emphasis>audio</emphasis>, and <emphasis>mail</emphasis>.
334</para>333</para>
335</sect2>334</sect2>
336</sect1>335</sect1>
@@ -417,8 +416,8 @@
417</entry>416</entry>
418<entry>417<entry>
419<emphasis role="strong">rwx</emphasis> - <emphasis>read</emphasis>,418<emphasis role="strong">rwx</emphasis> - <emphasis>read</emphasis>,
420<emphasis>write</emphasis> and <emphasis>execute</emphasis> permissions for the419<emphasis>write</emphasis>, and <emphasis>execute</emphasis> permissions
421user.420for the user.
422</entry>421</entry>
423<entry>422<entry>
424<emphasis role="strong">r-x</emphasis> - <emphasis>read</emphasis> and423<emphasis role="strong">r-x</emphasis> - <emphasis>read</emphasis> and
@@ -503,7 +502,7 @@
503<listitem>502<listitem>
504<para>503<para>
505<keycombo><keycap>Ctrl</keycap><keycap>Esc</keycap></keycombo> - Starts504<keycombo><keycap>Ctrl</keycap><keycap>Esc</keycap></keycombo> - Starts
506&kde;&apos; <application>s System Activity</application> dialog where processes505&kde;&apos;s <application>System Activity</application> dialog where processes
507can be viewed and killed.506can be viewed and killed.
508</para>507</para>
509</listitem>508</listitem>
510509
=== modified file 'docs/contribute/C/contribute.xml'
--- docs/contribute/C/contribute.xml 2011-09-14 10:02:12 +0000
+++ docs/contribute/C/contribute.xml 2012-03-18 00:38:31 +0000
@@ -9,11 +9,11 @@
9]>9]>
10<article id="contribute">10<article id="contribute">
11<articleinfo>11<articleinfo>
12<title>Contributing To The &kubuntu; Project</title>12<title>Contributing To The Kubuntu Project</title>
13&legalnotice;13&legalnotice;
14<abstract>14<abstract>
15<para>15<para>
16This document is about how you can help Kubuntu and get involved in the community.16This document is about how you can help &kubuntu; and get involved in the community.
17</para>17</para>
18</abstract>18</abstract>
19</articleinfo>19</articleinfo>
@@ -22,10 +22,12 @@
22<title>Introduction</title>22<title>Introduction</title>
2323
24<para>24<para>
25The Kubuntu community is individuals and teams working to package the software, test it, do bug triaging and then promoting Kubuntu to a wider audience. All of the software, artwork and documentation has been created, tested, 25The &kubuntu; community is made up of individuals and teams working to package
26used and discussed openly by people around the world participating in the Open Source 26the software, test it, triage bugs, and then promote &kubuntu; to a wider
27community made possible by the Internet. So we invite you to help shape Kubuntu to better 27audience. All of the software, artwork, and documentation has been created,
28meet your needs. 28tested, used, and discussed openly by people around the world participating in
29the Open Source community made possible by the Internet. We invite you to help
30shape &kubuntu; to better meet your needs.
29</para>31</para>
30</sect1>32</sect1>
3133
@@ -33,41 +35,53 @@
33<title> Spreading the word </title>35<title> Spreading the word </title>
3436
35<para>37<para>
36The easiest way to give back to the Kubuntu community is by sharing Kubuntu with others. Recommend 38The easiest way to give back to the &kubuntu; community is by sharing &kubuntu;
37Kubuntu to others, and show them how to download and install Kubuntu, and the possibilities and 39with others. Recommend &kubuntu; to others, show them how to download and
38qualities of Open Source Software. As our community grows, it becomes more accepted and40install it, and discuss the possibilities and qualities of Open Source Software
39supported. Here are some of the steps you can take:41with them. As our community grows, it becomes more accepted and supported. Here
42are some of the steps you can take:
40</para>43</para>
41<procedure>44<procedure>
42<step>45<step>
43<para>46<para>
44Give a talk at your local school, Linux User Group or library on Kubuntu. There are lots of 47Give a talk on &kubuntu; at your local school, Linux User Group, or library.
45notes from previous talks given by others in several languages available on the wiki.48There are lots of notes from previous talks given by others in several
46</para>49languages available in the wiki.
47</step>50</para>
48<step>51</step>
49<para>52<step>
50Get CDs by downloading the iso from <ulink url="http://www.kubuntu.org/getkubuntu/download">GetKubuntu</ulink> and then burn them (or create a LiveUSB) then distribute them to people who might be interested. Drop them off at libraries, Internet Cafes, schools, computer shops or anywhere else where people use computers. Please help people to use and understand Kubuntu if they approach you for help.53<para>
51</para>54Get CDs by downloading the iso from <ulink
52</step>55url="http://www.kubuntu.org/getkubuntu/download">GetKubuntu</ulink> and burning
53<step>56it to blank CDs (or create a LiveUSB). Then distribute them to people who might
54<para>57be interested, drop them off at libraries, Internet cafes, schools, computer
55Join or start a Local Community Team and discuss the possibilities that Kubuntu brings up. If you 58shops, or anywhere else where people use computers. Please help people to use
56like Kubuntu it is likely that others around you will try it, and like it as well! See the "Going Local!" section for details.59and understand &kubuntu; if they approach you for help.
60</para>
61</step>
62<step>
63<para>
64Join or start a Local Community Team and discuss the possibilities that
65&kubuntu; brings up. If you like &kubuntu;, it is likely that others around you
66will try it and like it as well!
57</para>67</para>
58</step>68</step>
59</procedure>69</procedure>
60</sect1>70</sect1>
6171
62<sect1 id="loco" status="complete">72<sect1 id="loco" status="complete">
63<title> Local Teams </title>73<title>Local Teams</title>
6474
65<para>75<para>
66If you want to meet other Kubuntu users in your area, look for a Local Ubuntu Community team 76If you want to meet other &kubuntu; users in your area, look for a Local Ubuntu
67(LoCo team for short) to join. There are LoCo teams spread out all over the world, and you can find the directory <ulink url="http://loco.ubuntu.com/">here</ulink>. If there isn't a 77Community team (LoCo team for short) to join. There are LoCo teams spread out
68LoCo team near you, you can start a new one! Just follow the instructions <ulink url="https://wiki.ubuntu.com/LoCoTeamHowto"> on the wiki</ulink>. To get more 78all over the world, and you can find the directory <ulink
69information you can join your local LoCo Team mailing list and IRC channel. Details can be found on 79url="http://loco.ubuntu.com/">here</ulink>. If there isn't a LoCo team near
70the LoCoTeam List wiki page.80you, you can start a new one! Just follow the instructions <ulink
81url="https://wiki.ubuntu.com/LoCoTeamHowto">on the wiki</ulink>. To get more
82information you can join your local LoCo Team mailing list and IRC channel.
83Details can be found on the <ulink
84url="http://loco.ubuntu.com/teams/">LoCoTeam List</ulink> wiki page.
71</para>85</para>
72</sect1>86</sect1>
7387
@@ -75,34 +89,44 @@
75<title> Translating Kubuntu </title>89<title> Translating Kubuntu </title>
7690
77<para>91<para>
78If your home language is not English but you have excellent English skills and are 92If your home language is not English, but you have excellent English skills
79comfortable using software in English, you help to translate the Kubuntu applications and documentation 93and are comfortable using software in English, you can help to translate the
80into your native language. To help out:94&kubuntu; applications and documentation into your native language. To help
95out:
81</para>96</para>
82<procedure>97<procedure>
83<step>98<step>
84<para>99<para>
85Using the web-based <ulink url="https://launchpad.net/ubuntu/+translations">Rosetta translation system</ulink> makes it easy to translate Ubuntu applications into your language. Even if you just translate a few lines you may 100Using the web-based <ulink
86make all the difference to someone in your own country who is just starting to learn about 101url="https://launchpad.net/ubuntu/+translations">Rosetta translation
102system</ulink> makes it easy to translate Ubuntu applications into your
103language. Even if you just translate a few lines you may make all the
104difference to someone in your own country who is just starting to learn about
87computers and Free Software.105computers and Free Software.
88</para>106</para>
89</step>107</step>
90<step>108<step>
91<para>109<para>
92Translate popular wiki pages within the <ulink url="https://help.ubuntu.com/community">Documentation Wiki</ulink>.110Translate popular wiki pages within the <ulink
111url="https://help.ubuntu.com/community">Documentation Wiki</ulink>.
93</para>112</para>
94</step>113</step>
95<step>114<step>
96<para>115<para>
97Test that your local language fonts and display works correctly. If they don't, file bug 116Test that your local language fonts and display work correctly. If they don't,
98reports on the issues. 117file bug reports on the issues. For more information on filing bug reports, see
118<ulink type="help" url="help:/kubuntu/bugs/">Bugs</ulink>.
99</para>119</para>
100</step>120</step>
101</procedure>121</procedure>
102<para>122<para>
103You can join your local LoCo Team mailing list and IRC channel (details can be 123You can join your local LoCo Team mailing list and IRC channel (details can be
104found on <ulink url="https://wiki.ubuntu.com/LoCoTeams"> the LoCoTeam List wiki page</ulink>) to get in touch with other users in your region so you can 124found on the <ulink url="https://wiki.ubuntu.com/LoCoTeams">LoCoTeam</ulink>
105coordinate your translation efforts. Also <ulink url="https://lists.ubuntu.com/mailman/listinfo/ubuntu-translators"> join the Ubuntu-Translators mailing list</ulink> to stay in touch with other Ubuntu translators. 125wiki page) to get in touch with other users in your region so you can
126coordinate your translation efforts. Another option is to stay in touch with
127other Ubuntu translators by joining the <ulink
128url="https://lists.ubuntu.com/mailman/listinfo/ubuntu-translators">Ubuntu-Translators
129mailing list</ulink>.
106</para>130</para>
107</sect1>131</sect1>
108132
@@ -110,33 +134,49 @@
110<title> Writing Documentation </title>134<title> Writing Documentation </title>
111135
112<para>136<para>
113If you get stumped by a problem, chances are that others might have had it or are currently 137If you get stumped by a problem, chances are that others might have had it or
114experiencing it. If you are not currently able to write code to fix the problem, you can help everyone 138are currently experiencing it. If you are not currently able to write code to
115else out by documenting the solution. All documentation and help pages in Kubuntu are written by 139fix the problem, you can help everyone else out by documenting the solution.
116volunteer community members gathered in the Kubuntu Documentation Team, and you can help out in a number 140All documentation and help pages in &kubuntu; are written by volunteer
117of ways:141community members gathered in the Kubuntu Documentation Team, and you can help
142out in a number of ways:
118</para>143</para>
119<procedure>144<procedure>
120<step>145<step>
121<para>146<para>
122Check the existing documentation to see if it covers your problem. If it does, you can add to it, edit 147Check the existing documentation to see if it covers your problem. If it does,
123it or remove errors (such as typos, grammar and spelling, and technical errors), and send any suggestions 148you can add to it, edit it, or remove errors (such as typos, grammar, spelling,
124and changes to the Documentation Team mailing list. For more information about how to help, see <ulink url="https://wiki.kubuntu.org/Kubuntu/Documentation">Kubuntu Documentation</ulink>.149and technical errors), and send any suggestions and changes to the
125</para>150Documentation Team mailing list. For more information about how to help, see
126</step>151<ulink url="https://wiki.kubuntu.org/Kubuntu/Documentation">Kubuntu
127<step>152Documentation</ulink>.
128<para>153</para>
129If no relevant documentation exists, you can add a page in the <ulink url="https://help.ubuntu.com/community"> Documentation Wiki</ulink> which is a separate community wiki for editing and writing documentation. Rather than answer a question two or more times, write up the answer and make it available to everyone in the wiki.154</step>
130</para>155<step>
131</step>156<para>
132<step>157If no relevant documentation exists, you can add a page in the <ulink
133<para>158url="https://help.ubuntu.com/community">Documentation Wiki</ulink>, which is a
134Read through the documentation in the Ubuntu Forums and <ulink url="http://www.kubuntuforums.net/"> Kubuntuforum</ulink> and check them for accuracy, then put them in the Documentation Wiki.159separate community wiki for editing and writing documentation. Rather than
160answer a question two or more times, write up the answer and make it available
161to everyone in the wiki.
162</para>
163</step>
164<step>
165<para>
166Read through the documentation in the <ulink
167url="http://ubuntuforums.org/">Ubuntu Forums</ulink> and <ulink
168url="http://www.kubuntuforums.net/">Kubuntu Forums</ulink> and check them for
169accuracy, then put them in the <ulink
170url="https://help.ubuntu.com/community">Documentation Wiki</ulink>.
135</para>171</para>
136</step>172</step>
137</procedure>173</procedure>
138<para> 174<para>
139To get in touch with the Documentation Team you can <ulink url="http://lists.ubuntu.com/mailman/listinfo/ubuntu-doc"> join the Documentation team mailing list</ulink> and also the #ubuntu-doc IRC channel on irc.freenode.net. For Kubuntu Documentation specifically, please talk to Darkwingduck or jjesse in #kubuntu-devel, also on Freenode.175To get in touch with the Documentation Team you can <ulink
176url="http://lists.ubuntu.com/mailman/listinfo/ubuntu-doc">join the
177Documentation team mailing list</ulink> and also the #ubuntu-doc IRC channel on
178irc.freenode.net. For Kubuntu Documentation, specifically, please talk to
179Darkwing or jjesse in #kubuntu-devel, also on irc.freenode.net.
140</para>180</para>
141</sect1>181</sect1>
142</article>182</article>
143183
=== modified file 'docs/manage-software/C/manage-software.xml'
--- docs/manage-software/C/manage-software.xml 2011-09-15 09:28:29 +0000
+++ docs/manage-software/C/manage-software.xml 2012-03-18 00:38:31 +0000
@@ -68,10 +68,10 @@
68add software repositories.68add software repositories.
69</para>69</para>
70<para>70<para>
71The software that comprises &kubuntu; is being improved continuously. With an71The software that comprises &kubuntu; is being continuously improved. With an
72Internet connection and &kubuntu; software updating, the latest improvements and72Internet connection and &kubuntu; software updating, the latest improvements and
73security fixes can be applied to a system easily. This document explains how to73security fixes can easily be applied to a system. This document explains how to
74perform update. 74perform updates.
75</para>75</para>
76</sect1>76</sect1>
7777
@@ -88,58 +88,58 @@
88<para> 88<para>
89Install new software with the following steps:89Install new software with the following steps:
90</para>90</para>
91
91<procedure>92<procedure>
92<step>93<step>
93<para>94<para>
94Start Muon with &menusysmuon;.95Start <application>Muon</application> with &menusysmuon;.
95</para>96</para>
96</step>97</step>
97
98<step>98<step>
99<para>99<para>
100Search for the application with the search box and filters at the top of the100Search for the application with the search box and filters at the top of the
101window.101window.
102</para>102</para>
103</step>103</step>
104
105<step>104<step>
106<para>105<para>
107The application will show up in the large white space below the search area.106The application will show up in the large white space below the search area.
108Click on the application title to be installed. 107Click on the application title to be installed.
109Click <guilabel>Install</guilabel> to start the108Click <guilabel>Install</guilabel> to start the installation process.
110installation process.
111</para>109</para>
112</step>110</step>
113
114<step>111<step>
115<para>112<para>
116Muon might provide information about required dependencies. Acknowledge113<application>Muon</application> might provide information about required
117this information, and the required packages will begin downloading. When the114dependencies. Once this information is acknowledged, the required packages will
118installation process is complete, the software will be ready to use. It is115begin downloading. When the installation process is complete, the software will
119rarely necessary to restart the system after software installation or update.116be ready to use. It is rarely necessary to restart the system after software
117installation or updates.
120</para>118</para>
121</step>119</step>
122</procedure>120</procedure>
121
123<para> 122<para>
124Muon provides an easy method to remove the software that is no longer123<application>Muon</application> provides an easy method to remove the software
125needed. To remove an application:124that is no longer needed. To remove an application:
126</para>125</para>
126
127<procedure>127<procedure>
128<step>128<step>
129<para>129<para>
130Start Muon with &menusysmuon;.130Start <application>Muon</application> with &menusysmuon;.
131</para>131</para>
132</step>132</step>
133133<step>
134<step>134<para>
135<para>135Click on <guimenu>Installed Software</guimenu> and find the application you
136Click on <guimenu>Installed Software</guimenu> and find the application you want removed.136want to remove.
137</para>137</para>
138</step>138</step>
139139<step>
140<step>140<para>
141<para>141Click <guilabel>Remove</guilabel> and <application>Muon</application> will
142Click <guilabel>Remove</guilabel> and Muon will remove the application.142remove the application.
143</para>143</para>
144</step>144</step>
145</procedure>145</procedure>
@@ -151,7 +151,7 @@
151151
152<para>152<para>
153<application><acronym>APT</acronym></application> (Advanced Packaging Tool) is a153<application><acronym>APT</acronym></application> (Advanced Packaging Tool) is a
154powerful package management system, which is the basis for the graphical154powerful package management system which is the basis for the graphical
155<application>Software Management</application> application.155<application>Software Management</application> application.
156<application>APT</application> automatically handles dependencies and performs156<application>APT</application> automatically handles dependencies and performs
157other package operations that are required for package installation.157other package operations that are required for package installation.
@@ -160,7 +160,7 @@
160<para>160<para>
161Running <application>APT</application> requires administrative privileges.161Running <application>APT</application> requires administrative privileges.
162Entering commands with "sudo" generates a password prompt. Several of the162Entering commands with "sudo" generates a password prompt. Several of the
163commands below will not run without sudo. 163commands below will not run without sudo.
164</para>164</para>
165</note>165</note>
166<para>166<para>
@@ -193,7 +193,7 @@
193</listitem>193</listitem>
194<listitem>194<listitem>
195<para>195<para>
196Retrieve the current lists of available packages:196Retrieve the current list of available packages:
197<screen>sudo apt-get update</screen>197<screen>sudo apt-get update</screen>
198</para>198</para>
199</listitem>199</listitem>
@@ -216,7 +216,6 @@
216the comprehensive <ulink url="&debian-apt;">Debian APT User Manual</ulink>.216the comprehensive <ulink url="&debian-apt;">Debian APT User Manual</ulink>.
217</para>217</para>
218</tip>218</tip>
219
220</sect1>219</sect1>
221220
222<!-- APTITUDE -->221<!-- APTITUDE -->
@@ -226,7 +225,7 @@
226<para>225<para>
227<application>Aptitude</application> is a command line front-end to226<application>Aptitude</application> is a command line front-end to
228<application>APT</application>. <application>Aptitude</application> allows227<application>APT</application>. <application>Aptitude</application> allows
229for interactive package selection to remove, update or install packages.228for interactive package selection to remove, update, or install packages.
230<application>Aptitude</application> is an advanced package management system,229<application>Aptitude</application> is an advanced package management system,
231with more control and capability than <application>APT</application> as a230with more control and capability than <application>APT</application> as a
232command line tool.231command line tool.
@@ -239,12 +238,11 @@
239238
240<para>239<para>
241Although the preferred method of installing programs is with the package240Although the preferred method of installing programs is with the package
242manager, individual software241manager, individual software package files can be downloaded and installed.
243package files can be downloaded and installed. Several kinds of package files242Several kinds of package files are available for Linux systems. Generally,
244are available for Linux systems. Generally, these file types are associated with243these file types are associated with the package managers of specific Linux
245the package managers of specific Linux distributions.244distributions.
246</para>245</para>
247
248<para>246<para>
249To install a particular application, it is preferable to select a &kubuntu;247To install a particular application, it is preferable to select a &kubuntu;
250package of the application, and install it with a package manager. This ensures248package of the application, and install it with a package manager. This ensures
@@ -272,20 +270,20 @@
272270
273<sect2 id="alien" status="complete">271<sect2 id="alien" status="complete">
274<title>Convert .rpm files to .deb files</title>272<title>Convert .rpm files to .deb files</title>
275273
276<para>274<para>
277Red Hat Package Manager files have the <emphasis>.rpm</emphasis>275Red Hat Package Manager files have the <emphasis>.rpm</emphasis>
278suffix. It is not recommended that these be installed on a &kubuntu; system. In276suffix. Installing these on a &kubuntu; system is not recommended. In almost
279almost all cases, a native &kubuntu; <emphasis>.deb</emphasis> version of277all cases, a native &kubuntu; <emphasis>.deb</emphasis> version of the package
280the package is available. However, if necessary, an <emphasis>.rpm</emphasis>278is available. However, if necessary, an <emphasis>.rpm</emphasis> file can be
281file can be converted to a <emphasis>.deb</emphasis> package using a program279converted to a <emphasis>.deb</emphasis> package by using a program called
282called <application>alien</application>.280<application>alien</application>.
283</para>281</para>
284<procedure>282<procedure>
285<title>Installing Alien</title>283<title>Installing Alien</title>
286<step>284<step>
287<para>285<para>
288Open <application>Software Center</application> by going to &menusysmuon;.286Open <application>Muon</application> by going to &menumuon;.
289</para>287</para>
290</step>288</step>
291<step>289<step>
@@ -297,30 +295,35 @@
297<step>295<step>
298<para>296<para>
299Locate the package named <application>alien</application> and297Locate the package named <application>alien</application> and
300select it. Press the <guibutton>down arrow</guibutton> button. The arrow will298select it. Press the <guibutton>Installation</guibutton> button near the
301change color.299bottom right of the window.
302</para>300</para>
303</step>301<note>
304302<para>
305<step>303The text in the <emphasis>Requested</emphasis> column will turn green and
306<para>304change from <quote>No Change</quote> to <quote>Install</quote>.
307Press the <guibutton>Apply</guibutton> button, and305</para>
308the <guibutton>Install Now</guibutton> button on the following screen. There306</note>
309may be additional packages required to be installed as dependencies. If so,307</step>
310click <guibutton>OK</guibutton>.308<step>
311</para>309<para>
312</step>310Additional packages may be required as dependencies. If so, a list will be
313311displayed. Click the <guibutton>OK</guibutton> button to mark them for
312installation.
313</step>
314<step>
315<para>
316Press the <guibutton>Apply Changes</guibutton> button in the toolbar.
317</para>
318</step>
314<step>319<step>
315<para>320<para>
316If prompted, enter the proper password and press <guibutton>OK</guibutton>.321If prompted, enter the proper password and press <guibutton>OK</guibutton>.
317</para>322</para>
318</step>323</step>
319
320<step>324<step>
321<para>325<para>
322Once the installation has completed, close <application>Software326Once the installation has completed, close <application>Muon</application>.
323Management</application>.
324</para>327</para>
325</step>328</step>
326</procedure>329</procedure>
@@ -334,13 +337,14 @@
334<step>337<step>
335<para>338<para>
336At the command prompt, type <userinput>sudo alien package_file.rpm</userinput>339At the command prompt, type <userinput>sudo alien package_file.rpm</userinput>
337and press the <keycap>Enter</keycap> key.340and press the <keycap>Enter</keycap> key to create a <emphasis>.deb</emphasis>
341file in the same directory.
338</para>342</para>
339</step>343</step>
340<step>344<step>
341<para>345<para>
342For more information on <application>alien</application>, type <userinput>man346For more information on <application>alien</application>, type <userinput>man
343alien</userinput> at the command prompt. When complete, press347alien</userinput> at the command prompt. When finished, press
344<keycap>q</keycap> to exit.348<keycap>q</keycap> to exit.
345</para>349</para>
346</step>350</step>
@@ -353,12 +357,12 @@
353<para>357<para>
354Files with the <emphasis>.tar.gz</emphasis> or <emphasis>.tar.bz2</emphasis>358Files with the <emphasis>.tar.gz</emphasis> or <emphasis>.tar.bz2</emphasis>
355suffix are package files known as <emphasis>tarballs</emphasis> or359suffix are package files known as <emphasis>tarballs</emphasis> or
356<emphasis>source</emphasis> packages which are widely used in Linux. If there is360<emphasis>source</emphasis> packages. These are widely used in Linux. If there
357no native &kubuntu; package available in any of the repositories, it may be361is no native &kubuntu; package available in any of the repositories, it may be
358possible to compile and install the package from source. For tips on compiling362possible to compile and install the package from source. For tips on compiling
359software, look at the <ulink363software, look at the <ulink
360url="https://wiki.ubuntu.com/CompilingSoftware">Compiling364url="https://wiki.ubuntu.com/CompilingSoftware">Compiling Software</ulink> page
361Software</ulink> page on the Ubuntu Wiki.365in the Ubuntu Wiki.
362</para>366</para>
363</sect2>367</sect2>
364</sect1>368</sect1>
@@ -371,12 +375,12 @@
371<title>What are Repositories?</title>375<title>What are Repositories?</title>
372376
373<para>377<para>
374Thousands of programs are freely available to install on &kubuntu;. These378Thousands of programs are freely available to install in &kubuntu;. These
375programs are stored in software archives (<emphasis>repositories</emphasis>) and379programs are stored in software archives (<emphasis>repositories</emphasis>) and
376are made available for installation over the Internet. This makes it easy380are made available for installation over the Internet. This makes it easy
377to install new programs in &kubuntu;. It is also secure, because each381to install new programs in &kubuntu;. It is also secure, because each program
378program is built specifically for &kubuntu; and is checked thoroughly before it382is built specifically for &kubuntu; and is checked thoroughly before it is
379is installed. &kubuntu; repositories are categorized into four groups:383installed. &kubuntu; repositories are categorized into four groups:
380</para>384</para>
381385
382<itemizedlist>386<itemizedlist>
@@ -391,13 +395,13 @@
391<itemizedlist>395<itemizedlist>
392<listitem>396<listitem>
393<para>397<para>
394The level of support that software development teams provide for a program398The level of support that software development teams provide for a program.
395</para>399</para>
396</listitem>400</listitem>
397<listitem>401<listitem>
398<para>402<para>
399The level of compliance the program has to the <ulink403The level of compliance the program has to the <ulink
400url="&ubuntu-philosophy;">Free Software Philosophy</ulink>404url="&ubuntu-philosophy;">Free Software Philosophy</ulink>.
401</para>405</para>
402</listitem>406</listitem>
403</itemizedlist>407</itemizedlist>
@@ -411,7 +415,7 @@
411a system has information about the Internet-based locations for these415a system has information about the Internet-based locations for these
412repositories, more programs are available for installation. Using the416repositories, more programs are available for installation. Using the
413software package management tools installed by default, it is possible to417software package management tools installed by default, it is possible to
414discover, install and update any piece of software directly over the Internet,418discover, install, and update any piece of software directly over the Internet
415without the need for the LiveCD.419without the need for the LiveCD.
416</para>420</para>
417</sect2>421</sect2>
@@ -431,7 +435,7 @@
431<guimenu>Settings</guimenu>435<guimenu>Settings</guimenu>
432<guimenuitem>Configure Software Sources</guimenuitem>436<guimenuitem>Configure Software Sources</guimenuitem>
433</menuchoice>437</menuchoice>
434 in the <application>Software Center</application> package manager window.438 in the <application>Muon</application> package manager window.
435</para>439</para>
436</step>440</step>
437<step>441<step>
@@ -439,13 +443,12 @@
439An administrative password is required in order to proceed. 443An administrative password is required in order to proceed.
440</para>444</para>
441</step>445</step>
442
443<step>446<step>
444<para>447<para>
445Next, click on the <guilabel>Other Software</guilabel> tab. Existing448Next, click on the <guilabel>Other Software</guilabel> tab. Existing
446repositories can be enabled or disabled by checking the appropriate boxes449repositories can be enabled or disabled by checking the appropriate boxes
447in the upper section. To add a new repository, click the450in the upper section. To add a new repository, click the
448<guilabel>Add</guilabel> button.451<guilabel>Add...</guilabel> button.
449</para>452</para>
450</step>453</step>
451454
@@ -453,24 +456,41 @@
453<para>456<para>
454Enter the repository address. The proper format is required, and looks similar457Enter the repository address. The proper format is required, and looks similar
455to this: 458to this:
456<screen>deb http://ppa.launchpad.net/kubuntu-ppa/backports/ubuntu459<screen>deb http://ppa.launchpad.net/kubuntu-ppa/backports/ubuntu oneiric
457oneiric main</screen>460main</screen>
458</para>461</para>
459</step>462</step>
460463
461<step>464<step>
462<para>465<para>
463After adding the repository, a prompt will appear to update the package list.466Click the <guilabel>OK</guilabel> button to add the repository.
464This will allow Muon to find the newly available software.467</para>
465</para>468</step>
469
470<step>
471<para>
472Click the <guilabel>Close</guilabel> button.
473</para>
474<note>
475<para>
476A prompt will appear to update the package list. Doing so will allow
477<application>Muon</application> to find the newly available software.
478</para>
479</note>
466</step>480</step>
467481
468<step>482<step>
469<para>483<para>
470To remove a repository, select it in <guilabel>Software Sources</guilabel>, and484To remove a repository, select it in <guilabel>Software Sources</guilabel>, and
471press the <guibutton>Remove</guibutton> button. When the process is485press the <guibutton>Remove</guibutton> button. When the process is complete,
472complete, press the <guibutton>Close</guibutton> button.486press the <guibutton>Close</guibutton> button.
473</para>487</para>
488<note>
489<para>
490A prompt will appear to update the package list. Doing so will make
491<application>Muon</application> forget the no longer available software.
492</para>
493</note>
474</step>494</step>
475</procedure>495</procedure>
476</sect2>496</sect2>
@@ -488,9 +508,9 @@
488<para>508<para>
489When updates become available, &kubuntu; will display a message in the System509When updates become available, &kubuntu; will display a message in the System
490Tray. To update the system, click the <guibutton>Review and Update</guibutton>510Tray. To update the system, click the <guibutton>Review and Update</guibutton>
491button, which will open Muon. Click <guibutton>Select All511button, which will open <application>Muon</application>. Click
492Updates</guibutton> and then <guibutton>Apply</guibutton>. &kubuntu; will512<guibutton>Select All Updates</guibutton> and then <guibutton>Apply</guibutton>.
493download and install the updates.513&kubuntu; will download and install the updates.
494</para>514</para>
495515
496<para>516<para>

Subscribers

People subscribed via source and target branches

to all changes: