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

Proposed by Little Girl
Status: Merged
Merged at revision: 266
Proposed branch: lp:~littlergirl/kubuntu-docs/security
Merge into: lp:kubuntu-docs/precise
Diff against target: 2008 lines (+491/-449)
5 files modified
docs/audio/C/audio.xml (+47/-45)
docs/bugs/C/bugs.xml (+215/-169)
docs/cli/C/cli.xml (+143/-158)
docs/security/C/security.xml (+45/-42)
docs/video/C/video.xml (+41/-35)
To merge this branch: bzr merge lp:~littlergirl/kubuntu-docs/security
Reviewer Review Type Date Requested Status
Ubuntu Documentation Committers Pending
Review via email: mp+98794@code.launchpad.net

Description of the change

* Added an entity.
* Added some tags.
* Fixed some grammar.
* Fixed some punctuation.

To post a comment you must log in.

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
=== modified file 'docs/audio/C/audio.xml'
--- docs/audio/C/audio.xml 2011-12-30 16:40:04 +0000
+++ docs/audio/C/audio.xml 2012-03-22 07:41:34 +0000
@@ -22,20 +22,20 @@
22<title>Playing CDs</title>22<title>Playing CDs</title>
23<para>23<para>
24<application>Amarok</application> is the default application for playing audio24<application>Amarok</application> is the default application for playing audio
25<acronym>CDs</acronym> in &kubuntu;. When a <acronym>CD</acronym> is inserted,25<acronym>CD</acronym>s in &kubuntu;. When a <acronym>CD</acronym> is inserted,
26&kubuntu; will recognize it and display default options. To hear the content26&kubuntu; will recognize it and display default options. To hear the content
27with <application>Amarok</application>, select <guilabel>Play Audio CD with27with <application>Amarok</application>, select <guilabel>Play Audio CD with
28Amarok</guilabel> and then press the <guibutton>OK</guibutton> button.28Amarok</guilabel> and then press the <guibutton>OK</guibutton> button.
29&kubuntu; can be configured to remember this choice every time29&kubuntu; can be configured to remember this choice every time
30a <acronym>CD</acronym> is inserted by selecting <guilabel>Always do30a <acronym>CD</acronym> is inserted by selecting <guilabel>Always do
31this for this type of media</guilabel>, and pressing <guibutton>OK</guibutton>.31this for this type of media</guilabel>, and pressing <guibutton>OK</guibutton>.
32<application>Amarok</application> also offers other useful features. If connected to32<application>Amarok</application> also offers other useful features. If
33the Internet, <application>Amarok</application> will retrieve33connected to the Internet, <application>Amarok</application> will retrieve
34<acronym>CD</acronym> artist, title, and track data from <ulink34<acronym>CD</acronym> artist, title, and track data from <ulink
35url="http://freedb.org">freedb.org</ulink>. It will also download the lyrics35url="http://freedb.org">freedb.org</ulink>. It will also download the lyrics
36for the current selection if they are available by choosing the36for the current selection &mdash; if they are available &mdash; by choosing the
37<guilabel>Lyrics</guilabel> tab. Other Artist information can be found on <ulink37<guilabel>Lyrics</guilabel> tab. Other artist information can be found on
38url="http://www.wikipedia.org">Wikipedia</ulink> by selecting the38<ulink url="http://www.wikipedia.org">Wikipedia</ulink> by selecting the
39<guilabel>Artist</guilabel> tab.39<guilabel>Artist</guilabel> tab.
40</para>40</para>
41</sect1>41</sect1>
@@ -44,19 +44,21 @@
44<title>Editing Audio </title>44<title>Editing Audio </title>
4545
46<para>46<para>
47For editing audio files, &kubuntu; provides <application>Sound Editor (Audacity)</application>,47For editing audio files, &kubuntu; provides <application>Sound Editor
48a full-featured, free and open source software application. To use48(Audacity)</application>, a full-featured, free, and open source software
49<application>Sound Editor (Audacity)</application>:49application. To use <application>Sound Editor (Audacity)</application>:
50</para>50</para>
51<procedure>51<procedure>
52<step>52<step>
53<para>53<para>
54Install <application>Sound Editor (Audacity)</application> from the package manager (Muon)54Install <application>Sound Editor (Audacity)</application> from the package
55manager (Muon).
55</para>56</para>
56</step>57</step>
57<step>58<step>
58<para>59<para>
59Run <application>Sound Editor (Audacity)</application> by going to &menuaudacity;.60Run <application>Sound Editor (Audacity)</application> by going to
61&menuaudacity;.
60</para>62</para>
61</step>63</step>
62<step>64<step>
@@ -64,8 +66,7 @@
64Detailed instructions (including tutorials and weblinks) on using66Detailed instructions (including tutorials and weblinks) on using
65<application>Sound Editor (Audacity)</application> can be found by going to67<application>Sound Editor (Audacity)</application> can be found by going to
66<menuchoice>68<menuchoice>
67<guimenu>Help</guimenu>69<guimenu>Help</guimenu> <guisubmenu>Contents</guisubmenu>
68<guisubmenu>Contents</guisubmenu>
69</menuchoice> from within <application>Sound Editor (Audacity)</application>.70</menuchoice> from within <application>Sound Editor (Audacity)</application>.
70</para>71</para>
71</step>72</step>
@@ -78,7 +79,7 @@
78<para>79<para>
79In addition to being the default music player in &kubuntu;,80In addition to being the default music player in &kubuntu;,
80<application>Amarok</application> is also helpful for managing music81<application>Amarok</application> is also helpful for managing music
81collections. Start <application>Amarok</application> by going to &menuamarok;.82collections. Start <application>Amarok</application> by going to &menuamarok;.
82</para>83</para>
83<para>84<para>
84Another useful <application>Amarok</application> feature is the built-in ID385Another useful <application>Amarok</application> feature is the built-in ID3
@@ -93,10 +94,11 @@
9394
94<para>95<para>
95Another exciting <application>Amarok</application> feature is the ability to96Another exciting <application>Amarok</application> feature is the ability to
96play music directly from an iPod or other portable device. <application>Amarok</application> can also be97play music directly from an iPod or other portable device.
97used to transfer music files to and from an iPod. Please refer to the <ulink98<application>Amarok</application> can also be used to transfer music files to
98type="help" url="help:/amarok">Amarok Handbook</ulink> for more information on99and from an iPod. Please refer to the <ulink type="help"
99transferring and managing iPod media files.100url="help:/amarok">Amarok Handbook</ulink> for more information on transferring
101and managing iPod media files.
100</para>102</para>
101</sect1>103</sect1>
102104
@@ -105,30 +107,29 @@
105<procedure>107<procedure>
106<step>108<step>
107<para>109<para>
108When a blank <acronym>CD</acronym> is inserted, &kubuntu; will110When a blank <acronym>CD</acronym> is inserted, &kubuntu; will recognize it,
109recognize it, mount it, and then ask what to do with the <acronym>CD</acronym>.111mount it, and then ask what to do with the <acronym>CD</acronym>. Choose
110Choose <guilabel>Create an audio CD with K3B</guilabel> and press112<guilabel>Create an audio CD with K3B</guilabel> and press
111<guibutton>OK</guibutton>. This will open113<guibutton>OK</guibutton>. This will open the <application>K3b</application>
112<application>K3b</application>, the <acronym>CD</acronym> and114<acronym>CD</acronym> and <acronym>DVD</acronym> creator, and provide various
113<acronym>DVD</acronym> Kreator, and provide various options.115options.
114</para>116</para>
115</step>117</step>
116<step>118<step>
117<para>119<para>
118To start <application>K3b</application> manually, go to <guilabel>Kickoff Application 120To start <application>K3b</application> manually, go to &menuk3b;.
119> Applications > Multimedia > </guilabel><application>Disk Burning (K3b)</application>.
120</para>121</para>
121</step>122</step>
122<step>123<step>
123<para>124<para>
124Select <guilabel>New Audio CD Project</guilabel> in the <guilabel>New125Select <guilabel>New Audio CD Project</guilabel> in the <guilabel>New
125Project</guilabel> dropdown menu. 126Project</guilabel> drop-down menu.
126</para>127</para>
127</step>128</step>
128<step>129<step>
129<para>130<para>
130Inside <application>K3b</application>, browse and select the tracks to be131Inside <application>K3b</application>, browse and select the tracks to be
131ripped. Then drag and drop the tracks in the white area at the bottom of the132ripped. Then drag and drop the tracks into the white area at the bottom of the
132<application>K3b</application> window. 133<application>K3b</application> window.
133<mediaobject>134<mediaobject>
134<imageobject>135<imageobject>
@@ -154,9 +155,10 @@
154<itemizedlist>155<itemizedlist>
155<listitem>156<listitem>
156<para>157<para>
157<guilabel>Writing</guilabel> - provides choices related to burning an image from158<guilabel>Writing</guilabel> - provides choices related to burning an image
158the files selected in the previous step.159from the files selected in the previous step.
159<note><title>No MP3 Support by Default</title>160<note>
161<title>No MP3 Support by Default</title>
160<para>162<para>
161<acronym>MP3</acronym> is a protocol restricted by patents. In order to use it163<acronym>MP3</acronym> is a protocol restricted by patents. In order to use it
162with <application>K3b</application>, please refer to the information at the end164with <application>K3b</application>, please refer to the information at the end
@@ -194,36 +196,36 @@
194</step>196</step>
195</procedure>197</procedure>
196<para>198<para>
197<application>K3b</application> can extract audio files to the following formats:199<application>K3b</application> can extract audio files to the following
200formats:
198<itemizedlist>201<itemizedlist>
199<listitem>202<listitem>
200<para>203<para>
201<emphasis role="strong">Ogg Vorbis</emphasis> - Ogg204<emphasis role="strong">Ogg Vorbis</emphasis> - Ogg Vorbis is a patent-free
202Vorbis is a patent-free lossy audio compression format which usually produces205lossy audio compression format which usually produces higher quality and
203higher quality and greater compression than MP3. See the <ulink206greater compression than MP3. See the <ulink url="http://www.vorbis.com/faq/">
204url="http://www.vorbis.com/faq/">Vorbis website</ulink> for more information.207Vorbis website</ulink> for more information.
205</para>208</para>
206</listitem>209</listitem>
207<listitem>210<listitem>
208<para><emphasis role="strong">FLAC</emphasis> - The Free Lossless Audio211<para><emphasis role="strong">FLAC</emphasis> - The Free Lossless Audio
209Codec, <acronym>FLAC</acronym>, can compress audio files up to 50% without removing212Codec, <acronym>FLAC</acronym>, can compress audio files up to 50% without
210any information from the audio stream. For more information on this format, see213removing any information from the audio stream. For more information on this
211the <ulink url="http://flac.sourceforge.net/">FLAC homepage</ulink> on214format, see the <ulink url="http://flac.sourceforge.net/">FLAC
212sourceforge.net.215homepage</ulink> on <trademark>Sourceforge</trademark>.
213</para>216</para>
214</listitem>217</listitem>
215<listitem>218<listitem>
216<para><emphasis role="strong">WAV</emphasis> - Wav is an219<para><emphasis role="strong">WAV</emphasis> - Wav is an uncompressed audio
217uncompressed audio format that can be compressed into OGG Vorbis or a codec of220format that can be compressed into OGG Vorbis or a codec of your choice. It is
218your choice. It is often edited in applications such as Audacity before being221often edited in applications such as Audacity before being compressed.
219compressed.
220</para>222</para>
221</listitem>223</listitem>
222</itemizedlist>224</itemizedlist>
223</para>225</para>
224<para>226<para>
225CD audio files can be extracted to the proprietary, non-free227CD audio files can be extracted to the proprietary, non-free
226<emphasis role="strong">MP3</emphasis> lossy format by using the228<emphasis role="strong">MP3</emphasis> lossy format by using the
227<application>lame</application> encoder. Please refer to the <ulink type="help"229<application>lame</application> encoder. Please refer to the <ulink type="help"
228url="help:/kubuntu/add-applications/">Adding Applications</ulink> documentation230url="help:/kubuntu/add-applications/">Adding Applications</ulink> documentation
229for help with installing applications such as <application>lame</application>.231for help with installing applications such as <application>lame</application>.
230232
=== modified file 'docs/bugs/C/bugs.xml'
--- docs/bugs/C/bugs.xml 2011-09-15 05:13:39 +0000
+++ docs/bugs/C/bugs.xml 2012-03-22 07:41:34 +0000
@@ -28,8 +28,8 @@
28<varlistentry><term>Crash</term>28<varlistentry><term>Crash</term>
29<listitem>29<listitem>
30<para>30<para>
31An application or system crash or failure. Most of the time, a crash dialog will31An application or system crash or failure. Most of the time a crash dialog will
32be presented that can be turned into a bug report.32be presented. This can be turned into a bug report.
33</para>33</para>
34</listitem>34</listitem>
35</varlistentry>35</varlistentry>
@@ -59,19 +59,25 @@
59<title>KDE's Bug Tracking System</title>59<title>KDE's Bug Tracking System</title>
60<para><ulink url="https://bugs.kde.org/"/></para>60<para><ulink url="https://bugs.kde.org/"/></para>
61<para>61<para>
62KDE uses Bugzilla, a &quot;Defect Tracking System&quot;. Bugzilla is one of the62<trademark>KDE</trademark> uses <trademark>Bugzilla</trademark>, a
63most popular tools used in the open source development community.63<quote>Defect Tracking System</quote>. <trademark>Bugzilla</trademark> is one
64of the most popular tools used in the open source development community.
64</para>65</para>
65<note><title>Register first</title>66<note><title>Register first</title>
66<para>67<para>
67To report a bug, one must register for an account on KDE's Bugzilla68To report a bug, one must register for an account on
68at <ulink url="https://bugs.kde.org/createaccount.cgi"/>. A valid email address69<trademark>KDE</trademark>'s <trademark>Bugzilla</trademark> at <ulink
69is required for registration.70url="https://bugs.kde.org/createaccount.cgi"/>. A valid email address is
71required for registration.
70</para>72</para>
71</note>73</note>
72<note><title>Only for KDE bugs</title>74<note><title>Only for KDE bugs</title>
73<para>75<para>
74Bugzilla is only for KDE bugs. If the application is not part of KDE, for instance Firefox, LibreOffice, or VLC, then the report should be filed in Launchpad instead. Please see the next section, which covers filing reports concerning Launchpad.76<trademark>Bugzilla</trademark> is only for <trademark>KDE</trademark> bugs. If
77the application is not part of <trademark>KDE</trademark> &mdash; Firefox,
78LibreOffice, or VLC, for instance &mdash; then the report should be filed in
79Launchpad instead. Please see the next section, which covers filing reports
80concerning Launchpad.
75</para>81</para>
76</note>82</note>
77</sect2>83</sect2>
@@ -79,22 +85,24 @@
79<title>Launchpad</title>85<title>Launchpad</title>
80<para><ulink url="https://launchpad.net/"/></para>86<para><ulink url="https://launchpad.net/"/></para>
81<para>87<para>
82Launchpad is an open source suite of tools that help people and teams to work88<trademark>Launchpad</trademark> is an open source suite of tools that help
83together on software projects. Launchpad is used by the Ubuntu and &kubuntu;89people and teams to work together on software projects. Launchpad is used by
84Projects, as well as various other open source projects.90the &ubuntu; and &kubuntu; projects, as well as various other open source
91projects.
85</para>92</para>
86<note><title>Register first</title>93<note><title>Register first</title>
87<para>94<para>
88To report a bug, one must register for a Launchpad account at95To report a bug, one must register for a <trademark>Launchpad</trademark>
89<ulink url="https://launchpad.net/+login"/>. A valid email address is required96account at <ulink url="https://launchpad.net/+login"/>. A valid email address
90for registration.97is required for registration.
91</para>98</para>
92</note>99</note>
93<note><title>For any bug in &kubuntu;</title>100<note><title>For any bug in &kubuntu;</title>
94<para>101<para>
95Launchpad can be used to file a bug report for any application available in the102<trademark>Launchpad</trademark> can be used to file a bug report for any
96Ubuntu or &kubuntu; repositories. For KDE applications, the103application available in the &ubuntu; or &kubuntu; repositories. For
97KDE Bug Tracking system (above) is preferred.104<trademark>KDE</trademark> applications, the <trademark>KDE Bug
105Tracking</trademark> system (above) is preferred.
98</para>106</para>
99</note>107</note>
100</sect2>108</sect2>
@@ -104,18 +112,19 @@
104<title>Filing a Crash Report</title>112<title>Filing a Crash Report</title>
105<para>113<para>
106When an application crashes in &kubuntu;, the appropriate crash dialog will114When an application crashes in &kubuntu;, the appropriate crash dialog will
107appear. It is usually easy to file a bug report from the dialog. With a KDE115appear. It is usually easy to file a bug report from the dialog. With a
108application, the KDE crash dialog will appear along with instructions116<trademark>KDE</trademark> application, the <trademark>KDE</trademark> crash
109for reporting the bug. Otherwise, the Ubuntu crash dialog will appear with117dialog will appear along with instructions for reporting the bug. Otherwise,
110instructions for filing a bug on Launchpad.118the &ubuntu; crash dialog will appear with instructions for filing a bug on
119<trademark>Launchpad</trademark>.
111</para>120</para>
112<sect2 id="filing-crash-kde">121<sect2 id="filing-crash-kde">
113<title>KDE</title>122<title>KDE</title>
114<para>123<para>
115When an application crashes in KDE, a crash dialog will be presented that is124When an application crashes in <trademark>KDE</trademark>, a crash dialog will
116similar to the following images. The first image shows the125be presented that is similar to the following images. The first image shows the
117<guilabel>General</guilabel> tab which provides an overview of the crash. The126<guilabel>General</guilabel> tab, which provides an overview of the crash. The
118second image shows the <guilabel>Developer Information</guilabel> tab which127second image shows the <guilabel>Developer Information</guilabel> tab, which
119provides trace information that is useful to developers.128provides trace information that is useful to developers.
120</para>129</para>
121<para>130<para>
@@ -139,10 +148,10 @@
139</example>148</example>
140</para>149</para>
141<para>150<para>
142If the trace information is deemed valuable, filing a bug report is151If the trace information is deemed valuable, filing a bug report is easy with
143easy with the crash dialog wizard. If the trace is not deemed valuable, then it152the crash dialog wizard. If the trace is not deemed valuable, then it is not
144is not possible to file a bug report with the wizard. The bug report can still153possible to file a bug report with the wizard. The bug report can still be
145be filed manually at <ulink url="https://bugs.kde.org/"/>.154filed manually at <ulink url="https://bugs.kde.org/"/>.
146</para>155</para>
147<para>156<para>
148To complete the bug reporting process, follow the procedure below.157To complete the bug reporting process, follow the procedure below.
@@ -151,14 +160,15 @@
151<step>160<step>
152<para>161<para>
153<mousebutton>Click</mousebutton> the <guibutton>Report Bug</guibutton> button.162<mousebutton>Click</mousebutton> the <guibutton>Report Bug</guibutton> button.
154The following dialog will appear.163The following dialog will appear:
155</para>164</para>
156<para>165<para>
157<example>166<example>
158<title>Welcome to the Reporting Assistant</title>167<title>Welcome to the Reporting Assistant</title>
159<mediaobject>168<mediaobject>
160<imageobject>169<imageobject>
161<imagedata fileref="help:/images/C/crash_report_assistant_welcome.png" format="PNG"/>170<imagedata
171fileref="help:/images/C/crash_report_assistant_welcome.png" format="PNG"/>
162</imageobject>172</imageobject>
163</mediaobject>173</mediaobject>
164</example>174</example>
@@ -167,14 +177,15 @@
167<step>177<step>
168<para>178<para>
169<mousebutton>Click</mousebutton> the <guibutton>Next</guibutton> button. The179<mousebutton>Click</mousebutton> the <guibutton>Next</guibutton> button. The
170following dialog will appear.180following dialog will appear:
171</para>181</para>
172<para>182<para>
173<example>183<example>
174<title>What do you know about the crash?</title>184<title>What do you know about the crash?</title>
175<mediaobject>185<mediaobject>
176<imageobject>186<imageobject>
177<imagedata fileref="help:/images/C/crash_report_assistant_about_crash.png" format="PNG"/>187<imagedata
188fileref="help:/images/C/crash_report_assistant_about_crash.png" format="PNG"/>
178</imageobject>189</imageobject>
179</mediaobject>190</mediaobject>
180</example>191</example>
@@ -183,15 +194,17 @@
183<step>194<step>
184<para>195<para>
185Select the applicable options. The drop-down box under the question,196Select the applicable options. The drop-down box under the question,
186&quot;<guilabel>Does the application crash again if you repeat the197<quote><guilabel>Does the application crash again if you repeat the
187same situation?</guilabel>&quot; has several options.198same situation?</guilabel></quote> has several options.
188</para>199</para>
189<para>200<para>
190<example>201<example>
191<title>Does the application crash again if you repeat the same situation?</title>202<title>Does the application crash again if you repeat the same situation?</title>
192<mediaobject>203<mediaobject>
193<imageobject>204<imageobject>
194<imagedata fileref="help:/images/C/crash_report_assistant_about_crash_dropdown.png" format="PNG"/>205<imagedata
206fileref="help:/images/C/crash_report_assistant_about_crash_dropdown.png"
207format="PNG"/>
195</imageobject>208</imageobject>
196</mediaobject>209</mediaobject>
197</example>210</example>
@@ -205,18 +218,21 @@
205</step>218</step>
206<step>219<step>
207<para>220<para>
208Depending on the information available in the crash report, either of two221Depending on the information available in the crash report, either of two
209dialogs will appear. One is a dialog that indicates that there is not enough222dialogs will appear. One is a dialog that indicates that there is not enough
210information to file a good report. The other is a dialog indicating that the223information to file a good report. The other is a dialog indicating that the
211information is useful, and that it would be helpful to continue with filing the224information is useful and that it would be helpful to continue with filing the
212report.225report.
213</para>226</para>
214<para>227<para>
215<example>228<example>
216<title>Not enough information for developers to continue the reporting process</title>229<title>Not enough information for developers to continue the reporting
230process</title>
217<mediaobject>231<mediaobject>
218<imageobject>232<imageobject>
219<imagedata fileref="help:/images/C/crash_report_assistant_not_enough_info.png" format="PNG"/>233<imagedata
234fileref="help:/images/C/crash_report_assistant_not_enough_info.png"
235format="PNG"/>
220</imageobject>236</imageobject>
221</mediaobject>237</mediaobject>
222</example>238</example>
@@ -226,7 +242,9 @@
226<title>This crash information is useful</title>242<title>This crash information is useful</title>
227<mediaobject>243<mediaobject>
228<imageobject>244<imageobject>
229<imagedata fileref="help:/images/C/crash_report_assistant_useful_information.png" format="PNG"/>245<imagedata
246fileref="help:/images/C/crash_report_assistant_useful_information.png"
247format="PNG"/>
230</imageobject>248</imageobject>
231</mediaobject>249</mediaobject>
232</example>250</example>
@@ -235,7 +253,7 @@
235<para>253<para>
236It may be necessary to install the proper debug packages in order to get a good254It may be necessary to install the proper debug packages in order to get a good
237trace. Such packages include <filename>kdebase-dbg</filename>,255trace. Such packages include <filename>kdebase-dbg</filename>,
238<filename>kdebase-workspace-dbg</filename>,256<filename>kdebase-workspace-dbg</filename>, and
239<filename>kdebase-runtime-dbg</filename>.257<filename>kdebase-runtime-dbg</filename>.
240</para>258</para>
241</note>259</note>
@@ -243,36 +261,42 @@
243<step>261<step>
244<para>262<para>
245If enough information was provided to continue filing a bug report using263If enough information was provided to continue filing a bug report using
246the assistant, a dialog will appear to allow logging in to KDE's Bugzilla.264the assistant, a dialog will appear to allow logging in to
265<trademark>KDE</trademark>'s <trademark>Bugzilla</trademark>.
247</para>266</para>
248<para>267<para>
249<example>268<example>
250<title>KDE Bug Tracking System Login</title>269<title>KDE Bug Tracking System Login</title>
251<mediaobject>270<mediaobject>
252<imageobject>271<imageobject>
253<imagedata fileref="help:/images/C/crash_report_assistant_bugtracker_login.png" format="PNG"/>272<imagedata
273fileref="help:/images/C/crash_report_assistant_bugtracker_login.png"
274format="PNG"/>
254</imageobject>275</imageobject>
255</mediaobject>276</mediaobject>
256</example>277</example>
257</para>278</para>
258<note><title>Use e-mail address as username</title>279<note><title>Use e-mail address as username</title>
259<para>280<para>
260Use the e-mail address that was used to register with KDE's Bugzilla.281Use the email address that was used to register with
282<trademark>KDE</trademark>'s <trademark>Bugzilla</trademark>.
261</para>283</para>
262</note>284</note>
263</step>285</step>
264<step>286<step>
265<para>287<para>
266After logging in with username (e-mail address) and password,288After logging in with your username (email address) and password,
267<mousebutton>click</mousebutton> the <guibutton>Login</guibutton> button. The289<mousebutton>click</mousebutton> the <guibutton>Login</guibutton> button. The
268assistant will check for duplicates and display the following dialog.290assistant will check for duplicates and display the following dialog:
269</para>291</para>
270<para>292<para>
271<example>293<example>
272<title>Bug Report Possible Duplicates List</title>294<title>Bug Report Possible Duplicates List</title>
273<mediaobject>295<mediaobject>
274<imageobject>296<imageobject>
275<imagedata fileref="help:/images/C/crash_report_assistant_possible_duplicates.png" format="PNG"/>297<imagedata
298fileref="help:/images/C/crash_report_assistant_possible_duplicates.png"
299format="PNG"/>
276</imageobject>300</imageobject>
277</mediaobject>301</mediaobject>
278</example>302</example>
@@ -283,14 +307,17 @@
283If there is a possible duplicate report, <mousebutton>click</mousebutton> the307If there is a possible duplicate report, <mousebutton>click</mousebutton> the
284report in the list and then <mousebutton>click</mousebutton> the <guibutton>Open308report in the list and then <mousebutton>click</mousebutton> the <guibutton>Open
285selected report</guibutton> button. Either of the following dialogs will be309selected report</guibutton> button. Either of the following dialogs will be
286presented.310presented:
287</para>311</para>
288<para>312<para>
289<example>313<example>
290<title>The report you selected is already marked as a duplicate of bug...</title>314<title>The report you selected is already marked as a duplicate of
315bug...</title>
291<mediaobject>316<mediaobject>
292<imageobject>317<imageobject>
293<imagedata fileref="help:/images/C/crash_report_assistant_nested_duplicate_detected.png" format="PNG"/>318<imagedata
319fileref="help:/images/C/crash_report_assistant_nested_duplicate_detected.png"
320format="PNG"/>
294</imageobject>321</imageobject>
295</mediaobject>322</mediaobject>
296</example>323</example>
@@ -300,7 +327,9 @@
300<title>Showing the duplicate bug report you selected</title>327<title>Showing the duplicate bug report you selected</title>
301<mediaobject>328<mediaobject>
302<imageobject>329<imageobject>
303<imagedata fileref="help:/images/C/crash_report_assistant_duplicate_report.png" format="PNG"/>330<imagedata
331fileref="help:/images/C/crash_report_assistant_duplicate_report.png"
332format="PNG"/>
304</imageobject>333</imageobject>
305</mediaobject>334</mediaobject>
306</example>335</example>
@@ -313,23 +342,26 @@
313bug report and inform the developers that it may be a duplicate. This is342bug report and inform the developers that it may be a duplicate. This is
314recommended, except in cases with experienced users where it is clearly not a343recommended, except in cases with experienced users where it is clearly not a
315duplicate. <mousebutton>Clicking</mousebutton> the <guibutton>Attach to this344duplicate. <mousebutton>Clicking</mousebutton> the <guibutton>Attach to this
316report (Advanced)</guibutton> will attach the crash information to the report.345report (Advanced)</guibutton> button will attach the crash information to the
346report.
317</para>347</para>
318<para>348<para>
319If the bug is not a duplicate, simply <mousebutton>click</mousebutton>349If the bug is not a duplicate, simply <mousebutton>click</mousebutton>
320the <guibutton>Next</guibutton> in the dialog showing the possible duplicates.350the <guibutton>Next</guibutton> button in the dialog showing the possible
321A dialog will appear with <guibutton>Let me check more reports</guibutton>. To351duplicates. A dialog will appear with <guibutton>Let me check more
322prevent checking for more reports and continue to file the report,352reports</guibutton>. To prevent checking for more reports and continue filing
323<mousebutton>click</mousebutton> the <guibutton>There353the report, <mousebutton>click</mousebutton> the <guibutton>There
324are no real duplicates</guibutton> button. A dialog will appear to enter354are no real duplicates</guibutton> button. A dialog will appear asking you to
325additional information concerning the report.355enter additional information concerning the report.
326</para>356</para>
327<para>357<para>
328<example>358<example>
329<title>Details of the Bug Report</title>359<title>Details of the Bug Report</title>
330<mediaobject>360<mediaobject>
331<imageobject>361<imageobject>
332<imagedata fileref="help:/images/C/crash_report_assistant_report_details.png" format="PNG"/>362<imagedata
363fileref="help:/images/C/crash_report_assistant_report_details.png"
364format="PNG"/>
333</imageobject>365</imageobject>
334</mediaobject>366</mediaobject>
335</example>367</example>
@@ -337,16 +369,18 @@
337</step>369</step>
338<step>370<step>
339<para>371<para>
340Once the details of the bug report are complete,372Once the details of the bug report are complete,
341<mousebutton>click</mousebutton> the <guibutton>Next</guibutton> button. The373<mousebutton>click</mousebutton> the <guibutton>Next</guibutton> button. The
342following dialog will be presented.374following dialog will be presented:
343</para>375</para>
344<para>376<para>
345<example>377<example>
346<title>Preview Report</title>378<title>Preview Report</title>
347<mediaobject>379<mediaobject>
348<imageobject>380<imageobject>
349<imagedata fileref="help:/images/C/crash_report_assistant_report_details_preview.png" format="PNG"/>381<imagedata
382fileref="help:/images/C/crash_report_assistant_report_details_preview.png"
383format="PNG"/>
350</imageobject>384</imageobject>
351</mediaobject>385</mediaobject>
352</example>386</example>
@@ -355,14 +389,16 @@
355<step>389<step>
356<para>390<para>
357If the information looks correct, <mousebutton>click</mousebutton> the391If the information looks correct, <mousebutton>click</mousebutton> the
358<guibutton>Next</guibutton> button. The following dialog will be presented.392<guibutton>Next</guibutton> button. The following dialog will be presented:
359</para>393</para>
360<para>394<para>
361<example>395<example>
362<title>Send Crash Report</title>396<title>Send Crash Report</title>
363<mediaobject>397<mediaobject>
364<imageobject>398<imageobject>
365<imagedata fileref="help:/images/C/crash_report_assistant_report_filed.png" format="PNG"/>399<imagedata
400fileref="help:/images/C/crash_report_assistant_report_filed.png"
401format="PNG"/>
366</imageobject>402</imageobject>
367</mediaobject>403</mediaobject>
368</example>404</example>
@@ -370,18 +406,19 @@
370</step>406</step>
371</procedure>407</procedure>
372<para>408<para>
373<emphasis role="bold">Congratulations on a successful bug report!</emphasis>409<emphasis>Congratulations on a successful bug report!</emphasis> Identifying
374Identifying and reporting bugs are essential to improving &kubuntu; and KDE.410and reporting bugs are essential to improving &kubuntu; and
375Some emails may be sent to the registered address to update progress or to411<trademark>KDE</trademark>. Some emails may be sent to the registered address
376allow developers to get additional information about the bug.412to update progress or to allow developers to get additional information about
413the bug.
377</para>414</para>
378</sect2>415</sect2>
379<sect2 id="filing-crash-lp">416<sect2 id="filing-crash-lp">
380<title>Launchpad</title>417<title>Launchpad</title>
381<para>418<para>
382When an application that is not KDE crashes in &kubuntu;, a pop-up notification419When an application that is not <trademark>KDE</trademark> crashes in
383will appear from <application>Apport</application> that is similar to the420&kubuntu;, a pop-up notification will appear from
384following image.421<application>Apport</application> that is similar to the following image:
385</para>422</para>
386<para>423<para>
387<example><title>Apport Crash Pop-pup Notification</title>424<example><title>Apport Crash Pop-pup Notification</title>
@@ -394,11 +431,11 @@
394</para>431</para>
395<note><title>Crash information may be different</title>432<note><title>Crash information may be different</title>
396<para>433<para>
397The following screen shots were created by crashing the application434The screen shots below were created by crashing the application
398<application>VLC</application> deliberately. Crash dialogs associated with other435<application>VLC</application> deliberately. Crash dialogs associated with
399applications will be different. In an actual bug situation, the application436other applications will be different. In an actual bug situation, the
400name, <application>VLC</application>, will be replaced by the name of the437application name, <application>VLC</application>, will be replaced by the name
401application that actually crashed.438of the application that actually crashed.
402</para>439</para>
403</note>440</note>
404<para>441<para>
@@ -409,7 +446,7 @@
409<para>446<para>
410<mousebutton>Click</mousebutton> the <guibutton>Details</guibutton> buttons on447<mousebutton>Click</mousebutton> the <guibutton>Details</guibutton> buttons on
411the <application>System Notification Helper</application>. The following dialog448the <application>System Notification Helper</application>. The following dialog
412will be presented.449will be presented:
413</para>450</para>
414<para>451<para>
415<example>452<example>
@@ -441,11 +478,11 @@
441</step>478</step>
442<step>479<step>
443<para>480<para>
444After all of the information concerning the crash is collected, a dialog will481After all information concerning the crash is collected, a dialog will be
445be presented that displays the details of the report, and the report is sent to482presented that displays the details of the report, and the report is sent to
446the developers. <mousebutton>Click</mousebutton> the483the developers. <mousebutton>Click</mousebutton> the
447<guibutton>Details...</guibutton> button to view details of the report. The484<guibutton>Details...</guibutton> button to view details of the report. The
448following dialog will be presented.485following dialog will be presented:
449</para>486</para>
450<para>487<para>
451<example><title>Send problem report to the developers? (Details)</title>488<example><title>Send problem report to the developers? (Details)</title>
@@ -460,8 +497,8 @@
460<step>497<step>
461<para>498<para>
462<mousebutton>Click</mousebutton> the <guibutton>Send</guibutton> button to send499<mousebutton>Click</mousebutton> the <guibutton>Send</guibutton> button to send
463the report to the developers. In this case, it will send the report to500the report to the developers. In this case, it will send the report to
464Launchpad. The following progress dialog will be presented.501<trademark>Launchpad</trademark>. The following progress dialog will be presented:
465</para>502</para>
466<para>503<para>
467<example><title>Uploading problem information</title>504<example><title>Uploading problem information</title>
@@ -476,15 +513,16 @@
476<step>513<step>
477<para>514<para>
478After the progress dialog completes, the default web browser will open to515After the progress dialog completes, the default web browser will open to
479Launchpad presenting either the login page or the beginning of the online516<trademark>Launchpad</trademark>, presenting either the log-in page or the
480version of the bug reporting process. After logging in (if necessary) the517beginning of the online version of the bug reporting process. After logging in
481following page will be presented.518(if necessary), the following page will be presented:
482</para>519</para>
483<para>520<para>
484<example><title>Please wait while bug data is processed...</title>521<example><title>Please wait while bug data is processed...</title>
485<mediaobject>522<mediaobject>
486<imageobject>523<imageobject>
487<imagedata fileref="help:/images/C/apport-browser-processing.png" format="PNG"/>524<imagedata fileref="help:/images/C/apport-browser-processing.png"
525format="PNG"/>
488</imageobject>526</imageobject>
489</mediaobject>527</mediaobject>
490</example>528</example>
@@ -492,8 +530,8 @@
492</step>530</step>
493<step>531<step>
494<para>532<para>
495When Launchpad is finished processing the bug data, the following page will be533When <trademark>Launchpad</trademark> is finished processing the bug data, the
496presented.534following page will be presented:
497</para>535</para>
498<para>536<para>
499<example><title>Extra debug information will be added...</title>537<example><title>Extra debug information will be added...</title>
@@ -508,7 +546,7 @@
508<step>546<step>
509<para>547<para>
510<mousebutton>Click</mousebutton> the <guibutton>Next</guibutton> button. The548<mousebutton>Click</mousebutton> the <guibutton>Next</guibutton> button. The
511following page will be presented.549following page will be presented:
512</para>550</para>
513<para>551<para>
514<example><title>Further information</title>552<example><title>Further information</title>
@@ -522,10 +560,10 @@
522</step>560</step>
523<step>561<step>
524<para>562<para>
525Any extra information can be filled in about the bug report such as what was563Any extra information about the bug report can be filled in to describe, for
526being done when it crashed or the online file locations that may have caused the564example, what was being done when the application crashed or the online file
527crash. The following is a brief description filed with the report in565locations that may have caused the crash. The following is a brief description
528this procedure.566filed with the report in this procedure:
529</para>567</para>
530<para>568<para>
531<example><title>Further information (Completed)</title>569<example><title>Further information (Completed)</title>
@@ -540,7 +578,7 @@
540<step>578<step>
541<para>579<para>
542<mousebutton>Click</mousebutton> the <guibutton>Submit Bug Report</guibutton>580<mousebutton>Click</mousebutton> the <guibutton>Submit Bug Report</guibutton>
543button on the bottom of the page. The following page will be presented.581button on the bottom of the page. The following page will be presented:
544</para>582</para>
545<para>583<para>
546<example><title>Thank you for your bug report</title>584<example><title>Thank you for your bug report</title>
@@ -554,10 +592,10 @@
554</step>592</step>
555</procedure>593</procedure>
556<para>594<para>
557<emphasis role="bold">Congratulations on making a successful crash595<emphasis>Congratulations on making a successful crash report!</emphasis>
558report!</emphasis>Identifying and reporting bugs are essential to improving596Identifying and reporting bugs are essential to improving &kubuntu;. Some
559&kubuntu;. Some emails may be sent to the registered address to update progress597emails may be sent to the registered address to update progress or to allow
560or to allow developers to get additional information about the bug.598developers to get additional information about the bug.
561</para>599</para>
562</sect2>600</sect2>
563</sect1>601</sect1>
@@ -565,32 +603,33 @@
565<sect1 id="filing-non-crash">603<sect1 id="filing-non-crash">
566<title>Filing a Non-Crash or Regression Report</title>604<title>Filing a Non-Crash or Regression Report</title>
567<para>605<para>
568If an application has regressed in functionality, a bug report should be606If an application has regressed in functionality, a bug report should be filed
569filed on that application. A regress occurs when a function worked in a previous607on that application. A regression occurs when a function worked in a previous
570release but in the latest release, it is not working. In most cases, this type608release, but is not working in the latest release. In most cases, this type of
571of report will be filed by those who have more experience and may be testing609report will be filed by those who have previous experience and may be testing
572beta quality software. However there are situations where a user needs to report610beta quality software. There are, however, situations where a user needs to
573an issue with an application that isn't working right, but isn't crashing. The611report an issue with an application that isn't working right, but isn't
574following procedures will help.612crashing. The following procedures will help:
575</para>613</para>
576<sect2 id="filing-non-crash-kde">614<sect2 id="filing-non-crash-kde">
577<title>KDE</title>615<title>KDE</title>
578<para>616<para>
579Filing non-crash related bug reports for KDE applications are done with a web617Filing non-crash related bug reports for <trademark>KDE</trademark>
580browser using <ulink url="https://bugs.kde.org/"/>.618applications is done with a web browser using
619<ulink url="https://bugs.kde.org/"/>.
581</para>620</para>
582<note><title>Register first</title>621<note><title>Register first</title>
583<para>622<para>
584To report a bug, one must register for an account on the bug tracker.623To report a bug, one must register for an account on the bug tracker.
585KDE's bug tracker is located at <ulink url="https://bugs.kde.org/"/>.624<trademark>KDE</trademark>'s bug tracker is located at <ulink
625url="https://bugs.kde.org/"/>.
586</para>626</para>
587</note>627</note>
588<procedure><title>Filing a bug report without a crash</title>628<procedure><title>Filing a bug report without a crash</title>
589<step>629<step>
590<para>630<para>
591In a web browser, go to <ulink url="https://bugs.kde.org/"/> and either631In a web browser, go to <ulink url="https://bugs.kde.org/"/> and either create
592create a new account or login. Once logged in, the following page will be632a new account or log in. Once logged in, the following page will be presented:
593presented.
594</para>633</para>
595<para>634<para>
596<example><title>Welcome to the KDE Bug Tracking System</title>635<example><title>Welcome to the KDE Bug Tracking System</title>
@@ -605,8 +644,8 @@
605<step>644<step>
606<para>645<para>
607<mousebutton>Click</mousebutton> the <guilabel>Report New Wish or Bug</guilabel>646<mousebutton>Click</mousebutton> the <guilabel>Report New Wish or Bug</guilabel>
608link in the top-right-hand corner of the page to start the process of filing the647link in the top right-hand corner of the page to start the process of filing
609bug report. The following page will be presented.648the bug report. The following page will be presented:
610</para>649</para>
611<para>650<para>
612<example><title>Welcome to the KDE Bug Report Wizard!</title>651<example><title>Welcome to the KDE Bug Report Wizard!</title>
@@ -620,8 +659,8 @@
620</step>659</step>
621<step>660<step>
622<para>661<para>
623<mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button. The662<mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button.
624following page will be presented.663The following page will be presented:
625</para>664</para>
626<para>665<para>
627<example><title>Software Configuration</title>666<example><title>Software Configuration</title>
@@ -639,7 +678,7 @@
639<guilabel>Distribution Method</guilabel> (Should be <guilabel>Ubuntu678<guilabel>Distribution Method</guilabel> (Should be <guilabel>Ubuntu
640Packages</guilabel>) from the drop-down menus. <mousebutton>Click</mousebutton>679Packages</guilabel>) from the drop-down menus. <mousebutton>Click</mousebutton>
641the <guibutton>Continue</guibutton> button when finished with the selections.680the <guibutton>Continue</guibutton> button when finished with the selections.
642The following page will be presented.681The following page will be presented:
643</para>682</para>
644<para>683<para>
645<example><title>Application Selection</title>684<example><title>Application Selection</title>
@@ -660,10 +699,10 @@
660</step>699</step>
661<step>700<step>
662<para>701<para>
663Under the <guilabel>Find</guilabel> section under the702Under the <guilabel>Find</guilabel> section in the
664<guilabel>Application</guilabel> list, fill in the <guilabel>Keyword703<guilabel>Application</guilabel> list, fill in the <guilabel>Keyword
665Search</guilabel> text box with the application being reported. It should look704Search</guilabel> text box with the application being reported. It should look
666similar to the following image.705similar to the following image:
667</para>706</para>
668<para>707<para>
669<example><title>Application Selection (Search for application)</title>708<example><title>Application Selection (Search for application)</title>
@@ -681,8 +720,8 @@
681</step>720</step>
682<step>721<step>
683<para>722<para>
684<mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button. The723<mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button.
685following page will be presented.724The following page will be presented:
686</para>725</para>
687<para>726<para>
688<example><title>General Information</title>727<example><title>General Information</title>
@@ -700,7 +739,7 @@
700information similar to the example under the text box. Select739information similar to the example under the text box. Select
701<guilabel>Linux</guilabel> in the <guilabel>Operating System</guilabel>740<guilabel>Linux</guilabel> in the <guilabel>Operating System</guilabel>
702drop-down menu. When completed, <mousebutton>Click</mousebutton> the741drop-down menu. When completed, <mousebutton>Click</mousebutton> the
703<guibutton>Continue</guibutton> button. The following page will be presented.742<guibutton>Continue</guibutton> button. The following page will be presented:
704</para>743</para>
705<para>744<para>
706<example><title>Check for Duplicate Bug Reports</title>745<example><title>Check for Duplicate Bug Reports</title>
@@ -714,12 +753,12 @@
714</step>753</step>
715<step>754<step>
716<para>755<para>
717If a duplicate report is found, click on that report ID to view the report. If756If a duplicate report is found, click on that report <acronym>ID</acronym> to
718it is a duplicate and more information is needed, then simply enter text in the757view the report. If it is a duplicate and more information is needed, then
719large text box confirming it. If more information is not needed, nothing need758enter text into the large text box confirming it. If more information is not
720be entered. If no duplicate reports are found, <mousebutton>Click</mousebutton>759needed, nothing needs to be entered. If no duplicate reports are found,
721the <guibutton>Continue</guibutton> button. The following page will be760<mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button.
722presented.761The following page will be presented:
723</para>762</para>
724<para>763<para>
725<example><title>Bug Entry Form</title>764<example><title>Bug Entry Form</title>
@@ -734,11 +773,11 @@
734<step>773<step>
735<para>774<para>
736The <guilabel>Severity</guilabel> (required) drop-down menu should display the775The <guilabel>Severity</guilabel> (required) drop-down menu should display the
737<guilabel>Bug - Bug report (no crashes)</guilabel> option. In the <guilabel>Long776<guilabel>Bug - Bug report (no crashes)</guilabel> option. In the
738Description in English</guilabel> (required) text box, enter all information777<guilabel>Long Description in English</guilabel> (required) text box, enter all
739pertaining to the bug report. When completed, <mousebutton>Click</mousebutton>778information pertaining to the bug report. When completed,
740the <guibutton>Continue</guibutton> button. The following page will be779<mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button.
741presented.780The following page will be presented:
742</para>781</para>
743<para>782<para>
744<example><title>Bug Submitted</title>783<example><title>Bug Submitted</title>
@@ -752,27 +791,30 @@
752</step>791</step>
753</procedure>792</procedure>
754<para>793<para>
755<emphasis role="bold">Congratulations on making a successful non-crash related794<emphasis>Congratulations on making a successful non-crash-related bug
756bug report!</emphasis> Identifying and reporting bugs are essential to improving795report!</emphasis> Identifying and reporting bugs are essential to improving
757&kubuntu; and KDE. Some emails may be sent to the registered address to update796&kubuntu; and <trademark>KDE</trademark>. Some emails may be sent to the
758progress or to allow developers to get additional information about the bug.797registered address to update progress or to allow developers to get additional
798information about the bug.
759</para>799</para>
760</sect2>800</sect2>
761<sect2 id="filing-non-crash-lp">801<sect2 id="filing-non-crash-lp">
762<title>Launchpad</title>802<title>Launchpad</title>
763<para>803<para>
764Filing non-crash related bug reports in non-KDE applications can be done either804Filing non-crash-related bug reports in non-<trademark>KDE</trademark>
765by going to <ulink url="https://bugs.launchpad.net/ubuntu/+filebug"/> in a web805applications can be done either by going to <ulink
766browser or by using the <application>Apport</application> bug reporting806url="https://bugs.launchpad.net/ubuntu/+filebug"/> in a web browser or by using
767application. The following procedure will demonstrate the use of807the <application>Apport</application> bug reporting application. The following
768<application>Apport</application> as this is the recommended way of filing808procedure will demonstrate the use of <application>Apport</application> as this
769Ubuntu or non-KDE related bug reports.809is the recommended way of filing &ubuntu; or
810non-<trademark>KDE</trademark>-related bug reports:
770</para>811</para>
771<procedure><title>Filing a bug report without a crash</title>812<procedure><title>Filing a bug report without a crash</title>
772<step>813<step>
773<para>814<para>
774Open <application>KRunner</application>, the KDE run command interface, by815Open <application>KRunner</application>, the <trademark>KDE</trademark> run
775pressing <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>.816command interface, by pressing
817<keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>.
776</para>818</para>
777<para>819<para>
778<example><title>KRunner</title>820<example><title>KRunner</title>
@@ -786,10 +828,11 @@
786</step>828</step>
787<step>829<step>
788<para>830<para>
789In the <application>KRunner</application> dialog, enter <userinput>apport-bug -p831In the <application>KRunner</application> dialog, enter
790PROGRAM_NAME</userinput>. Replace <emphasis>PROGRAM_NAME</emphasis> with the832<userinput>apport-bug -p PROGRAM_NAME</userinput>. Replace
791name of the program the bug report is for. Press <keycap>Enter</keycap> when833<emphasis>PROGRAM_NAME</emphasis> with the name of the program the bug report
792complete. The following dialog will be presented.834is for. Press <keycap>Enter</keycap> when complete. The following dialog will
835be presented:
793</para>836</para>
794<para>837<para>
795<example><title>Collecting Problem Information</title>838<example><title>Collecting Problem Information</title>
@@ -818,9 +861,9 @@
818</step>861</step>
819<step>862<step>
820<para>863<para>
821<mousebutton>Click</mousebutton> the <guibutton>Details...</guibutton> button to864<mousebutton>Click</mousebutton> the <guibutton>Details...</guibutton> button
822see details of the report to be followed. The following dialog will be865to see details of the report to be followed. The following dialog will be
823presented.866presented:
824</para>867</para>
825<para>868<para>
826<example><title>Report Details</title>869<example><title>Report Details</title>
@@ -835,7 +878,7 @@
835<step>878<step>
836<para>879<para>
837<mousebutton>Click</mousebutton> the <guibutton>Send</guibutton> button to send880<mousebutton>Click</mousebutton> the <guibutton>Send</guibutton> button to send
838the report to the developers. The following progress dialog will be presented.881the report to the developers. The following progress dialog will be presented:
839</para>882</para>
840<para>883<para>
841<example><title>Uploading Problem Information</title>884<example><title>Uploading Problem Information</title>
@@ -850,7 +893,7 @@
850<step>893<step>
851<para>894<para>
852After the information has been uploaded, the web browser will open and display895After the information has been uploaded, the web browser will open and display
853a page similar to the following.896a page similar to the following:
854</para>897</para>
855<para>898<para>
856<example><title>Please wait while bug data is processed.</title>899<example><title>Please wait while bug data is processed.</title>
@@ -862,7 +905,7 @@
862</example>905</example>
863</para>906</para>
864<para>907<para>
865After the bug data is processed, the following page will be presented.908After the bug data is processed, the following page will be presented:
866</para>909</para>
867<para>910<para>
868<example><title>Report a bug... (Summary)</title>911<example><title>Report a bug... (Summary)</title>
@@ -876,9 +919,9 @@
876</step>919</step>
877<step>920<step>
878<para>921<para>
879Enter text in the <guilabel>Summary</guilabel> text box that describes the bug922Enter text that describes the bug into the <guilabel>Summary</guilabel> text
880with a few words. When finished, <mousebutton>Click</mousebutton> the923box. When finished, <mousebutton>Click</mousebutton> the
881<guibutton>Next</guibutton> button. The following page will be presented.924<guibutton>Next</guibutton> button. The following page will be presented:
882</para>925</para>
883<para>926<para>
884<example><title>Report a bug... (Further information)</title>927<example><title>Report a bug... (Further information)</title>
@@ -895,7 +938,7 @@
895Enter text in the <guilabel>Further information</guilabel> text box describing938Enter text in the <guilabel>Further information</guilabel> text box describing
896the bug in detail. When complete, <mousebutton>Click</mousebutton> the939the bug in detail. When complete, <mousebutton>Click</mousebutton> the
897<guibutton>Submit Bug Report</guibutton> button. The following page will be940<guibutton>Submit Bug Report</guibutton> button. The following page will be
898presented.941presented:
899</para>942</para>
900<para>943<para>
901<example><title>Thank you for your bug report</title>944<example><title>Thank you for your bug report</title>
@@ -909,8 +952,8 @@
909</step>952</step>
910</procedure>953</procedure>
911<para>954<para>
912<emphasis role="bold">Congratulations on making a successful non-crash related955<emphasis>Congratulations on making a successful non-crash related bug
913bug report!</emphasis> Identifying and reporting bugs are essential to improving956report!</emphasis> Identifying and reporting bugs are essential to improving
914&kubuntu;. Some emails may be sent to the registered address to update progress957&kubuntu;. Some emails may be sent to the registered address to update progress
915or to allow developers to get additional information about the bug.958or to allow developers to get additional information about the bug.
916</para>959</para>
@@ -920,21 +963,24 @@
920<sect1 id="filing-wishlist">963<sect1 id="filing-wishlist">
921<title>Filing a Feature Request or Wishlist Report</title>964<title>Filing a Feature Request or Wishlist Report</title>
922<para>965<para>
923The easiest way to request a new feature in either an application or the966The easiest way to request a new feature, in either an application or the
924operating system is to file a bug, otherwise known as a wishlist report.967operating system, is to file a bug &mdash; otherwise known as a wishlist
968report.
925</para>969</para>
926<sect2 id="filing-wishlist-kde">970<sect2 id="filing-wishlist-kde">
927<title>KDE</title>971<title>KDE</title>
928<para>972<para>
929Filing a feature request report in KDE is exactly the same as filing a <link973Filing a feature request report in <trademark>KDE</trademark> is exactly the
930linkend="filing-non-crash-kde">non-crash KDE bug report</link>.974same as filing a <link linkend="filing-non-crash-kde">non-crash
975<trademark>KDE</trademark> bug report</link>.
931</para>976</para>
932</sect2>977</sect2>
933<sect2 id="filing-wishlist-lp">978<sect2 id="filing-wishlist-lp">
934<title>Launchpad</title>979<title>Launchpad</title>
935<para>980<para>
936Filing a wishlist report for &kubuntu; is exactly the same as filing a <link981Filing a wishlist report for &kubuntu; is exactly the same as filing a <link
937linkend="filing-non-crash-lp">non-crash Launchpad bug report</link>.982linkend="filing-non-crash-lp">non-crash <trademark>Launchpad</trademark> bug
983report</link>.
938</para>984</para>
939</sect2>985</sect2>
940</sect1>986</sect1>
941987
=== modified file 'docs/cli/C/cli.xml'
--- docs/cli/C/cli.xml 2011-09-04 21:26:14 +0000
+++ docs/cli/C/cli.xml 2012-03-22 07:41:34 +0000
@@ -13,9 +13,9 @@
13&legalnotice;13&legalnotice;
14<abstract>14<abstract>
15<para>15<para>
16This document provides a brief description of the Linux command line. It is not16This document provides a brief description of the <trademark>Linux</trademark>
17a complete guide to the command line, but rather an introduction to complement17command line. It is not a complete guide, but rather an introduction to
18&kubuntu;&apos;s graphical tools.18complement &kubuntu;'s graphical tools.
19</para>19</para>
20</abstract>20</abstract>
21</articleinfo>21</articleinfo>
@@ -25,37 +25,41 @@
2525
26<para>26<para>
27<emphasis>27<emphasis>
28"Under Linux there are GUIs (graphical user interfaces), where you can point and28"Under <trademark>Linux</trademark> there are <acronym>GUI</acronym>s
29click and drag, and hopefully get work done without first reading lots of29(graphical user interfaces), where you can point and click and drag and
30documentation. The traditional Unix environment is a CLI (command line30hopefully get work done without first reading lots of documentation. The
31interface), where you type commands to tell the computer what to do. That is31traditional <trademark>Unix</trademark> environment is a
32faster and more powerful, but requires finding out what the commands are." --32<acronym>CLI</acronym> (command line interface), where you type commands to
33from <emphasis role="strong">man intro(1)</emphasis>33tell the computer what to do. That is faster and more powerful, but requires
34finding out what the commands are." -- from <emphasis>man intro(1)</emphasis>
34</emphasis>35</emphasis>
35</para>36</para>
36<para>37<para>
37This guide describes some basic GNU/Linux shell commands. It is not intended to38This guide describes some basic <trademark>GNU</trademark>/
38be a complete guide to the command line, just an introduction to complement39<trademark>Linux</trademark> shell commands. It is not intended to be a
39&kubuntu;&apos;s graphical tools.40complete guide to the command line, just an introduction to complement
41&kubuntu;'s graphical tools.
40</para>42</para>
41<para>43<para>
42<itemizedlist>44<itemizedlist>
43<listitem>45<listitem>
44<para>46<para>
45All command names, file names or paths to directories will be shown using a <command>monospace font</command>.47All command names, file names, or paths to directories will be shown using a
48<command>monospace font</command>.
46</para>49</para>
47</listitem>50</listitem>
48<listitem>51<listitem>
49<para>52<para>
50The commands should be issued from a command prompt within a53The commands should be issued from a command prompt within a
51<application>Terminal</application> and will be shown as:54<application>Terminal</application> and will be shown as:
52<screen>command to type</screen>55<screen>command to type</screen>
53</para>56</para>
54</listitem>57</listitem>
55<listitem>58<listitem>
56<para>59<para>
57<emphasis role="strong">Command Line Linux is case sensitive.</emphasis> User,60<emphasis>Command Line <trademark>Linux</trademark> is case
58user, and USER are each different and distinct in Linux.61sensitive.</emphasis> User, user, and USER are each different and distinct in
62<trademark>Linux</trademark>.
59</para>63</para>
60</listitem>64</listitem>
61</itemizedlist>65</itemizedlist>
@@ -65,12 +69,12 @@
65<sect1 id="terminal">69<sect1 id="terminal">
66<title>Starting A Terminal</title>70<title>Starting A Terminal</title>
67<para>71<para>
68&kubuntu;&apos;s Terminal application is called72&kubuntu;'s Terminal application is called <application>Konsole</application>,
69<application>Konsole</application>, and is opened by going to &menukonsole;.73and is opened by going to &menukonsole;.
70</para>74</para>
71<para>75<para>
72<example>76<example>
73<title>&kubuntu;&apos;s terminal - Konsole</title>77<title>&kubuntu;'s terminal - Konsole</title>
74<mediaobject>78<mediaobject>
75<imageobject>79<imageobject>
76<imagedata fileref="help:/images/C/C/konsole.png" format="PNG"/>80<imagedata fileref="help:/images/C/C/konsole.png" format="PNG"/>
@@ -86,12 +90,10 @@
86<sect2 id="pwd">90<sect2 id="pwd">
87<title>pwd - print working directory</title>91<title>pwd - print working directory</title>
88<para>92<para>
89The <command>pwd</command> command displays the directory where the user is93The <command>pwd</command> command displays the directory where the user is
90currently94currently located. (<acronym>pwd</acronym> stands for <quote>print working
91located. (<acronym>pwd</acronym> stands for <quote>print working95directory</quote>). For example, typing <screen>pwd</screen> while in the
92directory</quote>). For example, typing 96<filename class="directory">Desktop</filename> directory will show
93<screen>pwd</screen> while in the <filename
94class="directory">Desktop</filename> will show
95<computeroutput>/home/[username]/Desktop</computeroutput>.97<computeroutput>/home/[username]/Desktop</computeroutput>.
96<note>98<note>
97<para>99<para>
@@ -105,9 +107,9 @@
105<title>cd - change directory</title>107<title>cd - change directory</title>
106<para>108<para>
107The <command>cd</command> command changes directories. (<acronym>cd</acronym>109The <command>cd</command> command changes directories. (<acronym>cd</acronym>
108stands for110stands for <quote>change directory</quote>). When a terminal window is opened,
109<quote>change directory</quote>). When a terminal window is opened, it will be in the user's home directory. Moving around the file system requires the111it will be in the user's home directory. Moving around the file system requires
110use of the <command>cd</command>.112the use of the <command>cd</command> command.
111</para>113</para>
112<itemizedlist>114<itemizedlist>
113<listitem>115<listitem>
@@ -125,8 +127,8 @@
125</para>127</para>
126<note>128<note>
127<para>129<para>
128The <command>~</command> character represents the current user's home directory.130The <command>~</command> character represents the current user's home
129As shown above, <command>cd ~</command> is equivalent to <command>cd131directory. As shown above, <command>cd ~</command> is equivalent to <command>cd
130/home/username/</command>. However, when running a command as root (using132/home/username/</command>. However, when running a command as root (using
131<command>sudo</command>, for example), <command>~</command> points to <filename133<command>sudo</command>, for example), <command>~</command> points to <filename
132class="directory">/root</filename>. When running a <command>cd</command> command134class="directory">/root</filename>. When running a <command>cd</command> command
@@ -161,8 +163,8 @@
161of <filename class="directory">/var/</filename>. For another example, typing:163of <filename class="directory">/var/</filename>. For another example, typing:
162<screen>cd ~/Desktop</screen> 164<screen>cd ~/Desktop</screen>
163moves to the <filename165moves to the <filename
164class="directory">Desktop</filename> subdirectory inside the current user's home166class="directory">Desktop</filename> subdirectory inside the current user's
165directory.167home directory.
166</para>168</para>
167</listitem>169</listitem>
168</itemizedlist>170</itemizedlist>
@@ -171,11 +173,9 @@
171<title>ls - list files</title>173<title>ls - list files</title>
172<para>174<para>
173The <command>ls</command> command outputs a list of the files in the current175The <command>ls</command> command outputs a list of the files in the current
174directory. (<acronym>ls</acronym> is short for <quote>list</quote>). For example,176directory. (<acronym>ls</acronym> is short for <quote>list</quote>). For
175typing 177example, typing <screen>ls ~</screen> will display the files that are in the
176<screen>ls ~</screen> 178current user's home directory.
177will display the files that are in the current
178user's home directory.
179</para>179</para>
180<para>180<para>
181Used with the <command>-l</command> option, <command>ls</command> outputs other181Used with the <command>-l</command> option, <command>ls</command> outputs other
@@ -185,34 +185,34 @@
185<para>185<para>
186Used with the <command>-al</command> options, <command>ls</command> outputs186Used with the <command>-al</command> options, <command>ls</command> outputs
187the information associated with the <command>-l</command> option in addition to187the information associated with the <command>-l</command> option in addition to
188showing hidden files (<command>a</command>188showing hidden files (<command>a</command> option).
189option).
190</para>189</para>
191</sect2>190</sect2>
192<sect2 id="touch">191<sect2 id="touch">
193<title>touch - create empty file</title>192<title>touch - create empty file</title>
194<para>193<para>
195The <command>touch</command> command is used either to change a file's access194The <command>touch</command> command is used to change a file's access and
196and modification timestamps or to create a new empty file. For example,195modification timestamps or to create a new empty file. For example,
197<screen>touch foo</screen>196<screen>touch foo</screen> will create a new empty file named
198will create a new empty file named <filename>foo</filename>. If197<filename>foo</filename>. If <filename>foo</filename> is already a file, then
199<filename>foo</filename> is already a file, then using <command>touch</command>198using <command>touch</command> will update the timestamps on the file, which
200will update the timestamps on the file which will show199show the last time a file was <emphasis>touched</emphasis>.
201the last time a file was <emphasis>touched</emphasis>.
202</para>200</para>
203</sect2>201</sect2>
204<sect2 id="mkdir">202<sect2 id="mkdir">
205<title>mkdir - make directory</title>203<title>mkdir - make directory</title>
206<para>204<para>
207The <command>mkdir</command> command is used to create a new directory. (<acronym>mkdir</acronym> stands for <quote>make directory</quote>). To create a205The <command>mkdir</command> command is used to create a new directory.
208new directory named <filename class="directory">foobar</filename>, type:206(<acronym>mkdir</acronym> stands for <quote>make directory</quote>). To create
207a new directory named <filename class="directory">foobar</filename>, type:
209<screen>mkdir foobar</screen>208<screen>mkdir foobar</screen>
210</para>209</para>
211</sect2>210</sect2>
212<sect2 id="cp">211<sect2 id="cp">
213<title>cp - copy files or directories</title>212<title>cp - copy files or directories</title>
214<para>213<para>
215The <command>cp</command> command makes a copy of a file or directory. (<acronym>cp</acronym> is short for <quote>copy</quote>). To make an exact copy214The <command>cp</command> command makes a copy of a file or directory.
215(<acronym>cp</acronym> is short for <quote>copy</quote>). To make an exact copy
216of <filename>foo</filename> and name it <filename>bar</filename>, type:216of <filename>foo</filename> and name it <filename>bar</filename>, type:
217<screen>cp foo bar</screen>217<screen>cp foo bar</screen>
218To make an exact copy of the <filename class="directory">foo_dir</filename>218To make an exact copy of the <filename class="directory">foo_dir</filename>
@@ -224,34 +224,32 @@
224<title>mv - move files or directories</title>224<title>mv - move files or directories</title>
225<para>225<para>
226The <command>mv</command> command moves a file or directory to a different226The <command>mv</command> command moves a file or directory to a different
227location or will rename a file or directory. (<acronym>mv</acronym> is short for227location or renames a file or directory. (<acronym>mv</acronym> is short for
228<quote>move</quote>). To rename the file <filename>foo</filename> to228<quote>move</quote>). To rename the file <filename>foo</filename> to
229<filename>bar</filename>, type: 229<filename>bar</filename>, type: <screen>mv foo bar</screen> To move the file
230<screen>mv foo bar</screen>230<filename>foo</filename> into the current user's <filename
231To move the file <filename>foo</filename> into the current user's <filename231class="directory">Desktop</filename> directory, type: <screen>mv foo
232class="directory">Desktop</filename> directory, type:232~/Desktop</screen> This will not rename <filename>foo</filename> to
233<screen>mv foo ~/Desktop</screen>233<filename>Desktop</filename>, because <filename>foo</filename> is a file and
234This will not rename <filename>foo</filename> to <filename>Desktop</filename>234<filename class="directory">Desktop</filename> is a directory.
235because <filename>foo</filename> is a file and <filename
236class="directory">Desktop</filename> is a directory.
237</para>235</para>
238</sect2>236</sect2>
239<sect2 id="rm">237<sect2 id="rm">
240<title>rm - remove files or directories</title>238<title>rm - remove files or directories</title>
241<para>239<para>
242The <command>rm</command> command is used to delete files and directories. (<acronym>rm</acronym> is short for <quote>remove</quote>). To delete the file240The <command>rm</command> command is used to delete files and directories.
243<filename>foo</filename> for the current directory, type: 241(<acronym>rm</acronym> is short for <quote>remove</quote>). To delete the file
242<filename>foo</filename> from the current directory, type:
244<screen>rm foo</screen>243<screen>rm foo</screen>
245</para>244</para>
246<para>245<para>
247By default, <command>rm</command> will not remove directories. To remove a246By default, <command>rm</command> will not remove directories. To remove a
248directory, you must use the <command>-r</command> option (also can be entered247directory, you must use the <command>-r</command> option (which can also be
249as either <command>-R</command> or <command>--recursive</command>). For example,248entered as <command>-R</command> or <command>--recursive</command>). For
250<screen>rm -r foobar</screen> or 249example, <screen>rm -r foobar</screen> or <screen>rm -R foobar</screen> or
251<screen>rm -R foobar</screen> or 250<screen>rm --recursive foobar</screen> will remove the directory
252<screen>rm --recursive foobar</screen> 251<filename class="directory">foobar</filename> <emphasis> and all of its
253will remove the directory <filename class="directory">foobar</filename>,252contents!</emphasis>
254<emphasis role="strong"> and all of its contents!</emphasis>
255</para>253</para>
256</sect2>254</sect2>
257255
@@ -265,8 +263,7 @@
265<para>263<para>
266The <command>df</command> command displays filesystem disk space usage for all264The <command>df</command> command displays filesystem disk space usage for all
267partitions. (<acronym>df</acronym> stands for <quote>disk free</quote>).265partitions. (<acronym>df</acronym> stands for <quote>disk free</quote>).
268<screen>df -h</screen> 266<screen>df -h</screen> will give information using megabytes
269will give information using megabytes
270(<abbrev>M</abbrev>) and gigabytes (<abbrev>G</abbrev>) instead of blocks267(<abbrev>M</abbrev>) and gigabytes (<abbrev>G</abbrev>) instead of blocks
271(<command>-h</command> means <quote>human readable</quote>).268(<command>-h</command> means <quote>human readable</quote>).
272</para>269</para>
@@ -275,26 +272,24 @@
275<title>free - display amount of free and used memory</title>272<title>free - display amount of free and used memory</title>
276<para>273<para>
277The <command>free</command> command displays the amount of free and used memory274The <command>free</command> command displays the amount of free and used memory
278in the system.275in the system. <screen>free -m</screen> will give the information using
279<screen>free -m</screen>276megabytes, which is probably the most useful for current computers.
280will give the information using megabytes, which is probably the most useful for
281current computers.
282</para>277</para>
283</sect2>278</sect2>
284<sect2 id="top">279<sect2 id="top">
285<title>top - display top consuming processes</title>280<title>top - display top consuming processes</title>
286<para>281<para>
287The <command>top</command> command displays information on the Linux system -282The <command>top</command> command displays information on the
288processes that are running, system resources including <acronym>CPU</acronym>,283<trademark>Linux</trademark> system - processes that are running, system
289<acronym>RAM</acronym> &amp; swap usage, and the total number of tasks being284resources including <acronym>CPU</acronym>, <acronym>RAM</acronym> &amp; swap
290run. To285usage, and the total number of tasks being run. To exit <command>top</command>,
291exit <command>top</command>, press <keycap>q</keycap>.286press <keycap>q</keycap>.
292</para>287</para>
293</sect2>288</sect2>
294<sect2 id="uname">289<sect2 id="uname">
295<title>uname - print details about the current machine</title>290<title>uname - print details about the current machine</title>
296<para>291<para>
297The <command>uname</command> command with the <command>-a</command> options292The <command>uname</command> command with the <command>-a</command> option
298displays all system information, including machine name, kernel name &amp;293displays all system information, including machine name, kernel name &amp;
299version, and other details. This command is useful for checking which kernel is294version, and other details. This command is useful for checking which kernel is
300in use. (<abbrev>uname</abbrev> is short for <quote>unix name</quote>).295in use. (<abbrev>uname</abbrev> is short for <quote>unix name</quote>).
@@ -304,8 +299,8 @@
304<title>lsb_release - print details about current Linux release</title>299<title>lsb_release - print details about current Linux release</title>
305<para>300<para>
306The <command>lsb_release</command> with the <command>-a</command> option prints301The <command>lsb_release</command> with the <command>-a</command> option prints
307version information for the Linux release in use. For example, typing:302version information for the <trademark>Linux</trademark> release in use. For
308<screen>lsb_release -a</screen> will display:303example, typing: <screen>lsb_release -a</screen> will display:
309<screen>No LSB modules are available.304<screen>No LSB modules are available.
310Distributor ID: Ubuntu305Distributor ID: Ubuntu
311Description: Ubuntu &distro-rev;306Description: Ubuntu &distro-rev;
@@ -323,49 +318,41 @@
323The following commands must be prefaced with the318The following commands must be prefaced with the
324<command>sudo</command> command. Please see <ulink319<command>sudo</command> command. Please see <ulink
325url="https://help.ubuntu.com/community/RootSudo">RootSudo</ulink> for320url="https://help.ubuntu.com/community/RootSudo">RootSudo</ulink> for
326information on using <command>sudo</command>. (<abbrev>sudo</abbrev> is short for321information on using <command>sudo</command>. (<abbrev>sudo</abbrev> is short
327<quote>superuser do</quote>).322for <quote>superuser do</quote>).
328</para>323</para>
329<sect2 id="add-group">324<sect2 id="add-group">
330<title>Adding a New Group</title>325<title>Adding a New Group</title>
331<para>326<para>
332The <command>addgroup</command> command is used to create a new group in the327The <command>addgroup</command> command is used to create a new group in the
333system. To create a new group, type:328system. To create a new group, type: <screen>sudo addgroup foobar</screen> The
334<screen>sudo addgroup foobar</screen>329above command will create a new group called <emphasis>foobar</emphasis>.
335The above command will create a new group called <emphasis
336role="strong">foobar</emphasis>.
337</para>330</para>
338</sect2>331</sect2>
339<sect2 id="add-user">332<sect2 id="add-user">
340<title>Adding a New User</title>333<title>Adding a New User</title>
341<para>334<para>
342The <command>adduser</command> command is used to create a new user on the335The <command>adduser</command> command is used to create a new user on the
343system. To create a new user, type:336system. To create a new user, type: <screen>adduser foobar</screen> which will
344<screen>adduser foobar</screen>337create a new user called <emphasis>foobar</emphasis>.
345which will create a new user called <emphasis role="strong">foobar</emphasis>.
346</para>338</para>
347</sect2>339</sect2>
348<sect2 id="passwd">340<sect2 id="passwd">
349<title>Add or Change a User Password</title>341<title>Add or Change a User Password</title>
350<para>342<para>
351The <command>passwd</command> command is used to assign a new password to a343The <command>passwd</command> command is used to assign a new password to a
352new user or to change the current password for an existing user. To add a344new user or change the current password for an existing user. To add a password
353password or change the password for the user <emphasis345or change the password for the user <emphasis>foobar</emphasis>, type:
354role="strong">foobar</emphasis>,346<screen>passwd foobar</screen> For new users, this will generate a prompt to
355type:347enter the new password. For an existing user, there will be a prompt for the
356<screen>passwd foobar</screen>348existing password before the prompt for a new password.
357For new users, this will generate a prompt to enter the new password. For
358an
359existing user, there will be a prompt for the existing password before the
360prompt for a new password.
361</para>349</para>
362</sect2>350</sect2>
363<sect2 id="assign-user-group">351<sect2 id="assign-user-group">
364<title>Assign User to Group</title>352<title>Assign User to Group</title>
365<para>353<para>
366To assign the user <emphasis role="strong">foobar</emphasis> to the group354To assign the user <emphasis>foobar</emphasis> to the group
367<emphasis role="strong">barfoo</emphasis>, type:355<emphasis>barfoo</emphasis>, type: <screen>adduser foobar barfoo</screen>
368<screen>adduser foobar barfoo</screen>
369</para>356</para>
370</sect2>357</sect2>
371</sect1>358</sect1>
@@ -374,20 +361,20 @@
374<sect1 id="options">361<sect1 id="options">
375<title>Options</title>362<title>Options</title>
376<para>363<para>
377The default behavior for a command may usually be modified by adding <command>--option</command> to the command. For example, the <link364The default behavior for a command may usually be modified by adding
378linkend="ls"><command>ls</command></link> command has an365<command>--option</command> to the command. For example, the <link
379<command>-s</command> option. The <command>ls -s</command> will include file366linkend="ls"><command>ls</command></link> command has an <command>-s</command>
380sizes in the listing. There is also a <command>-h</command> option to display367option. The <command>ls -s</command> will include file sizes in the listing.
381file sizes in a <quote>human readable</quote> format.368There is also a <command>-h</command> option to display file sizes in a
369<quote>human readable</quote> format.
382</para>370</para>
383<para>371<para>
384Options can be grouped in clusters, so372Options can be grouped in clusters, so
385<screen>ls -sh</screen>373<screen>ls -sh</screen>
386is the same command as374is the same command as
387<screen> ls -s -h</screen>375<screen> ls -s -h</screen>
388Most options have a long version, prefixed with two dashes instead of one, so376Most options have a long version prefixed with two dashes instead of one, so
389<screen>ls --size --human-readable</screen>377<screen>ls --size --human-readable</screen> is the same command as
390is also the same command as
391<screen>ls -sh</screen>378<screen>ls -sh</screen>
392</para>379</para>
393</sect1>380</sect1>
@@ -396,14 +383,13 @@
396<sect1 id="man-help">383<sect1 id="man-help">
397<title><quote>Man</quote> and Getting Help</title>384<title><quote>Man</quote> and Getting Help</title>
398<para>385<para>
399<emphasis role="strong"><emphasis>command</emphasis> --help</emphasis> and386<emphasis><emphasis>command</emphasis> --help</emphasis> and
400<command>man</command> <emphasis387<command>man</command> <emphasis>command</emphasis> are the two most important
401role="strong"><emphasis>command</emphasis></emphasis> are the two most important
402tools at the command line.388tools at the command line.
403</para>389</para>
404<para>390<para>
405Virtually all commands understand the <command>-h</command> (or391Virtually all commands understand the <command>-h</command> (or
406<command>--help</command>) option which will produce a short usage description392<command>--help</command>) option, which will produce a short usage description
407of the command and its options, then exit back to the command prompt. Type:393of the command and its options, then exit back to the command prompt. Type:
408<screen>man -h</screen>394<screen>man -h</screen>
409or395or
@@ -411,33 +397,29 @@
411to see this in action.397to see this in action.
412</para>398</para>
413<para>399<para>
414Every command and nearly every application in Linux has a400Every command and nearly every application in <trademark>Linux</trademark> has
415<abbrev>man</abbrev> (manual) file. It is as simple as typing <command>man401a <abbrev>man</abbrev> (manual) file. It is as simple as typing <command>man
416command</command> to bring up a longer manual entry for the specified command.402command</command> to bring up a longer manual entry for the specified command.
417For example:403For example: <screen>man mv</screen> brings up the <command>mv</command>
418<screen>man mv</screen>404manual.
419brings up the <command>mv</command> manual.
420</para>405</para>
421<para>406<para>
422Move up and down the man file with the arrow keys, and quit back to the command407Move up and down the man file with the arrow keys, and quit back to the command
423prompt with <keycap>q</keycap>.408prompt with <keycap>q</keycap>.
424</para>409</para>
425<para>410<para>
426<screen>man man</screen>411<screen>man man</screen> brings up the manual entry for the
427brings up the manual entry for the <command>man</command> command, which is a412<command>man</command> command, which is a good place to start.
428good place to start.
429</para>413</para>
430<para>414<para>
431<screen>man intro</screen>415<screen>man intro</screen> is especially useful. It displays the
432is especially useful. It displays the <quote>introduction to user416<quote>introduction to user commands</quote> which is a well-written, brief
433commands</quote> which is a well-written, brief introduction to the Linux417introduction to the <trademark>Linux</trademark> command line.
434command line.
435</para>418</para>
436<para>419<para>
437There are also <command>info</command> pages, which generally go into more420There are also <command>info</command> pages, which generally go into more
438detail than <command>man</command> pages. Try:421detail than <command>man</command> pages. Try: <screen>info info</screen> for
439<screen>info info</screen>422the introduction to info pages.
440for the introduction to info pages.
441</para>423</para>
442<sect2 id="searching-for-man-files">424<sect2 id="searching-for-man-files">
443<title>Searching for man files</title>425<title>Searching for man files</title>
@@ -473,14 +455,14 @@
473There are often situations that require text to be pasted into the terminal.455There are often situations that require text to be pasted into the terminal.
474</para>456</para>
475<para>457<para>
476Text copied from a web page using458Text copied from a web page using
477<keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> won't paste with459<keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> won't paste with
478<keycombo><keycap>Ctrl</keycap><keycap>V</keycap></keycombo> as it does in460<keycombo><keycap>Ctrl</keycap><keycap>V</keycap></keycombo> as it does in
479other applications because the461other applications, because the terminal uses the
480terminal uses a different combination for paste,462<keycombo><keycap>Shift</keycap><keycap>Insert</keycap></keycombo>
481<keycombo><keycap>Shift</keycap><keycap>Insert</keycap></keycombo>. Pasting can463combination. Pasting can also be done using the mouse by
482also be done using the mouse by <mousebutton>right-clicking</mousebutton> in464<mousebutton>right-clicking</mousebutton> in the terminal and selecting
483the terminal and selecting <guimenuitem>Paste</guimenuitem> from the menu.465<guimenuitem>Paste</guimenuitem> from the menu.
484</para>466</para>
485<para>467<para>
486Text can also be copied by selecting (highlighting) the text to be copied.468Text can also be copied by selecting (highlighting) the text to be copied.
@@ -490,8 +472,9 @@
490</para>472</para>
491<note>473<note>
492<para>474<para>
493These actions may work differently in other terminal emulators than <application>Konsole</application>.475These actions may work differently in other terminal emulators than
494Consult your terminal emulator's documentation for details.476<application>Konsole</application>. Consult your terminal emulator's
477documentation for details.
495</para>478</para>
496</note>479</note>
497</sect1>480</sect1>
@@ -507,7 +490,7 @@
507</term>490</term>
508<listitem>491<listitem>
509<para>492<para>
510Scrolls backwards through the commands entered previously493Scrolls backwards through the commands entered previously.
511</para>494</para>
512</listitem>495</listitem>
513</varlistentry>496</varlistentry>
@@ -518,7 +501,7 @@
518</term>501</term>
519<listitem>502<listitem>
520<para>503<para>
521Scrolls forward through previous commands504Scrolls forward through previous commands.
522</para>505</para>
523</listitem>506</listitem>
524</varlistentry>507</varlistentry>
@@ -528,7 +511,7 @@
528</term>511</term>
529<listitem>512<listitem>
530<para>513<para>
531Executes the command selected514Executes the selected command.
532</para>515</para>
533</listitem>516</listitem>
534</varlistentry>517</varlistentry>
@@ -539,7 +522,7 @@
539<listitem>522<listitem>
540<para>523<para>
541Tab is a useful feature. It autocompletes any commands or filenames if there is524Tab is a useful feature. It autocompletes any commands or filenames if there is
542one option, otherwise it displays a list of options that fit the information525one option. Otherwise it displays a list of options that fit the information
543entered. Using tab in this way reduces typing errors.526entered. Using tab in this way reduces typing errors.
544</para>527</para>
545</listitem>528</listitem>
@@ -567,7 +550,7 @@
567</term>550</term>
568<listitem>551<listitem>
569<para>552<para>
570Moves the cursor to the <emphasis>start</emphasis> of the line553Moves the cursor to the <emphasis>start</emphasis> of the line.
571</para>554</para>
572</listitem>555</listitem>
573</varlistentry>556</varlistentry>
@@ -578,7 +561,7 @@
578</term>561</term>
579<listitem>562<listitem>
580<para>563<para>
581Moves the cursor to the <emphasis>end</emphasis> of the line564Moves the cursor to the <emphasis>end</emphasis> of the line.
582</para>565</para>
583</listitem>566</listitem>
584</varlistentry>567</varlistentry>
@@ -588,7 +571,7 @@
588</term>571</term>
589<listitem>572<listitem>
590<para>573<para>
591Deletes from the current cursor position to the end of the line574Deletes from the current cursor position to the end of the line.
592</para>575</para>
593</listitem>576</listitem>
594</varlistentry>577</varlistentry>
@@ -598,7 +581,7 @@
598</term>581</term>
599<listitem>582<listitem>
600<para>583<para>
601Deletes the entire current line584Deletes the entire current line.
602</para>585</para>
603</listitem>586</listitem>
604</varlistentry>587</varlistentry>
@@ -608,7 +591,7 @@
608</term>591</term>
609<listitem>592<listitem>
610<para>593<para>
611Deletes the word before the cursor594Deletes the word before the cursor.
612</para>595</para>
613</listitem>596</listitem>
614</varlistentry>597</varlistentry>
@@ -624,8 +607,8 @@
624<itemizedlist>607<itemizedlist>
625<listitem>608<listitem>
626<para>609<para>
627<ulink url="https://help.ubuntu.com/community/AptGetHowto">AptGetHowto</ulink> -610<ulink url="https://help.ubuntu.com/community/AptGetHowto">AptGetHowto</ulink>
628using <command>apt-get</command> to install packages from the command line.611- using <command>apt-get</command> to install packages from the command line.
629</para>612</para>
630</listitem>613</listitem>
631<listitem>614<listitem>
@@ -653,25 +636,26 @@
653<para>636<para>
654<ulink url="https://help.ubuntu.com/community/CommandlineHowto">Commandline637<ulink url="https://help.ubuntu.com/community/CommandlineHowto">Commandline
655Howto</ulink> - longer and more complete than this basic guide; still not638Howto</ulink> - longer and more complete than this basic guide; still not
656finished however.639finished, however.
657</para>640</para>
658</listitem>641</listitem>
659<listitem>642<listitem>
660<para>643<para>
661<ulink url="https://help.ubuntu.com/community/HowToReadline">Howto644<ulink url="https://help.ubuntu.com/community/HowToReadline">Howto
662Readline</ulink> - information on more advanced customization for the645Readline</ulink> - information on more advanced customization for the command
663command line.646line.
664</para>647</para>
665</listitem>648</listitem>
666</itemizedlist>649</itemizedlist>
667<para>650<para>
668For more detailed tutorials on the Linux command line, please see:651For more detailed tutorials on the <trademark>Linux</trademark> command line,
652please see:
669</para>653</para>
670<itemizedlist>654<itemizedlist>
671<listitem>655<listitem>
672<para>656<para>
673<ulink url="http://ss64.com/bash/"/> - an A-Z index of the Bash command line for657<ulink url="http://ss64.com/bash/"/> - an A-Z index of the
674Linux.658<trademark>Bash</trademark> command line for <trademark>Linux</trademark>.
675</para>659</para>
676</listitem>660</listitem>
677<listitem>661<listitem>
@@ -682,19 +666,20 @@
682</listitem>666</listitem>
683<listitem>667<listitem>
684<para>668<para>
685<ulink url="http://linuxsurvival.com/index.php" /> - Java-based tutorials.669<ulink url="http://linuxsurvival.com/index.php" /> -
670<trademark>Java</trademark>-based tutorials.
686</para>671</para>
687</listitem>672</listitem>
688<listitem>673<listitem>
689<para>674<para>
690<ulink url="http://rute.2038bug.com/index.html.gz"/> - a massive online book675<ulink url="http://rute.2038bug.com/index.html.gz"/> - a massive online book
691about system administration, almost all from the command line.676about system administration &mdash; almost all from the command line.
692</para>677</para>
693</listitem>678</listitem>
694<listitem>679<listitem>
695<para>680<para>
696<ulink url="http://www.commandlinefu.com/"/> - a place to record command-line681<ulink url="http://www.commandlinefu.com/"/> - a place to record command line
697favorites and view other's gems as well.682favorites and view others' gems as well.
698</para>683</para>
699</listitem>684</listitem>
700</itemizedlist>685</itemizedlist>
701686
=== modified file 'docs/security/C/security.xml'
--- docs/security/C/security.xml 2010-03-26 21:38:03 +0000
+++ docs/security/C/security.xml 2012-03-22 07:41:34 +0000
@@ -70,24 +70,25 @@
70Keyboard shortcuts can be changed in <application>System Settings</application>70Keyboard shortcuts can be changed in <application>System Settings</application>
71under the <guilabel>Keyboard &amp; Mouse</guilabel>. To access these settings,71under the <guilabel>Keyboard &amp; Mouse</guilabel>. To access these settings,
72go to Menu Bread Crumbs. Select <guilabel>Global Keyboard Shortcuts</guilabel>,72go to Menu Bread Crumbs. Select <guilabel>Global Keyboard Shortcuts</guilabel>,
73in the KDE component dropdown, select <guilabel>Run Command Interface</guilabel>73in the <trademark>KDE</trademark> component drop-down, select <guilabel>Run
74and locate <guilabel>Lock Session</guilabel>.74Command Interface</guilabel>, and locate <guilabel>Lock Session</guilabel>.
75</para>75</para>
76</note>76</note>
7777
78<note><title>Adding a lock screen button to the panel</title>78<note><title>Adding a lock screen button to the panel</title>
79<para>79<para>
80A <guibutton>Lock Screen</guibutton> button can be added to the80A <guibutton>Lock Screen</guibutton> button can be added to the
81<application>Panel</application> for quick and easy screen locking. Right-click81<application>Panel</application> for quick and easy screen locking.
82the <application>Panel</application>, select <guibutton>Add82<mousebutton>Right-click</mousebutton> the <application>Panel</application>,
83Widgets...</guibutton>, select <guibutton>Lock/Logout</guibutton> and drag it83select <guibutton>Add Widgets...</guibutton>, select
84to the proper location on the Panel.84<guibutton>Lock/Logout</guibutton>, and drag it to the proper location on the
85<application>Panel</application>.
85</para>86</para>
86</note>87</note>
8788
88<para>89<para>
89To unlock the screen, move the mouse or press a key. Enter the password, and90To unlock the screen, move the mouse or press a key. Enter the password, and
90either press the <keycap>Return</keycap> key or press the91either press the <keycap>Return</keycap> key or press the
91<guibutton>Unlock</guibutton> button.92<guibutton>Unlock</guibutton> button.
92</para>93</para>
93<para>94<para>
@@ -105,17 +106,17 @@
105106
106<para>107<para>
107<application>Guarddog</application> is the firewall of choice for &kubuntu;.108<application>Guarddog</application> is the firewall of choice for &kubuntu;.
108Please review the <ulink type="help"109Please review the <ulink type="help"
109url="help:/kubuntu/network/">Networking</ulink>110url="help:/kubuntu/network/">Networking</ulink> documentation and locate the
110documentation and locate the <application>Guarddog</application> section.111<application>Guarddog</application> section.
111</para>112</para>
112</sect1>113</sect1>
113114
114<sect1 id="keep-safe-avoid-internet-crime" status="complete">115<sect1 id="keep-safe-avoid-internet-crime" status="complete">
115<title>Avoid Internet nuisances and crime</title>116<title>Avoid Internet nuisances and crime</title>
116117
117<para>From time to time, email messages carry viruses or links to fraudulent118<para>From time to time email messages carry viruses or links to fraudulent
118websites. It is important to learn how to deal with these messages, in order to119web sites. It is important to learn how to deal with these messages in order to
119prevent the computer or personal information from being compromised or misused.120prevent the computer or personal information from being compromised or misused.
120</para>121</para>
121122
@@ -131,20 +132,20 @@
131<itemizedlist>132<itemizedlist>
132<listitem>133<listitem>
133<para>134<para>
134Spam (junk) email with offers for unwanted services and products135Spam (junk) email with offers for unwanted services and products.
135</para>136</para>
136</listitem>137</listitem>
137138
138<listitem>139<listitem>
139<para>140<para>
140Scam emails asking for help in exchange for money141Scam emails asking for help in exchange for money.
141</para>142</para>
142</listitem>143</listitem>
143144
144<listitem>145<listitem>
145<para>146<para>
146Phishing email that appears to be from a bank or other online service, asking147Phishing email, that appears to be from a bank or other online service, asking
147for personal and financial details, or passwords148for personal and financial details or passwords.
148</para>149</para>
149</listitem>150</listitem>
150</itemizedlist>151</itemizedlist>
@@ -159,7 +160,7 @@
159160
160<listitem>161<listitem>
161<para>162<para>
162Never click on links in emails that lead to websites asking for passwords or163Never click on links in emails that lead to web sites asking for passwords or
163similar information. It is possible for the text of the link to show one164similar information. It is possible for the text of the link to show one
164address, but clicking on the link actually connects to a different (possibly165address, but clicking on the link actually connects to a different (possibly
165dangerous) address. Instead of clicking a potentially misleading link, type the166dangerous) address. Instead of clicking a potentially misleading link, type the
@@ -169,22 +170,22 @@
169170
170<listitem>171<listitem>
171<para>172<para>
172When visiting a website that asks for financial information, ensure that it is173When visiting a web site that asks for financial information, ensure that it is
173secure. <application>Konqueror</application> and174secure. <application>Konqueror</application> and
174<application>Firefox</application> are two browsers commonly used in &kubuntu;.175<application>Firefox</application> are two browsers commonly used in &kubuntu;.
175Both have two areas that indicate if the current page is secure. On secure176Both have two areas that indicate if the current page is secure. On secure web
176webpages, the address bar will have a yellow background and a lock177pages, the address bar will have a yellow background and a lock symbol to the
177symbol to the right of the address. The second area is the status bar located at178right of the address. The second area is the status bar located at the bottom
178the bottom right of the browser window. If the page is secure, a lock icon will179right of the browser window. If the page is secure, a lock icon will appear in
179appear in this area. Clicking on either of the lock symbols will produce a180this area. Clicking on either of the lock symbols will produce a dialog that
180dialog that explains the type of licensing and security for that page.181explains the type of licensing and security for the page.
181</para>182</para>
182</listitem>183</listitem>
183184
184<listitem>185<listitem>
185<para>186<para>
186Only download and run software from trusted sources. By default, software can187Only download and run software from trusted sources. By default, software can
187only be downloaded directly from Ubuntu.188only be downloaded directly from &ubuntu;.
188</para>189</para>
189</listitem>190</listitem>
190</itemizedlist>191</itemizedlist>
@@ -196,8 +197,8 @@
196<para>197<para>
197Occasionally users lose computer information. There are many possible causes198Occasionally users lose computer information. There are many possible causes
198for such unforeseen <emphasis>data loss</emphasis>. The problem could be199for such unforeseen <emphasis>data loss</emphasis>. The problem could be
199anything from a power loss or equipment failure to accidentally deleting a file.200anything from a power loss or equipment failure to accidentally deleting a
200With regular backup copies, if a problem should occur, it may be possible201file. With regular backup copies, if a problem should occur, it may be possible
201to retrieve important files. Users are strongly encouraged to make backups.202to retrieve important files. Users are strongly encouraged to make backups.
202</para>203</para>
203<para>204<para>
@@ -206,9 +207,11 @@
206attached to the computer. Options include:207attached to the computer. Options include:
207</para>208</para>
208<itemizedlist>209<itemizedlist>
209<listitem><para>Writable CDs and DVDs</para></listitem>210<listitem><para>Writable <acronym>CD</acronym>s and <acronym>DVD</acronym>s.
210<listitem><para>External hard disks and flash memory devices</para></listitem>211</para></listitem>
211<listitem><para>Another computer on the network</para></listitem>212<listitem><para>External hard disks.</para></listitem>
213<listitem><para>Flash memory devices.</para></listitem>
214<listitem><para>Another computer on the network.</para></listitem>
212</itemizedlist>215</itemizedlist>
213<para>216<para>
214A simple way of backing up your files is to copy them manually to a safe217A simple way of backing up your files is to copy them manually to a safe
@@ -217,7 +220,7 @@
217</para>220</para>
218<para>221<para>
219Another backup method is <application>Keep</application>, an automated &kubuntu;222Another backup method is <application>Keep</application>, an automated &kubuntu;
220backup solution, preferred by many &kubuntu; veterans. To install the223backup solution preferred by many &kubuntu; veterans. To install the
221<application>Keep</application> package, please refer to the <ulink224<application>Keep</application> package, please refer to the <ulink
222type="help" url="help:/kubuntu/manage-software/">Adding Applications</ulink>225type="help" url="help:/kubuntu/manage-software/">Adding Applications</ulink>
223document for help on installing applications. Once installed,226document for help on installing applications. Once installed,
224227
=== modified file 'docs/video/C/video.xml'
--- docs/video/C/video.xml 2011-09-15 06:32:00 +0000
+++ docs/video/C/video.xml 2012-03-22 07:41:34 +0000
@@ -21,14 +21,15 @@
21<sect1 id="introduction">21<sect1 id="introduction">
22<title>Introduction</title>22<title>Introduction</title>
23<para>23<para>
24&kubuntu; comes with a video player installed by default called24&kubuntu; comes with a video player installed by default called
25<application>Dragon Player</application>. It is a simple and lightweight video25<application>Dragon Player</application>. It is a simple and light-weight video
26player that can play almost any video file (provided the necessary codecs are26player that can play almost any video file (provided the necessary codecs are
27installed). For video editing, the preferred choice is27installed). For video editing, the preferred choice is
28<application>Kino</application>, a non-linear video editor.28<application>Kino</application> &mdash; a non-linear video editor.
29<application>Kino</application> is not installed by default with &kubuntu;, but29<application>Kino</application> is not installed by default in &kubuntu;, but
30it can be easily installed from the &kubuntu; Software Center:30can be easily installed from the &kubuntu; Software Center:
31(<application>Muon</application>).31(<application>Muon</application>), which can be started by choosing
32&menusysmuon;.
32</para>33</para>
33</sect1>34</sect1>
3435
@@ -41,16 +42,20 @@
4142
42<procedure>43<procedure>
43<title>Open Files From The File Manager</title>44<title>Open Files From The File Manager</title>
44<step><para>Open the <application>Dolphin</application> file manager.</para></step>45<step><para>Open the <application>Dolphin</application> file manager.
46</para></step>
45<step><para>Navigate to the video file.</para></step>47<step><para>Navigate to the video file.</para></step>
46<step><para>Click on the file name to open it with the default video player (<application>Dragon Player</application>).</para></step>48<step><para>Click on the file name to open it with the default video player
49(<application>Dragon Player</application>).</para></step>
47</procedure>50</procedure>
4851
49<procedure>52<procedure>
50<title>Open Files From Within Dragon Player</title>53<title>Open Files From Within Dragon Player</title>
51<step><para>Open <application>Dragon Player</application>; &menudragon;</para></step>54<step><para>Open <application>Dragon Player</application>; &menudragon;</para>
52<step><para>Click on the <guibutton>Play File</guibutton> button or press <keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></para></step>55</step>
53<step><para>Navigate to the selected video file, and click56<step><para>Click on the <guibutton>Play File</guibutton> button or press
57<keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></para></step>
58<step><para>Navigate to the selected video file, and click
54<guibutton>Open</guibutton></para></step>59<guibutton>Open</guibutton></para></step>
55</procedure>60</procedure>
5661
@@ -61,11 +66,11 @@
61<title>Editing Videos</title>66<title>Editing Videos</title>
62<para>67<para>
63Video editing in &kubuntu; can be done with an application called68Video editing in &kubuntu; can be done with an application called
64<application>Kino</application> a non-linear video editor.69<application>Kino</application> &mdash; a non-linear video editor.
65<application>Kino</application> is not installed by default. It can be70<application>Kino</application> is not installed by default. It can be
66installed using <application>Muon</application> by going71installed using <application>Muon</application> by going to &menusysmuon;.
67to &menusysmuon;.</para>72</para>
68<para>Here's how to open and edit video files in73<para>Here's how to open and edit video files in
69<application>Kino</application>:74<application>Kino</application>:
70</para>75</para>
7176
@@ -84,11 +89,12 @@
84<para>To trim a video to shorten it or to export different sections:</para>89<para>To trim a video to shorten it or to export different sections:</para>
85<procedure>90<procedure>
86<title>Trimming Videos</title>91<title>Trimming Videos</title>
87<step><para>Once a video file has been imported into92<step><para>Once a video file has been imported into
88<application>Kino</application>, click on the <guibutton>Trim</guibutton>93<application>Kino</application>, click on the <guibutton>Trim</guibutton>
89button.</para></step>94button.</para></step>
90<step><para>A slider below the video preview can be used to specify the starting95<step><para>A slider below the video preview can be used to specify the
91(In Point) and the ending (Out Point) points of the trimmed video.</para></step>96starting (In Point) and the ending (Out Point) points of the trimmed video.
97</para></step>
92<step><para>Specify the starting and ending points by dragging each end of the98<step><para>Specify the starting and ending points by dragging each end of the
93slider.</para></step>99slider.</para></step>
94<step><para>After the sliders have been positioned, press the100<step><para>After the sliders have been positioned, press the
@@ -98,21 +104,20 @@
98104
99<procedure>105<procedure>
100<title>Exporting videos</title>106<title>Exporting videos</title>
101<step><para>When the editing, trimming, etc. are complete, the video is ready107<step><para>When the editing, trimming, etc., are complete, the video is ready
102to be exported. To do this, click on the <guibutton>Export</guibutton> on the108to be exported. To do this, click on the <guibutton>Export</guibutton> button
103right side of the window or go to109on the right side of the window or go to <menuchoice><guimenu>View</guimenu>
104<menuchoice><guimenu>View</guimenu><guisubmenu>Export</guisubmenu></menuchoice110<guisubmenu>Export</guisubmenu></menuchoice>.</para></step>
105>.</para></step>
106<step><para>In the Export mode, the output mode can be specified for saving the111<step><para>In the Export mode, the output mode can be specified for saving the
107edited video. Exporting to a 'DV' file maintains the quality of the video (this112edited video. Exporting to a '<acronym>DV</acronym>' file maintains the quality
108generally results in a large file).</para></step>113of the video (this generally results in a large file).</para></step>
109<step><para>To export the video to a common format such as114<step><para>To export the video to a common format such as
110<acronym>AVI</acronym>, select the 'Other' tab and specify the type of video to115<acronym>AVI</acronym>, select the 'Other' tab and specify the type of video to
111export, the quality of the output video and the location where the116export, the quality of the output video and the location the video should be
112video should be saved.</para></step>117saved to.</para></step>
113<step><para>When the settings have been customized, click on the118<step><para>When the settings have been customized, click on the
114<guibutton>Export</guibutton> button to export the file. This may take some time119<guibutton>Export</guibutton> button to export the file. This may take some
115depending on the size of file, the format, the quality selected and other120time depending on the size of file, the format, the quality selected, and other
116customization choices.</para></step>121customization choices.</para></step>
117</procedure>122</procedure>
118</sect1>123</sect1>
@@ -120,14 +125,15 @@
120<sect1 id="video-codecs">125<sect1 id="video-codecs">
121<title>Video Codecs</title>126<title>Video Codecs</title>
122<para>127<para>
123Codecs are software that allow different types of video/audio files to be128Codecs are software that allow different types of video/audio files to be
124played. Some codecs are proprietary, meaning that a license is required to use129played. Some codecs are proprietary &mdash; meaning that a license is required
125them. Some codecs are available under free licenses like GPL.130to use them. Some codecs are available under free licenses like the
131<acronym>GPL</acronym>.
126</para>132</para>
127<para>133<para>
128&kubuntu; does not come pre-installed with codecs to play proprietary formats134&kubuntu; does not come pre-installed with codecs to play proprietary formats
129like mp3, rm (Real Media) and others. The necessary codecs can be installed from135like mp3, rm (<trademark>Real Media</trademark>), and others. The necessary
130the repositories.136codecs can be installed from the repositories.
131</para>137</para>
132<para>138<para>
133For more information on which formats are supported out of the box by &kubuntu;139For more information on which formats are supported out of the box by &kubuntu;

Subscribers

People subscribed via source and target branches

to all changes: