Merge lp:~littlergirl/kubuntu-docs/security into lp:kubuntu-docs/precise
- security
- Merge into 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 |
Related bugs: |
Reviewer | Review Type | Date Requested | Status |
---|---|---|---|
Ubuntu Documentation Committers | Pending | ||
Review via email: mp+98794@code.launchpad.net |
Commit message
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
1 | === modified file 'docs/audio/C/audio.xml' | |||
2 | --- docs/audio/C/audio.xml 2011-12-30 16:40:04 +0000 | |||
3 | +++ docs/audio/C/audio.xml 2012-03-22 07:41:34 +0000 | |||
4 | @@ -22,20 +22,20 @@ | |||
5 | 22 | <title>Playing CDs</title> | 22 | <title>Playing CDs</title> |
6 | 23 | <para> | 23 | <para> |
7 | 24 | <application>Amarok</application> is the default application for playing audio | 24 | <application>Amarok</application> is the default application for playing audio |
9 | 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, |
10 | 26 | &kubuntu; will recognize it and display default options. To hear the content | 26 | &kubuntu; will recognize it and display default options. To hear the content |
11 | 27 | with <application>Amarok</application>, select <guilabel>Play Audio CD with | 27 | with <application>Amarok</application>, select <guilabel>Play Audio CD with |
12 | 28 | Amarok</guilabel> and then press the <guibutton>OK</guibutton> button. | 28 | Amarok</guilabel> and then press the <guibutton>OK</guibutton> button. |
13 | 29 | &kubuntu; can be configured to remember this choice every time | 29 | &kubuntu; can be configured to remember this choice every time |
14 | 30 | a <acronym>CD</acronym> is inserted by selecting <guilabel>Always do | 30 | a <acronym>CD</acronym> is inserted by selecting <guilabel>Always do |
15 | 31 | this for this type of media</guilabel>, and pressing <guibutton>OK</guibutton>. | 31 | this for this type of media</guilabel>, and pressing <guibutton>OK</guibutton>. |
18 | 32 | <application>Amarok</application> also offers other useful features. If connected to | 32 | <application>Amarok</application> also offers other useful features. If |
19 | 33 | the Internet, <application>Amarok</application> will retrieve | 33 | connected to the Internet, <application>Amarok</application> will retrieve |
20 | 34 | <acronym>CD</acronym> artist, title, and track data from <ulink | 34 | <acronym>CD</acronym> artist, title, and track data from <ulink |
21 | 35 | url="http://freedb.org">freedb.org</ulink>. It will also download the lyrics | 35 | url="http://freedb.org">freedb.org</ulink>. It will also download the lyrics |
25 | 36 | for the current selection if they are available by choosing the | 36 | for the current selection — if they are available — by choosing the |
26 | 37 | <guilabel>Lyrics</guilabel> tab. Other Artist information can be found on <ulink | 37 | <guilabel>Lyrics</guilabel> tab. Other artist information can be found on |
27 | 38 | url="http://www.wikipedia.org">Wikipedia</ulink> by selecting the | 38 | <ulink url="http://www.wikipedia.org">Wikipedia</ulink> by selecting the |
28 | 39 | <guilabel>Artist</guilabel> tab. | 39 | <guilabel>Artist</guilabel> tab. |
29 | 40 | </para> | 40 | </para> |
30 | 41 | </sect1> | 41 | </sect1> |
31 | @@ -44,19 +44,21 @@ | |||
32 | 44 | <title>Editing Audio </title> | 44 | <title>Editing Audio </title> |
33 | 45 | 45 | ||
34 | 46 | <para> | 46 | <para> |
38 | 47 | For editing audio files, &kubuntu; provides <application>Sound Editor (Audacity)</application>, | 47 | For editing audio files, &kubuntu; provides <application>Sound Editor |
39 | 48 | a full-featured, free and open source software application. To use | 48 | (Audacity)</application>, a full-featured, free, and open source software |
40 | 49 | <application>Sound Editor (Audacity)</application>: | 49 | application. To use <application>Sound Editor (Audacity)</application>: |
41 | 50 | </para> | 50 | </para> |
42 | 51 | <procedure> | 51 | <procedure> |
43 | 52 | <step> | 52 | <step> |
44 | 53 | <para> | 53 | <para> |
46 | 54 | Install <application>Sound Editor (Audacity)</application> from the package manager (Muon) | 54 | Install <application>Sound Editor (Audacity)</application> from the package |
47 | 55 | manager (Muon). | ||
48 | 55 | </para> | 56 | </para> |
49 | 56 | </step> | 57 | </step> |
50 | 57 | <step> | 58 | <step> |
51 | 58 | <para> | 59 | <para> |
53 | 59 | Run <application>Sound Editor (Audacity)</application> by going to &menuaudacity;. | 60 | Run <application>Sound Editor (Audacity)</application> by going to |
54 | 61 | &menuaudacity;. | ||
55 | 60 | </para> | 62 | </para> |
56 | 61 | </step> | 63 | </step> |
57 | 62 | <step> | 64 | <step> |
58 | @@ -64,8 +66,7 @@ | |||
59 | 64 | Detailed instructions (including tutorials and weblinks) on using | 66 | Detailed instructions (including tutorials and weblinks) on using |
60 | 65 | <application>Sound Editor (Audacity)</application> can be found by going to | 67 | <application>Sound Editor (Audacity)</application> can be found by going to |
61 | 66 | <menuchoice> | 68 | <menuchoice> |
64 | 67 | <guimenu>Help</guimenu> | 69 | <guimenu>Help</guimenu> <guisubmenu>Contents</guisubmenu> |
63 | 68 | <guisubmenu>Contents</guisubmenu> | ||
65 | 69 | </menuchoice> from within <application>Sound Editor (Audacity)</application>. | 70 | </menuchoice> from within <application>Sound Editor (Audacity)</application>. |
66 | 70 | </para> | 71 | </para> |
67 | 71 | </step> | 72 | </step> |
68 | @@ -78,7 +79,7 @@ | |||
69 | 78 | <para> | 79 | <para> |
70 | 79 | In addition to being the default music player in &kubuntu;, | 80 | In addition to being the default music player in &kubuntu;, |
71 | 80 | <application>Amarok</application> is also helpful for managing music | 81 | <application>Amarok</application> is also helpful for managing music |
73 | 81 | collections. Start <application>Amarok</application> by going to &menuamarok;. | 82 | collections. Start <application>Amarok</application> by going to &menuamarok;. |
74 | 82 | </para> | 83 | </para> |
75 | 83 | <para> | 84 | <para> |
76 | 84 | Another useful <application>Amarok</application> feature is the built-in ID3 | 85 | Another useful <application>Amarok</application> feature is the built-in ID3 |
77 | @@ -93,10 +94,11 @@ | |||
78 | 93 | 94 | ||
79 | 94 | <para> | 95 | <para> |
80 | 95 | Another exciting <application>Amarok</application> feature is the ability to | 96 | Another exciting <application>Amarok</application> feature is the ability to |
85 | 96 | play music directly from an iPod or other portable device. <application>Amarok</application> can also be | 97 | play music directly from an iPod or other portable device. |
86 | 97 | used to transfer music files to and from an iPod. Please refer to the <ulink | 98 | <application>Amarok</application> can also be used to transfer music files to |
87 | 98 | type="help" url="help:/amarok">Amarok Handbook</ulink> for more information on | 99 | and from an iPod. Please refer to the <ulink type="help" |
88 | 99 | transferring and managing iPod media files. | 100 | url="help:/amarok">Amarok Handbook</ulink> for more information on transferring |
89 | 101 | and managing iPod media files. | ||
90 | 100 | </para> | 102 | </para> |
91 | 101 | </sect1> | 103 | </sect1> |
92 | 102 | 104 | ||
93 | @@ -105,30 +107,29 @@ | |||
94 | 105 | <procedure> | 107 | <procedure> |
95 | 106 | <step> | 108 | <step> |
96 | 107 | <para> | 109 | <para> |
103 | 108 | When a blank <acronym>CD</acronym> is inserted, &kubuntu; will | 110 | When a blank <acronym>CD</acronym> is inserted, &kubuntu; will recognize it, |
104 | 109 | recognize it, mount it, and then ask what to do with the <acronym>CD</acronym>. | 111 | mount it, and then ask what to do with the <acronym>CD</acronym>. Choose |
105 | 110 | Choose <guilabel>Create an audio CD with K3B</guilabel> and press | 112 | <guilabel>Create an audio CD with K3B</guilabel> and press |
106 | 111 | <guibutton>OK</guibutton>. This will open | 113 | <guibutton>OK</guibutton>. This will open the <application>K3b</application> |
107 | 112 | <application>K3b</application>, the <acronym>CD</acronym> and | 114 | <acronym>CD</acronym> and <acronym>DVD</acronym> creator, and provide various |
108 | 113 | <acronym>DVD</acronym> Kreator, and provide various options. | 115 | options. |
109 | 114 | </para> | 116 | </para> |
110 | 115 | </step> | 117 | </step> |
111 | 116 | <step> | 118 | <step> |
112 | 117 | <para> | 119 | <para> |
115 | 118 | To start <application>K3b</application> manually, go to <guilabel>Kickoff Application | 120 | To start <application>K3b</application> manually, go to &menuk3b;. |
114 | 119 | > Applications > Multimedia > </guilabel><application>Disk Burning (K3b)</application>. | ||
116 | 120 | </para> | 121 | </para> |
117 | 121 | </step> | 122 | </step> |
118 | 122 | <step> | 123 | <step> |
119 | 123 | <para> | 124 | <para> |
120 | 124 | Select <guilabel>New Audio CD Project</guilabel> in the <guilabel>New | 125 | Select <guilabel>New Audio CD Project</guilabel> in the <guilabel>New |
122 | 125 | Project</guilabel> dropdown menu. | 126 | Project</guilabel> drop-down menu. |
123 | 126 | </para> | 127 | </para> |
124 | 127 | </step> | 128 | </step> |
125 | 128 | <step> | 129 | <step> |
126 | 129 | <para> | 130 | <para> |
127 | 130 | Inside <application>K3b</application>, browse and select the tracks to be | 131 | Inside <application>K3b</application>, browse and select the tracks to be |
129 | 131 | ripped. Then drag and drop the tracks in the white area at the bottom of the | 132 | ripped. Then drag and drop the tracks into the white area at the bottom of the |
130 | 132 | <application>K3b</application> window. | 133 | <application>K3b</application> window. |
131 | 133 | <mediaobject> | 134 | <mediaobject> |
132 | 134 | <imageobject> | 135 | <imageobject> |
133 | @@ -154,9 +155,10 @@ | |||
134 | 154 | <itemizedlist> | 155 | <itemizedlist> |
135 | 155 | <listitem> | 156 | <listitem> |
136 | 156 | <para> | 157 | <para> |
140 | 157 | <guilabel>Writing</guilabel> - provides choices related to burning an image from | 158 | <guilabel>Writing</guilabel> - provides choices related to burning an image |
141 | 158 | the files selected in the previous step. | 159 | from the files selected in the previous step. |
142 | 159 | <note><title>No MP3 Support by Default</title> | 160 | <note> |
143 | 161 | <title>No MP3 Support by Default</title> | ||
144 | 160 | <para> | 162 | <para> |
145 | 161 | <acronym>MP3</acronym> is a protocol restricted by patents. In order to use it | 163 | <acronym>MP3</acronym> is a protocol restricted by patents. In order to use it |
146 | 162 | with <application>K3b</application>, please refer to the information at the end | 164 | with <application>K3b</application>, please refer to the information at the end |
147 | @@ -194,36 +196,36 @@ | |||
148 | 194 | </step> | 196 | </step> |
149 | 195 | </procedure> | 197 | </procedure> |
150 | 196 | <para> | 198 | <para> |
152 | 197 | <application>K3b</application> can extract audio files to the following formats: | 199 | <application>K3b</application> can extract audio files to the following |
153 | 200 | formats: | ||
154 | 198 | <itemizedlist> | 201 | <itemizedlist> |
155 | 199 | <listitem> | 202 | <listitem> |
156 | 200 | <para> | 203 | <para> |
161 | 201 | <emphasis role="strong">Ogg Vorbis</emphasis> - Ogg | 204 | <emphasis role="strong">Ogg Vorbis</emphasis> - Ogg Vorbis is a patent-free |
162 | 202 | Vorbis is a patent-free lossy audio compression format which usually produces | 205 | lossy audio compression format which usually produces higher quality and |
163 | 203 | higher quality and greater compression than MP3. See the <ulink | 206 | greater compression than MP3. See the <ulink url="http://www.vorbis.com/faq/"> |
164 | 204 | url="http://www.vorbis.com/faq/">Vorbis website</ulink> for more information. | 207 | Vorbis website</ulink> for more information. |
165 | 205 | </para> | 208 | </para> |
166 | 206 | </listitem> | 209 | </listitem> |
167 | 207 | <listitem> | 210 | <listitem> |
168 | 208 | <para><emphasis role="strong">FLAC</emphasis> - The Free Lossless Audio | 211 | <para><emphasis role="strong">FLAC</emphasis> - The Free Lossless Audio |
173 | 209 | Codec, <acronym>FLAC</acronym>, can compress audio files up to 50% without removing | 212 | Codec, <acronym>FLAC</acronym>, can compress audio files up to 50% without |
174 | 210 | any information from the audio stream. For more information on this format, see | 213 | removing any information from the audio stream. For more information on this |
175 | 211 | the <ulink url="http://flac.sourceforge.net/">FLAC homepage</ulink> on | 214 | format, see the <ulink url="http://flac.sourceforge.net/">FLAC |
176 | 212 | sourceforge.net. | 215 | homepage</ulink> on <trademark>Sourceforge</trademark>. |
177 | 213 | </para> | 216 | </para> |
178 | 214 | </listitem> | 217 | </listitem> |
179 | 215 | <listitem> | 218 | <listitem> |
184 | 216 | <para><emphasis role="strong">WAV</emphasis> - Wav is an | 219 | <para><emphasis role="strong">WAV</emphasis> - Wav is an uncompressed audio |
185 | 217 | uncompressed audio format that can be compressed into OGG Vorbis or a codec of | 220 | format that can be compressed into OGG Vorbis or a codec of your choice. It is |
186 | 218 | your choice. It is often edited in applications such as Audacity before being | 221 | often edited in applications such as Audacity before being compressed. |
183 | 219 | compressed. | ||
187 | 220 | </para> | 222 | </para> |
188 | 221 | </listitem> | 223 | </listitem> |
189 | 222 | </itemizedlist> | 224 | </itemizedlist> |
190 | 223 | </para> | 225 | </para> |
191 | 224 | <para> | 226 | <para> |
192 | 225 | CD audio files can be extracted to the proprietary, non-free | 227 | CD audio files can be extracted to the proprietary, non-free |
194 | 226 | <emphasis role="strong">MP3</emphasis> lossy format by using the | 228 | <emphasis role="strong">MP3</emphasis> lossy format by using the |
195 | 227 | <application>lame</application> encoder. Please refer to the <ulink type="help" | 229 | <application>lame</application> encoder. Please refer to the <ulink type="help" |
196 | 228 | url="help:/kubuntu/add-applications/">Adding Applications</ulink> documentation | 230 | url="help:/kubuntu/add-applications/">Adding Applications</ulink> documentation |
197 | 229 | for help with installing applications such as <application>lame</application>. | 231 | for help with installing applications such as <application>lame</application>. |
198 | 230 | 232 | ||
199 | === modified file 'docs/bugs/C/bugs.xml' | |||
200 | --- docs/bugs/C/bugs.xml 2011-09-15 05:13:39 +0000 | |||
201 | +++ docs/bugs/C/bugs.xml 2012-03-22 07:41:34 +0000 | |||
202 | @@ -28,8 +28,8 @@ | |||
203 | 28 | <varlistentry><term>Crash</term> | 28 | <varlistentry><term>Crash</term> |
204 | 29 | <listitem> | 29 | <listitem> |
205 | 30 | <para> | 30 | <para> |
208 | 31 | An application or system crash or failure. Most of the time, a crash dialog will | 31 | An application or system crash or failure. Most of the time a crash dialog will |
209 | 32 | be presented that can be turned into a bug report. | 32 | be presented. This can be turned into a bug report. |
210 | 33 | </para> | 33 | </para> |
211 | 34 | </listitem> | 34 | </listitem> |
212 | 35 | </varlistentry> | 35 | </varlistentry> |
213 | @@ -59,19 +59,25 @@ | |||
214 | 59 | <title>KDE's Bug Tracking System</title> | 59 | <title>KDE's Bug Tracking System</title> |
215 | 60 | <para><ulink url="https://bugs.kde.org/"/></para> | 60 | <para><ulink url="https://bugs.kde.org/"/></para> |
216 | 61 | <para> | 61 | <para> |
219 | 62 | KDE uses Bugzilla, a "Defect Tracking System". Bugzilla is one of the | 62 | <trademark>KDE</trademark> uses <trademark>Bugzilla</trademark>, a |
220 | 63 | most popular tools used in the open source development community. | 63 | <quote>Defect Tracking System</quote>. <trademark>Bugzilla</trademark> is one |
221 | 64 | of the most popular tools used in the open source development community. | ||
222 | 64 | </para> | 65 | </para> |
223 | 65 | <note><title>Register first</title> | 66 | <note><title>Register first</title> |
224 | 66 | <para> | 67 | <para> |
228 | 67 | To report a bug, one must register for an account on KDE's Bugzilla | 68 | To report a bug, one must register for an account on |
229 | 68 | at <ulink url="https://bugs.kde.org/createaccount.cgi"/>. A valid email address | 69 | <trademark>KDE</trademark>'s <trademark>Bugzilla</trademark> at <ulink |
230 | 69 | is required for registration. | 70 | url="https://bugs.kde.org/createaccount.cgi"/>. A valid email address is |
231 | 71 | required for registration. | ||
232 | 70 | </para> | 72 | </para> |
233 | 71 | </note> | 73 | </note> |
234 | 72 | <note><title>Only for KDE bugs</title> | 74 | <note><title>Only for KDE bugs</title> |
235 | 73 | <para> | 75 | <para> |
237 | 74 | Bugzilla 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 |
238 | 77 | the application is not part of <trademark>KDE</trademark> — Firefox, | ||
239 | 78 | LibreOffice, or VLC, for instance — then the report should be filed in | ||
240 | 79 | Launchpad instead. Please see the next section, which covers filing reports | ||
241 | 80 | concerning Launchpad. | ||
242 | 75 | </para> | 81 | </para> |
243 | 76 | </note> | 82 | </note> |
244 | 77 | </sect2> | 83 | </sect2> |
245 | @@ -79,22 +85,24 @@ | |||
246 | 79 | <title>Launchpad</title> | 85 | <title>Launchpad</title> |
247 | 80 | <para><ulink url="https://launchpad.net/"/></para> | 86 | <para><ulink url="https://launchpad.net/"/></para> |
248 | 81 | <para> | 87 | <para> |
252 | 82 | Launchpad is an open source suite of tools that help people and teams to work | 88 | <trademark>Launchpad</trademark> is an open source suite of tools that help |
253 | 83 | together on software projects. Launchpad is used by the Ubuntu and &kubuntu; | 89 | people and teams to work together on software projects. Launchpad is used by |
254 | 84 | Projects, as well as various other open source projects. | 90 | the &ubuntu; and &kubuntu; projects, as well as various other open source |
255 | 91 | projects. | ||
256 | 85 | </para> | 92 | </para> |
257 | 86 | <note><title>Register first</title> | 93 | <note><title>Register first</title> |
258 | 87 | <para> | 94 | <para> |
262 | 88 | To report a bug, one must register for a Launchpad account at | 95 | To report a bug, one must register for a <trademark>Launchpad</trademark> |
263 | 89 | <ulink url="https://launchpad.net/+login"/>. A valid email address is required | 96 | account at <ulink url="https://launchpad.net/+login"/>. A valid email address |
264 | 90 | for registration. | 97 | is required for registration. |
265 | 91 | </para> | 98 | </para> |
266 | 92 | </note> | 99 | </note> |
267 | 93 | <note><title>For any bug in &kubuntu;</title> | 100 | <note><title>For any bug in &kubuntu;</title> |
268 | 94 | <para> | 101 | <para> |
272 | 95 | Launchpad can be used to file a bug report for any application available in the | 102 | <trademark>Launchpad</trademark> can be used to file a bug report for any |
273 | 96 | Ubuntu or &kubuntu; repositories. For KDE applications, the | 103 | application available in the &ubuntu; or &kubuntu; repositories. For |
274 | 97 | KDE Bug Tracking system (above) is preferred. | 104 | <trademark>KDE</trademark> applications, the <trademark>KDE Bug |
275 | 105 | Tracking</trademark> system (above) is preferred. | ||
276 | 98 | </para> | 106 | </para> |
277 | 99 | </note> | 107 | </note> |
278 | 100 | </sect2> | 108 | </sect2> |
279 | @@ -104,18 +112,19 @@ | |||
280 | 104 | <title>Filing a Crash Report</title> | 112 | <title>Filing a Crash Report</title> |
281 | 105 | <para> | 113 | <para> |
282 | 106 | When an application crashes in &kubuntu;, the appropriate crash dialog will | 114 | When an application crashes in &kubuntu;, the appropriate crash dialog will |
287 | 107 | appear. It is usually easy to file a bug report from the dialog. With a KDE | 115 | appear. It is usually easy to file a bug report from the dialog. With a |
288 | 108 | application, the KDE crash dialog will appear along with instructions | 116 | <trademark>KDE</trademark> application, the <trademark>KDE</trademark> crash |
289 | 109 | for reporting the bug. Otherwise, the Ubuntu crash dialog will appear with | 117 | dialog will appear along with instructions for reporting the bug. Otherwise, |
290 | 110 | instructions for filing a bug on Launchpad. | 118 | the &ubuntu; crash dialog will appear with instructions for filing a bug on |
291 | 119 | <trademark>Launchpad</trademark>. | ||
292 | 111 | </para> | 120 | </para> |
293 | 112 | <sect2 id="filing-crash-kde"> | 121 | <sect2 id="filing-crash-kde"> |
294 | 113 | <title>KDE</title> | 122 | <title>KDE</title> |
295 | 114 | <para> | 123 | <para> |
300 | 115 | When an application crashes in KDE, a crash dialog will be presented that is | 124 | When an application crashes in <trademark>KDE</trademark>, a crash dialog will |
301 | 116 | similar to the following images. The first image shows the | 125 | be presented that is similar to the following images. The first image shows the |
302 | 117 | <guilabel>General</guilabel> tab which provides an overview of the crash. The | 126 | <guilabel>General</guilabel> tab, which provides an overview of the crash. The |
303 | 118 | second image shows the <guilabel>Developer Information</guilabel> tab which | 127 | second image shows the <guilabel>Developer Information</guilabel> tab, which |
304 | 119 | provides trace information that is useful to developers. | 128 | provides trace information that is useful to developers. |
305 | 120 | </para> | 129 | </para> |
306 | 121 | <para> | 130 | <para> |
307 | @@ -139,10 +148,10 @@ | |||
308 | 139 | </example> | 148 | </example> |
309 | 140 | </para> | 149 | </para> |
310 | 141 | <para> | 150 | <para> |
315 | 142 | If the trace information is deemed valuable, filing a bug report is | 151 | If the trace information is deemed valuable, filing a bug report is easy with |
316 | 143 | easy with the crash dialog wizard. If the trace is not deemed valuable, then it | 152 | the crash dialog wizard. If the trace is not deemed valuable, then it is not |
317 | 144 | is not possible to file a bug report with the wizard. The bug report can still | 153 | possible to file a bug report with the wizard. The bug report can still be |
318 | 145 | be filed manually at <ulink url="https://bugs.kde.org/"/>. | 154 | filed manually at <ulink url="https://bugs.kde.org/"/>. |
319 | 146 | </para> | 155 | </para> |
320 | 147 | <para> | 156 | <para> |
321 | 148 | To complete the bug reporting process, follow the procedure below. | 157 | To complete the bug reporting process, follow the procedure below. |
322 | @@ -151,14 +160,15 @@ | |||
323 | 151 | <step> | 160 | <step> |
324 | 152 | <para> | 161 | <para> |
325 | 153 | <mousebutton>Click</mousebutton> the <guibutton>Report Bug</guibutton> button. | 162 | <mousebutton>Click</mousebutton> the <guibutton>Report Bug</guibutton> button. |
327 | 154 | The following dialog will appear. | 163 | The following dialog will appear: |
328 | 155 | </para> | 164 | </para> |
329 | 156 | <para> | 165 | <para> |
330 | 157 | <example> | 166 | <example> |
331 | 158 | <title>Welcome to the Reporting Assistant</title> | 167 | <title>Welcome to the Reporting Assistant</title> |
332 | 159 | <mediaobject> | 168 | <mediaobject> |
333 | 160 | <imageobject> | 169 | <imageobject> |
335 | 161 | <imagedata fileref="help:/images/C/crash_report_assistant_welcome.png" format="PNG"/> | 170 | <imagedata |
336 | 171 | fileref="help:/images/C/crash_report_assistant_welcome.png" format="PNG"/> | ||
337 | 162 | </imageobject> | 172 | </imageobject> |
338 | 163 | </mediaobject> | 173 | </mediaobject> |
339 | 164 | </example> | 174 | </example> |
340 | @@ -167,14 +177,15 @@ | |||
341 | 167 | <step> | 177 | <step> |
342 | 168 | <para> | 178 | <para> |
343 | 169 | <mousebutton>Click</mousebutton> the <guibutton>Next</guibutton> button. The | 179 | <mousebutton>Click</mousebutton> the <guibutton>Next</guibutton> button. The |
345 | 170 | following dialog will appear. | 180 | following dialog will appear: |
346 | 171 | </para> | 181 | </para> |
347 | 172 | <para> | 182 | <para> |
348 | 173 | <example> | 183 | <example> |
349 | 174 | <title>What do you know about the crash?</title> | 184 | <title>What do you know about the crash?</title> |
350 | 175 | <mediaobject> | 185 | <mediaobject> |
351 | 176 | <imageobject> | 186 | <imageobject> |
353 | 177 | <imagedata fileref="help:/images/C/crash_report_assistant_about_crash.png" format="PNG"/> | 187 | <imagedata |
354 | 188 | fileref="help:/images/C/crash_report_assistant_about_crash.png" format="PNG"/> | ||
355 | 178 | </imageobject> | 189 | </imageobject> |
356 | 179 | </mediaobject> | 190 | </mediaobject> |
357 | 180 | </example> | 191 | </example> |
358 | @@ -183,15 +194,17 @@ | |||
359 | 183 | <step> | 194 | <step> |
360 | 184 | <para> | 195 | <para> |
361 | 185 | Select the applicable options. The drop-down box under the question, | 196 | Select the applicable options. The drop-down box under the question, |
364 | 186 | "<guilabel>Does the application crash again if you repeat the | 197 | <quote><guilabel>Does the application crash again if you repeat the |
365 | 187 | same situation?</guilabel>" has several options. | 198 | same situation?</guilabel></quote> has several options. |
366 | 188 | </para> | 199 | </para> |
367 | 189 | <para> | 200 | <para> |
368 | 190 | <example> | 201 | <example> |
369 | 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> |
370 | 192 | <mediaobject> | 203 | <mediaobject> |
371 | 193 | <imageobject> | 204 | <imageobject> |
373 | 194 | <imagedata fileref="help:/images/C/crash_report_assistant_about_crash_dropdown.png" format="PNG"/> | 205 | <imagedata |
374 | 206 | fileref="help:/images/C/crash_report_assistant_about_crash_dropdown.png" | ||
375 | 207 | format="PNG"/> | ||
376 | 195 | </imageobject> | 208 | </imageobject> |
377 | 196 | </mediaobject> | 209 | </mediaobject> |
378 | 197 | </example> | 210 | </example> |
379 | @@ -205,18 +218,21 @@ | |||
380 | 205 | </step> | 218 | </step> |
381 | 206 | <step> | 219 | <step> |
382 | 207 | <para> | 220 | <para> |
384 | 208 | Depending on the information available in the crash report, either of two | 221 | Depending on the information available in the crash report, either of two |
385 | 209 | dialogs will appear. One is a dialog that indicates that there is not enough | 222 | dialogs will appear. One is a dialog that indicates that there is not enough |
386 | 210 | information to file a good report. The other is a dialog indicating that the | 223 | information to file a good report. The other is a dialog indicating that the |
388 | 211 | information is useful, and that it would be helpful to continue with filing the | 224 | information is useful and that it would be helpful to continue with filing the |
389 | 212 | report. | 225 | report. |
390 | 213 | </para> | 226 | </para> |
391 | 214 | <para> | 227 | <para> |
392 | 215 | <example> | 228 | <example> |
394 | 216 | <title>Not enough information for developers to continue the reporting process</title> | 229 | <title>Not enough information for developers to continue the reporting |
395 | 230 | process</title> | ||
396 | 217 | <mediaobject> | 231 | <mediaobject> |
397 | 218 | <imageobject> | 232 | <imageobject> |
399 | 219 | <imagedata fileref="help:/images/C/crash_report_assistant_not_enough_info.png" format="PNG"/> | 233 | <imagedata |
400 | 234 | fileref="help:/images/C/crash_report_assistant_not_enough_info.png" | ||
401 | 235 | format="PNG"/> | ||
402 | 220 | </imageobject> | 236 | </imageobject> |
403 | 221 | </mediaobject> | 237 | </mediaobject> |
404 | 222 | </example> | 238 | </example> |
405 | @@ -226,7 +242,9 @@ | |||
406 | 226 | <title>This crash information is useful</title> | 242 | <title>This crash information is useful</title> |
407 | 227 | <mediaobject> | 243 | <mediaobject> |
408 | 228 | <imageobject> | 244 | <imageobject> |
410 | 229 | <imagedata fileref="help:/images/C/crash_report_assistant_useful_information.png" format="PNG"/> | 245 | <imagedata |
411 | 246 | fileref="help:/images/C/crash_report_assistant_useful_information.png" | ||
412 | 247 | format="PNG"/> | ||
413 | 230 | </imageobject> | 248 | </imageobject> |
414 | 231 | </mediaobject> | 249 | </mediaobject> |
415 | 232 | </example> | 250 | </example> |
416 | @@ -235,7 +253,7 @@ | |||
417 | 235 | <para> | 253 | <para> |
418 | 236 | It may be necessary to install the proper debug packages in order to get a good | 254 | It may be necessary to install the proper debug packages in order to get a good |
419 | 237 | trace. Such packages include <filename>kdebase-dbg</filename>, | 255 | trace. Such packages include <filename>kdebase-dbg</filename>, |
421 | 238 | <filename>kdebase-workspace-dbg</filename>, | 256 | <filename>kdebase-workspace-dbg</filename>, and |
422 | 239 | <filename>kdebase-runtime-dbg</filename>. | 257 | <filename>kdebase-runtime-dbg</filename>. |
423 | 240 | </para> | 258 | </para> |
424 | 241 | </note> | 259 | </note> |
425 | @@ -243,36 +261,42 @@ | |||
426 | 243 | <step> | 261 | <step> |
427 | 244 | <para> | 262 | <para> |
428 | 245 | If enough information was provided to continue filing a bug report using | 263 | If enough information was provided to continue filing a bug report using |
430 | 246 | the assistant, a dialog will appear to allow logging in to KDE's Bugzilla. | 264 | the assistant, a dialog will appear to allow logging in to |
431 | 265 | <trademark>KDE</trademark>'s <trademark>Bugzilla</trademark>. | ||
432 | 247 | </para> | 266 | </para> |
433 | 248 | <para> | 267 | <para> |
434 | 249 | <example> | 268 | <example> |
435 | 250 | <title>KDE Bug Tracking System Login</title> | 269 | <title>KDE Bug Tracking System Login</title> |
436 | 251 | <mediaobject> | 270 | <mediaobject> |
437 | 252 | <imageobject> | 271 | <imageobject> |
439 | 253 | <imagedata fileref="help:/images/C/crash_report_assistant_bugtracker_login.png" format="PNG"/> | 272 | <imagedata |
440 | 273 | fileref="help:/images/C/crash_report_assistant_bugtracker_login.png" | ||
441 | 274 | format="PNG"/> | ||
442 | 254 | </imageobject> | 275 | </imageobject> |
443 | 255 | </mediaobject> | 276 | </mediaobject> |
444 | 256 | </example> | 277 | </example> |
445 | 257 | </para> | 278 | </para> |
446 | 258 | <note><title>Use e-mail address as username</title> | 279 | <note><title>Use e-mail address as username</title> |
447 | 259 | <para> | 280 | <para> |
449 | 260 | Use the e-mail address that was used to register with KDE's Bugzilla. | 281 | Use the email address that was used to register with |
450 | 282 | <trademark>KDE</trademark>'s <trademark>Bugzilla</trademark>. | ||
451 | 261 | </para> | 283 | </para> |
452 | 262 | </note> | 284 | </note> |
453 | 263 | </step> | 285 | </step> |
454 | 264 | <step> | 286 | <step> |
455 | 265 | <para> | 287 | <para> |
457 | 266 | After logging in with username (e-mail address) and password, | 288 | After logging in with your username (email address) and password, |
458 | 267 | <mousebutton>click</mousebutton> the <guibutton>Login</guibutton> button. The | 289 | <mousebutton>click</mousebutton> the <guibutton>Login</guibutton> button. The |
460 | 268 | assistant will check for duplicates and display the following dialog. | 290 | assistant will check for duplicates and display the following dialog: |
461 | 269 | </para> | 291 | </para> |
462 | 270 | <para> | 292 | <para> |
463 | 271 | <example> | 293 | <example> |
464 | 272 | <title>Bug Report Possible Duplicates List</title> | 294 | <title>Bug Report Possible Duplicates List</title> |
465 | 273 | <mediaobject> | 295 | <mediaobject> |
466 | 274 | <imageobject> | 296 | <imageobject> |
468 | 275 | <imagedata fileref="help:/images/C/crash_report_assistant_possible_duplicates.png" format="PNG"/> | 297 | <imagedata |
469 | 298 | fileref="help:/images/C/crash_report_assistant_possible_duplicates.png" | ||
470 | 299 | format="PNG"/> | ||
471 | 276 | </imageobject> | 300 | </imageobject> |
472 | 277 | </mediaobject> | 301 | </mediaobject> |
473 | 278 | </example> | 302 | </example> |
474 | @@ -283,14 +307,17 @@ | |||
475 | 283 | If there is a possible duplicate report, <mousebutton>click</mousebutton> the | 307 | If there is a possible duplicate report, <mousebutton>click</mousebutton> the |
476 | 284 | report in the list and then <mousebutton>click</mousebutton> the <guibutton>Open | 308 | report in the list and then <mousebutton>click</mousebutton> the <guibutton>Open |
477 | 285 | selected report</guibutton> button. Either of the following dialogs will be | 309 | selected report</guibutton> button. Either of the following dialogs will be |
479 | 286 | presented. | 310 | presented: |
480 | 287 | </para> | 311 | </para> |
481 | 288 | <para> | 312 | <para> |
482 | 289 | <example> | 313 | <example> |
484 | 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 |
485 | 315 | bug...</title> | ||
486 | 291 | <mediaobject> | 316 | <mediaobject> |
487 | 292 | <imageobject> | 317 | <imageobject> |
489 | 293 | <imagedata fileref="help:/images/C/crash_report_assistant_nested_duplicate_detected.png" format="PNG"/> | 318 | <imagedata |
490 | 319 | fileref="help:/images/C/crash_report_assistant_nested_duplicate_detected.png" | ||
491 | 320 | format="PNG"/> | ||
492 | 294 | </imageobject> | 321 | </imageobject> |
493 | 295 | </mediaobject> | 322 | </mediaobject> |
494 | 296 | </example> | 323 | </example> |
495 | @@ -300,7 +327,9 @@ | |||
496 | 300 | <title>Showing the duplicate bug report you selected</title> | 327 | <title>Showing the duplicate bug report you selected</title> |
497 | 301 | <mediaobject> | 328 | <mediaobject> |
498 | 302 | <imageobject> | 329 | <imageobject> |
500 | 303 | <imagedata fileref="help:/images/C/crash_report_assistant_duplicate_report.png" format="PNG"/> | 330 | <imagedata |
501 | 331 | fileref="help:/images/C/crash_report_assistant_duplicate_report.png" | ||
502 | 332 | format="PNG"/> | ||
503 | 304 | </imageobject> | 333 | </imageobject> |
504 | 305 | </mediaobject> | 334 | </mediaobject> |
505 | 306 | </example> | 335 | </example> |
506 | @@ -313,23 +342,26 @@ | |||
507 | 313 | bug report and inform the developers that it may be a duplicate. This is | 342 | bug report and inform the developers that it may be a duplicate. This is |
508 | 314 | recommended, except in cases with experienced users where it is clearly not a | 343 | recommended, except in cases with experienced users where it is clearly not a |
509 | 315 | duplicate. <mousebutton>Clicking</mousebutton> the <guibutton>Attach to this | 344 | duplicate. <mousebutton>Clicking</mousebutton> the <guibutton>Attach to this |
511 | 316 | report (Advanced)</guibutton> will attach the crash information to the report. | 345 | report (Advanced)</guibutton> button will attach the crash information to the |
512 | 346 | report. | ||
513 | 317 | </para> | 347 | </para> |
514 | 318 | <para> | 348 | <para> |
515 | 319 | If the bug is not a duplicate, simply <mousebutton>click</mousebutton> | 349 | If the bug is not a duplicate, simply <mousebutton>click</mousebutton> |
522 | 320 | the <guibutton>Next</guibutton> in the dialog showing the possible duplicates. | 350 | the <guibutton>Next</guibutton> button in the dialog showing the possible |
523 | 321 | A dialog will appear with <guibutton>Let me check more reports</guibutton>. To | 351 | duplicates. A dialog will appear with <guibutton>Let me check more |
524 | 322 | prevent checking for more reports and continue to file the report, | 352 | reports</guibutton>. To prevent checking for more reports and continue filing |
525 | 323 | <mousebutton>click</mousebutton> the <guibutton>There | 353 | the report, <mousebutton>click</mousebutton> the <guibutton>There |
526 | 324 | are no real duplicates</guibutton> button. A dialog will appear to enter | 354 | are no real duplicates</guibutton> button. A dialog will appear asking you to |
527 | 325 | additional information concerning the report. | 355 | enter additional information concerning the report. |
528 | 326 | </para> | 356 | </para> |
529 | 327 | <para> | 357 | <para> |
530 | 328 | <example> | 358 | <example> |
531 | 329 | <title>Details of the Bug Report</title> | 359 | <title>Details of the Bug Report</title> |
532 | 330 | <mediaobject> | 360 | <mediaobject> |
533 | 331 | <imageobject> | 361 | <imageobject> |
535 | 332 | <imagedata fileref="help:/images/C/crash_report_assistant_report_details.png" format="PNG"/> | 362 | <imagedata |
536 | 363 | fileref="help:/images/C/crash_report_assistant_report_details.png" | ||
537 | 364 | format="PNG"/> | ||
538 | 333 | </imageobject> | 365 | </imageobject> |
539 | 334 | </mediaobject> | 366 | </mediaobject> |
540 | 335 | </example> | 367 | </example> |
541 | @@ -337,16 +369,18 @@ | |||
542 | 337 | </step> | 369 | </step> |
543 | 338 | <step> | 370 | <step> |
544 | 339 | <para> | 371 | <para> |
548 | 340 | Once the details of the bug report are complete, | 372 | Once the details of the bug report are complete, |
549 | 341 | <mousebutton>click</mousebutton> the <guibutton>Next</guibutton> button. The | 373 | <mousebutton>click</mousebutton> the <guibutton>Next</guibutton> button. The |
550 | 342 | following dialog will be presented. | 374 | following dialog will be presented: |
551 | 343 | </para> | 375 | </para> |
552 | 344 | <para> | 376 | <para> |
553 | 345 | <example> | 377 | <example> |
554 | 346 | <title>Preview Report</title> | 378 | <title>Preview Report</title> |
555 | 347 | <mediaobject> | 379 | <mediaobject> |
556 | 348 | <imageobject> | 380 | <imageobject> |
558 | 349 | <imagedata fileref="help:/images/C/crash_report_assistant_report_details_preview.png" format="PNG"/> | 381 | <imagedata |
559 | 382 | fileref="help:/images/C/crash_report_assistant_report_details_preview.png" | ||
560 | 383 | format="PNG"/> | ||
561 | 350 | </imageobject> | 384 | </imageobject> |
562 | 351 | </mediaobject> | 385 | </mediaobject> |
563 | 352 | </example> | 386 | </example> |
564 | @@ -355,14 +389,16 @@ | |||
565 | 355 | <step> | 389 | <step> |
566 | 356 | <para> | 390 | <para> |
567 | 357 | If the information looks correct, <mousebutton>click</mousebutton> the | 391 | If the information looks correct, <mousebutton>click</mousebutton> the |
569 | 358 | <guibutton>Next</guibutton> button. The following dialog will be presented. | 392 | <guibutton>Next</guibutton> button. The following dialog will be presented: |
570 | 359 | </para> | 393 | </para> |
571 | 360 | <para> | 394 | <para> |
572 | 361 | <example> | 395 | <example> |
573 | 362 | <title>Send Crash Report</title> | 396 | <title>Send Crash Report</title> |
574 | 363 | <mediaobject> | 397 | <mediaobject> |
575 | 364 | <imageobject> | 398 | <imageobject> |
577 | 365 | <imagedata fileref="help:/images/C/crash_report_assistant_report_filed.png" format="PNG"/> | 399 | <imagedata |
578 | 400 | fileref="help:/images/C/crash_report_assistant_report_filed.png" | ||
579 | 401 | format="PNG"/> | ||
580 | 366 | </imageobject> | 402 | </imageobject> |
581 | 367 | </mediaobject> | 403 | </mediaobject> |
582 | 368 | </example> | 404 | </example> |
583 | @@ -370,18 +406,19 @@ | |||
584 | 370 | </step> | 406 | </step> |
585 | 371 | </procedure> | 407 | </procedure> |
586 | 372 | <para> | 408 | <para> |
591 | 373 | <emphasis role="bold">Congratulations on a successful bug report!</emphasis> | 409 | <emphasis>Congratulations on a successful bug report!</emphasis> Identifying |
592 | 374 | Identifying and reporting bugs are essential to improving &kubuntu; and KDE. | 410 | and reporting bugs are essential to improving &kubuntu; and |
593 | 375 | Some emails may be sent to the registered address to update progress or to | 411 | <trademark>KDE</trademark>. Some emails may be sent to the registered address |
594 | 376 | allow developers to get additional information about the bug. | 412 | to update progress or to allow developers to get additional information about |
595 | 413 | the bug. | ||
596 | 377 | </para> | 414 | </para> |
597 | 378 | </sect2> | 415 | </sect2> |
598 | 379 | <sect2 id="filing-crash-lp"> | 416 | <sect2 id="filing-crash-lp"> |
599 | 380 | <title>Launchpad</title> | 417 | <title>Launchpad</title> |
600 | 381 | <para> | 418 | <para> |
604 | 382 | When an application that is not KDE crashes in &kubuntu;, a pop-up notification | 419 | When an application that is not <trademark>KDE</trademark> crashes in |
605 | 383 | will appear from <application>Apport</application> that is similar to the | 420 | &kubuntu;, a pop-up notification will appear from |
606 | 384 | following image. | 421 | <application>Apport</application> that is similar to the following image: |
607 | 385 | </para> | 422 | </para> |
608 | 386 | <para> | 423 | <para> |
609 | 387 | <example><title>Apport Crash Pop-pup Notification</title> | 424 | <example><title>Apport Crash Pop-pup Notification</title> |
610 | @@ -394,11 +431,11 @@ | |||
611 | 394 | </para> | 431 | </para> |
612 | 395 | <note><title>Crash information may be different</title> | 432 | <note><title>Crash information may be different</title> |
613 | 396 | <para> | 433 | <para> |
619 | 397 | The following screen shots were created by crashing the application | 434 | The screen shots below were created by crashing the application |
620 | 398 | <application>VLC</application> deliberately. Crash dialogs associated with other | 435 | <application>VLC</application> deliberately. Crash dialogs associated with |
621 | 399 | applications will be different. In an actual bug situation, the application | 436 | other applications will be different. In an actual bug situation, the |
622 | 400 | name, <application>VLC</application>, will be replaced by the name of the | 437 | application name, <application>VLC</application>, will be replaced by the name |
623 | 401 | application that actually crashed. | 438 | of the application that actually crashed. |
624 | 402 | </para> | 439 | </para> |
625 | 403 | </note> | 440 | </note> |
626 | 404 | <para> | 441 | <para> |
627 | @@ -409,7 +446,7 @@ | |||
628 | 409 | <para> | 446 | <para> |
629 | 410 | <mousebutton>Click</mousebutton> the <guibutton>Details</guibutton> buttons on | 447 | <mousebutton>Click</mousebutton> the <guibutton>Details</guibutton> buttons on |
630 | 411 | the <application>System Notification Helper</application>. The following dialog | 448 | the <application>System Notification Helper</application>. The following dialog |
632 | 412 | will be presented. | 449 | will be presented: |
633 | 413 | </para> | 450 | </para> |
634 | 414 | <para> | 451 | <para> |
635 | 415 | <example> | 452 | <example> |
636 | @@ -441,11 +478,11 @@ | |||
637 | 441 | </step> | 478 | </step> |
638 | 442 | <step> | 479 | <step> |
639 | 443 | <para> | 480 | <para> |
643 | 444 | After all of the information concerning the crash is collected, a dialog will | 481 | After all information concerning the crash is collected, a dialog will be |
644 | 445 | be presented that displays the details of the report, and the report is sent to | 482 | presented that displays the details of the report, and the report is sent to |
645 | 446 | the developers. <mousebutton>Click</mousebutton> the | 483 | the developers. <mousebutton>Click</mousebutton> the |
646 | 447 | <guibutton>Details...</guibutton> button to view details of the report. The | 484 | <guibutton>Details...</guibutton> button to view details of the report. The |
648 | 448 | following dialog will be presented. | 485 | following dialog will be presented: |
649 | 449 | </para> | 486 | </para> |
650 | 450 | <para> | 487 | <para> |
651 | 451 | <example><title>Send problem report to the developers? (Details)</title> | 488 | <example><title>Send problem report to the developers? (Details)</title> |
652 | @@ -460,8 +497,8 @@ | |||
653 | 460 | <step> | 497 | <step> |
654 | 461 | <para> | 498 | <para> |
655 | 462 | <mousebutton>Click</mousebutton> the <guibutton>Send</guibutton> button to send | 499 | <mousebutton>Click</mousebutton> the <guibutton>Send</guibutton> button to send |
658 | 463 | the report to the developers. In this case, it will send the report to | 500 | the report to the developers. In this case, it will send the report to |
659 | 464 | Launchpad. The following progress dialog will be presented. | 501 | <trademark>Launchpad</trademark>. The following progress dialog will be presented: |
660 | 465 | </para> | 502 | </para> |
661 | 466 | <para> | 503 | <para> |
662 | 467 | <example><title>Uploading problem information</title> | 504 | <example><title>Uploading problem information</title> |
663 | @@ -476,15 +513,16 @@ | |||
664 | 476 | <step> | 513 | <step> |
665 | 477 | <para> | 514 | <para> |
666 | 478 | After the progress dialog completes, the default web browser will open to | 515 | After the progress dialog completes, the default web browser will open to |
670 | 479 | Launchpad presenting either the login page or the beginning of the online | 516 | <trademark>Launchpad</trademark>, presenting either the log-in page or the |
671 | 480 | version of the bug reporting process. After logging in (if necessary) the | 517 | beginning of the online version of the bug reporting process. After logging in |
672 | 481 | following page will be presented. | 518 | (if necessary), the following page will be presented: |
673 | 482 | </para> | 519 | </para> |
674 | 483 | <para> | 520 | <para> |
675 | 484 | <example><title>Please wait while bug data is processed...</title> | 521 | <example><title>Please wait while bug data is processed...</title> |
676 | 485 | <mediaobject> | 522 | <mediaobject> |
677 | 486 | <imageobject> | 523 | <imageobject> |
679 | 487 | <imagedata fileref="help:/images/C/apport-browser-processing.png" format="PNG"/> | 524 | <imagedata fileref="help:/images/C/apport-browser-processing.png" |
680 | 525 | format="PNG"/> | ||
681 | 488 | </imageobject> | 526 | </imageobject> |
682 | 489 | </mediaobject> | 527 | </mediaobject> |
683 | 490 | </example> | 528 | </example> |
684 | @@ -492,8 +530,8 @@ | |||
685 | 492 | </step> | 530 | </step> |
686 | 493 | <step> | 531 | <step> |
687 | 494 | <para> | 532 | <para> |
690 | 495 | When Launchpad is finished processing the bug data, the following page will be | 533 | When <trademark>Launchpad</trademark> is finished processing the bug data, the |
691 | 496 | presented. | 534 | following page will be presented: |
692 | 497 | </para> | 535 | </para> |
693 | 498 | <para> | 536 | <para> |
694 | 499 | <example><title>Extra debug information will be added...</title> | 537 | <example><title>Extra debug information will be added...</title> |
695 | @@ -508,7 +546,7 @@ | |||
696 | 508 | <step> | 546 | <step> |
697 | 509 | <para> | 547 | <para> |
698 | 510 | <mousebutton>Click</mousebutton> the <guibutton>Next</guibutton> button. The | 548 | <mousebutton>Click</mousebutton> the <guibutton>Next</guibutton> button. The |
700 | 511 | following page will be presented. | 549 | following page will be presented: |
701 | 512 | </para> | 550 | </para> |
702 | 513 | <para> | 551 | <para> |
703 | 514 | <example><title>Further information</title> | 552 | <example><title>Further information</title> |
704 | @@ -522,10 +560,10 @@ | |||
705 | 522 | </step> | 560 | </step> |
706 | 523 | <step> | 561 | <step> |
707 | 524 | <para> | 562 | <para> |
712 | 525 | Any extra information can be filled in about the bug report such as what was | 563 | Any extra information about the bug report can be filled in to describe, for |
713 | 526 | being done when it crashed or the online file locations that may have caused the | 564 | example, what was being done when the application crashed or the online file |
714 | 527 | crash. The following is a brief description filed with the report in | 565 | locations that may have caused the crash. The following is a brief description |
715 | 528 | this procedure. | 566 | filed with the report in this procedure: |
716 | 529 | </para> | 567 | </para> |
717 | 530 | <para> | 568 | <para> |
718 | 531 | <example><title>Further information (Completed)</title> | 569 | <example><title>Further information (Completed)</title> |
719 | @@ -540,7 +578,7 @@ | |||
720 | 540 | <step> | 578 | <step> |
721 | 541 | <para> | 579 | <para> |
722 | 542 | <mousebutton>Click</mousebutton> the <guibutton>Submit Bug Report</guibutton> | 580 | <mousebutton>Click</mousebutton> the <guibutton>Submit Bug Report</guibutton> |
724 | 543 | button on the bottom of the page. The following page will be presented. | 581 | button on the bottom of the page. The following page will be presented: |
725 | 544 | </para> | 582 | </para> |
726 | 545 | <para> | 583 | <para> |
727 | 546 | <example><title>Thank you for your bug report</title> | 584 | <example><title>Thank you for your bug report</title> |
728 | @@ -554,10 +592,10 @@ | |||
729 | 554 | </step> | 592 | </step> |
730 | 555 | </procedure> | 593 | </procedure> |
731 | 556 | <para> | 594 | <para> |
736 | 557 | <emphasis role="bold">Congratulations on making a successful crash | 595 | <emphasis>Congratulations on making a successful crash report!</emphasis> |
737 | 558 | report!</emphasis>Identifying and reporting bugs are essential to improving | 596 | Identifying and reporting bugs are essential to improving &kubuntu;. Some |
738 | 559 | &kubuntu;. Some emails may be sent to the registered address to update progress | 597 | emails may be sent to the registered address to update progress or to allow |
739 | 560 | or to allow developers to get additional information about the bug. | 598 | developers to get additional information about the bug. |
740 | 561 | </para> | 599 | </para> |
741 | 562 | </sect2> | 600 | </sect2> |
742 | 563 | </sect1> | 601 | </sect1> |
743 | @@ -565,32 +603,33 @@ | |||
744 | 565 | <sect1 id="filing-non-crash"> | 603 | <sect1 id="filing-non-crash"> |
745 | 566 | <title>Filing a Non-Crash or Regression Report</title> | 604 | <title>Filing a Non-Crash or Regression Report</title> |
746 | 567 | <para> | 605 | <para> |
754 | 568 | If an application has regressed in functionality, a bug report should be | 606 | If an application has regressed in functionality, a bug report should be filed |
755 | 569 | filed on that application. A regress occurs when a function worked in a previous | 607 | on that application. A regression occurs when a function worked in a previous |
756 | 570 | release but in the latest release, it is not working. In most cases, this type | 608 | release, but is not working in the latest release. In most cases, this type of |
757 | 571 | of report will be filed by those who have more experience and may be testing | 609 | report will be filed by those who have previous experience and may be testing |
758 | 572 | beta quality software. However there are situations where a user needs to report | 610 | beta quality software. There are, however, situations where a user needs to |
759 | 573 | an issue with an application that isn't working right, but isn't crashing. The | 611 | report an issue with an application that isn't working right, but isn't |
760 | 574 | following procedures will help. | 612 | crashing. The following procedures will help: |
761 | 575 | </para> | 613 | </para> |
762 | 576 | <sect2 id="filing-non-crash-kde"> | 614 | <sect2 id="filing-non-crash-kde"> |
763 | 577 | <title>KDE</title> | 615 | <title>KDE</title> |
764 | 578 | <para> | 616 | <para> |
767 | 579 | Filing non-crash related bug reports for KDE applications are done with a web | 617 | Filing non-crash related bug reports for <trademark>KDE</trademark> |
768 | 580 | browser using <ulink url="https://bugs.kde.org/"/>. | 618 | applications is done with a web browser using |
769 | 619 | <ulink url="https://bugs.kde.org/"/>. | ||
770 | 581 | </para> | 620 | </para> |
771 | 582 | <note><title>Register first</title> | 621 | <note><title>Register first</title> |
772 | 583 | <para> | 622 | <para> |
773 | 584 | To report a bug, one must register for an account on the bug tracker. | 623 | To report a bug, one must register for an account on the bug tracker. |
775 | 585 | KDE's bug tracker is located at <ulink url="https://bugs.kde.org/"/>. | 624 | <trademark>KDE</trademark>'s bug tracker is located at <ulink |
776 | 625 | url="https://bugs.kde.org/"/>. | ||
777 | 586 | </para> | 626 | </para> |
778 | 587 | </note> | 627 | </note> |
779 | 588 | <procedure><title>Filing a bug report without a crash</title> | 628 | <procedure><title>Filing a bug report without a crash</title> |
780 | 589 | <step> | 629 | <step> |
781 | 590 | <para> | 630 | <para> |
785 | 591 | In a web browser, go to <ulink url="https://bugs.kde.org/"/> and either | 631 | In a web browser, go to <ulink url="https://bugs.kde.org/"/> and either create |
786 | 592 | create a new account or login. Once logged in, the following page will be | 632 | a new account or log in. Once logged in, the following page will be presented: |
784 | 593 | presented. | ||
787 | 594 | </para> | 633 | </para> |
788 | 595 | <para> | 634 | <para> |
789 | 596 | <example><title>Welcome to the KDE Bug Tracking System</title> | 635 | <example><title>Welcome to the KDE Bug Tracking System</title> |
790 | @@ -605,8 +644,8 @@ | |||
791 | 605 | <step> | 644 | <step> |
792 | 606 | <para> | 645 | <para> |
793 | 607 | <mousebutton>Click</mousebutton> the <guilabel>Report New Wish or Bug</guilabel> | 646 | <mousebutton>Click</mousebutton> the <guilabel>Report New Wish or Bug</guilabel> |
796 | 608 | link in the top-right-hand corner of the page to start the process of filing the | 647 | link in the top right-hand corner of the page to start the process of filing |
797 | 609 | bug report. The following page will be presented. | 648 | the bug report. The following page will be presented: |
798 | 610 | </para> | 649 | </para> |
799 | 611 | <para> | 650 | <para> |
800 | 612 | <example><title>Welcome to the KDE Bug Report Wizard!</title> | 651 | <example><title>Welcome to the KDE Bug Report Wizard!</title> |
801 | @@ -620,8 +659,8 @@ | |||
802 | 620 | </step> | 659 | </step> |
803 | 621 | <step> | 660 | <step> |
804 | 622 | <para> | 661 | <para> |
807 | 623 | <mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button. The | 662 | <mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button. |
808 | 624 | following page will be presented. | 663 | The following page will be presented: |
809 | 625 | </para> | 664 | </para> |
810 | 626 | <para> | 665 | <para> |
811 | 627 | <example><title>Software Configuration</title> | 666 | <example><title>Software Configuration</title> |
812 | @@ -639,7 +678,7 @@ | |||
813 | 639 | <guilabel>Distribution Method</guilabel> (Should be <guilabel>Ubuntu | 678 | <guilabel>Distribution Method</guilabel> (Should be <guilabel>Ubuntu |
814 | 640 | Packages</guilabel>) from the drop-down menus. <mousebutton>Click</mousebutton> | 679 | Packages</guilabel>) from the drop-down menus. <mousebutton>Click</mousebutton> |
815 | 641 | the <guibutton>Continue</guibutton> button when finished with the selections. | 680 | the <guibutton>Continue</guibutton> button when finished with the selections. |
817 | 642 | The following page will be presented. | 681 | The following page will be presented: |
818 | 643 | </para> | 682 | </para> |
819 | 644 | <para> | 683 | <para> |
820 | 645 | <example><title>Application Selection</title> | 684 | <example><title>Application Selection</title> |
821 | @@ -660,10 +699,10 @@ | |||
822 | 660 | </step> | 699 | </step> |
823 | 661 | <step> | 700 | <step> |
824 | 662 | <para> | 701 | <para> |
827 | 663 | Under the <guilabel>Find</guilabel> section under the | 702 | Under the <guilabel>Find</guilabel> section in the |
828 | 664 | <guilabel>Application</guilabel> list, fill in the <guilabel>Keyword | 703 | <guilabel>Application</guilabel> list, fill in the <guilabel>Keyword |
829 | 665 | Search</guilabel> text box with the application being reported. It should look | 704 | Search</guilabel> text box with the application being reported. It should look |
831 | 666 | similar to the following image. | 705 | similar to the following image: |
832 | 667 | </para> | 706 | </para> |
833 | 668 | <para> | 707 | <para> |
834 | 669 | <example><title>Application Selection (Search for application)</title> | 708 | <example><title>Application Selection (Search for application)</title> |
835 | @@ -681,8 +720,8 @@ | |||
836 | 681 | </step> | 720 | </step> |
837 | 682 | <step> | 721 | <step> |
838 | 683 | <para> | 722 | <para> |
841 | 684 | <mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button. The | 723 | <mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button. |
842 | 685 | following page will be presented. | 724 | The following page will be presented: |
843 | 686 | </para> | 725 | </para> |
844 | 687 | <para> | 726 | <para> |
845 | 688 | <example><title>General Information</title> | 727 | <example><title>General Information</title> |
846 | @@ -700,7 +739,7 @@ | |||
847 | 700 | information similar to the example under the text box. Select | 739 | information similar to the example under the text box. Select |
848 | 701 | <guilabel>Linux</guilabel> in the <guilabel>Operating System</guilabel> | 740 | <guilabel>Linux</guilabel> in the <guilabel>Operating System</guilabel> |
849 | 702 | drop-down menu. When completed, <mousebutton>Click</mousebutton> the | 741 | drop-down menu. When completed, <mousebutton>Click</mousebutton> the |
851 | 703 | <guibutton>Continue</guibutton> button. The following page will be presented. | 742 | <guibutton>Continue</guibutton> button. The following page will be presented: |
852 | 704 | </para> | 743 | </para> |
853 | 705 | <para> | 744 | <para> |
854 | 706 | <example><title>Check for Duplicate Bug Reports</title> | 745 | <example><title>Check for Duplicate Bug Reports</title> |
855 | @@ -714,12 +753,12 @@ | |||
856 | 714 | </step> | 753 | </step> |
857 | 715 | <step> | 754 | <step> |
858 | 716 | <para> | 755 | <para> |
865 | 717 | If a duplicate report is found, click on that report ID to view the report. If | 756 | If a duplicate report is found, click on that report <acronym>ID</acronym> to |
866 | 718 | it is a duplicate and more information is needed, then simply enter text in the | 757 | view the report. If it is a duplicate and more information is needed, then |
867 | 719 | large text box confirming it. If more information is not needed, nothing need | 758 | enter text into the large text box confirming it. If more information is not |
868 | 720 | be entered. If no duplicate reports are found, <mousebutton>Click</mousebutton> | 759 | needed, nothing needs to be entered. If no duplicate reports are found, |
869 | 721 | the <guibutton>Continue</guibutton> button. The following page will be | 760 | <mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button. |
870 | 722 | presented. | 761 | The following page will be presented: |
871 | 723 | </para> | 762 | </para> |
872 | 724 | <para> | 763 | <para> |
873 | 725 | <example><title>Bug Entry Form</title> | 764 | <example><title>Bug Entry Form</title> |
874 | @@ -734,11 +773,11 @@ | |||
875 | 734 | <step> | 773 | <step> |
876 | 735 | <para> | 774 | <para> |
877 | 736 | The <guilabel>Severity</guilabel> (required) drop-down menu should display the | 775 | The <guilabel>Severity</guilabel> (required) drop-down menu should display the |
883 | 737 | <guilabel>Bug - Bug report (no crashes)</guilabel> option. In the <guilabel>Long | 776 | <guilabel>Bug - Bug report (no crashes)</guilabel> option. In the |
884 | 738 | Description in English</guilabel> (required) text box, enter all information | 777 | <guilabel>Long Description in English</guilabel> (required) text box, enter all |
885 | 739 | pertaining to the bug report. When completed, <mousebutton>Click</mousebutton> | 778 | information pertaining to the bug report. When completed, |
886 | 740 | the <guibutton>Continue</guibutton> button. The following page will be | 779 | <mousebutton>Click</mousebutton> the <guibutton>Continue</guibutton> button. |
887 | 741 | presented. | 780 | The following page will be presented: |
888 | 742 | </para> | 781 | </para> |
889 | 743 | <para> | 782 | <para> |
890 | 744 | <example><title>Bug Submitted</title> | 783 | <example><title>Bug Submitted</title> |
891 | @@ -752,27 +791,30 @@ | |||
892 | 752 | </step> | 791 | </step> |
893 | 753 | </procedure> | 792 | </procedure> |
894 | 754 | <para> | 793 | <para> |
899 | 755 | <emphasis role="bold">Congratulations on making a successful non-crash related | 794 | <emphasis>Congratulations on making a successful non-crash-related bug |
900 | 756 | bug report!</emphasis> Identifying and reporting bugs are essential to improving | 795 | report!</emphasis> Identifying and reporting bugs are essential to improving |
901 | 757 | &kubuntu; and KDE. Some emails may be sent to the registered address to update | 796 | &kubuntu; and <trademark>KDE</trademark>. Some emails may be sent to the |
902 | 758 | progress or to allow developers to get additional information about the bug. | 797 | registered address to update progress or to allow developers to get additional |
903 | 798 | information about the bug. | ||
904 | 759 | </para> | 799 | </para> |
905 | 760 | </sect2> | 800 | </sect2> |
906 | 761 | <sect2 id="filing-non-crash-lp"> | 801 | <sect2 id="filing-non-crash-lp"> |
907 | 762 | <title>Launchpad</title> | 802 | <title>Launchpad</title> |
908 | 763 | <para> | 803 | <para> |
915 | 764 | Filing non-crash related bug reports in non-KDE applications can be done either | 804 | Filing non-crash-related bug reports in non-<trademark>KDE</trademark> |
916 | 765 | by going to <ulink url="https://bugs.launchpad.net/ubuntu/+filebug"/> in a web | 805 | applications can be done either by going to <ulink |
917 | 766 | browser or by using the <application>Apport</application> bug reporting | 806 | url="https://bugs.launchpad.net/ubuntu/+filebug"/> in a web browser or by using |
918 | 767 | application. The following procedure will demonstrate the use of | 807 | the <application>Apport</application> bug reporting application. The following |
919 | 768 | <application>Apport</application> as this is the recommended way of filing | 808 | procedure will demonstrate the use of <application>Apport</application> as this |
920 | 769 | Ubuntu or non-KDE related bug reports. | 809 | is the recommended way of filing &ubuntu; or |
921 | 810 | non-<trademark>KDE</trademark>-related bug reports: | ||
922 | 770 | </para> | 811 | </para> |
923 | 771 | <procedure><title>Filing a bug report without a crash</title> | 812 | <procedure><title>Filing a bug report without a crash</title> |
924 | 772 | <step> | 813 | <step> |
925 | 773 | <para> | 814 | <para> |
928 | 774 | Open <application>KRunner</application>, the KDE run command interface, by | 815 | Open <application>KRunner</application>, the <trademark>KDE</trademark> run |
929 | 775 | pressing <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. | 816 | command interface, by pressing |
930 | 817 | <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. | ||
931 | 776 | </para> | 818 | </para> |
932 | 777 | <para> | 819 | <para> |
933 | 778 | <example><title>KRunner</title> | 820 | <example><title>KRunner</title> |
934 | @@ -786,10 +828,11 @@ | |||
935 | 786 | </step> | 828 | </step> |
936 | 787 | <step> | 829 | <step> |
937 | 788 | <para> | 830 | <para> |
942 | 789 | In the <application>KRunner</application> dialog, enter <userinput>apport-bug -p | 831 | In the <application>KRunner</application> dialog, enter |
943 | 790 | PROGRAM_NAME</userinput>. Replace <emphasis>PROGRAM_NAME</emphasis> with the | 832 | <userinput>apport-bug -p PROGRAM_NAME</userinput>. Replace |
944 | 791 | name of the program the bug report is for. Press <keycap>Enter</keycap> when | 833 | <emphasis>PROGRAM_NAME</emphasis> with the name of the program the bug report |
945 | 792 | complete. The following dialog will be presented. | 834 | is for. Press <keycap>Enter</keycap> when complete. The following dialog will |
946 | 835 | be presented: | ||
947 | 793 | </para> | 836 | </para> |
948 | 794 | <para> | 837 | <para> |
949 | 795 | <example><title>Collecting Problem Information</title> | 838 | <example><title>Collecting Problem Information</title> |
950 | @@ -818,9 +861,9 @@ | |||
951 | 818 | </step> | 861 | </step> |
952 | 819 | <step> | 862 | <step> |
953 | 820 | <para> | 863 | <para> |
957 | 821 | <mousebutton>Click</mousebutton> the <guibutton>Details...</guibutton> button to | 864 | <mousebutton>Click</mousebutton> the <guibutton>Details...</guibutton> button |
958 | 822 | see details of the report to be followed. The following dialog will be | 865 | to see details of the report to be followed. The following dialog will be |
959 | 823 | presented. | 866 | presented: |
960 | 824 | </para> | 867 | </para> |
961 | 825 | <para> | 868 | <para> |
962 | 826 | <example><title>Report Details</title> | 869 | <example><title>Report Details</title> |
963 | @@ -835,7 +878,7 @@ | |||
964 | 835 | <step> | 878 | <step> |
965 | 836 | <para> | 879 | <para> |
966 | 837 | <mousebutton>Click</mousebutton> the <guibutton>Send</guibutton> button to send | 880 | <mousebutton>Click</mousebutton> the <guibutton>Send</guibutton> button to send |
968 | 838 | the report to the developers. The following progress dialog will be presented. | 881 | the report to the developers. The following progress dialog will be presented: |
969 | 839 | </para> | 882 | </para> |
970 | 840 | <para> | 883 | <para> |
971 | 841 | <example><title>Uploading Problem Information</title> | 884 | <example><title>Uploading Problem Information</title> |
972 | @@ -850,7 +893,7 @@ | |||
973 | 850 | <step> | 893 | <step> |
974 | 851 | <para> | 894 | <para> |
975 | 852 | After the information has been uploaded, the web browser will open and display | 895 | After the information has been uploaded, the web browser will open and display |
977 | 853 | a page similar to the following. | 896 | a page similar to the following: |
978 | 854 | </para> | 897 | </para> |
979 | 855 | <para> | 898 | <para> |
980 | 856 | <example><title>Please wait while bug data is processed.</title> | 899 | <example><title>Please wait while bug data is processed.</title> |
981 | @@ -862,7 +905,7 @@ | |||
982 | 862 | </example> | 905 | </example> |
983 | 863 | </para> | 906 | </para> |
984 | 864 | <para> | 907 | <para> |
986 | 865 | After the bug data is processed, the following page will be presented. | 908 | After the bug data is processed, the following page will be presented: |
987 | 866 | </para> | 909 | </para> |
988 | 867 | <para> | 910 | <para> |
989 | 868 | <example><title>Report a bug... (Summary)</title> | 911 | <example><title>Report a bug... (Summary)</title> |
990 | @@ -876,9 +919,9 @@ | |||
991 | 876 | </step> | 919 | </step> |
992 | 877 | <step> | 920 | <step> |
993 | 878 | <para> | 921 | <para> |
997 | 879 | Enter text in the <guilabel>Summary</guilabel> text box that describes the bug | 922 | Enter text that describes the bug into the <guilabel>Summary</guilabel> text |
998 | 880 | with a few words. When finished, <mousebutton>Click</mousebutton> the | 923 | box. When finished, <mousebutton>Click</mousebutton> the |
999 | 881 | <guibutton>Next</guibutton> button. The following page will be presented. | 924 | <guibutton>Next</guibutton> button. The following page will be presented: |
1000 | 882 | </para> | 925 | </para> |
1001 | 883 | <para> | 926 | <para> |
1002 | 884 | <example><title>Report a bug... (Further information)</title> | 927 | <example><title>Report a bug... (Further information)</title> |
1003 | @@ -895,7 +938,7 @@ | |||
1004 | 895 | Enter text in the <guilabel>Further information</guilabel> text box describing | 938 | Enter text in the <guilabel>Further information</guilabel> text box describing |
1005 | 896 | the bug in detail. When complete, <mousebutton>Click</mousebutton> the | 939 | the bug in detail. When complete, <mousebutton>Click</mousebutton> the |
1006 | 897 | <guibutton>Submit Bug Report</guibutton> button. The following page will be | 940 | <guibutton>Submit Bug Report</guibutton> button. The following page will be |
1008 | 898 | presented. | 941 | presented: |
1009 | 899 | </para> | 942 | </para> |
1010 | 900 | <para> | 943 | <para> |
1011 | 901 | <example><title>Thank you for your bug report</title> | 944 | <example><title>Thank you for your bug report</title> |
1012 | @@ -909,8 +952,8 @@ | |||
1013 | 909 | </step> | 952 | </step> |
1014 | 910 | </procedure> | 953 | </procedure> |
1015 | 911 | <para> | 954 | <para> |
1018 | 912 | <emphasis role="bold">Congratulations on making a successful non-crash related | 955 | <emphasis>Congratulations on making a successful non-crash related bug |
1019 | 913 | bug report!</emphasis> Identifying and reporting bugs are essential to improving | 956 | report!</emphasis> Identifying and reporting bugs are essential to improving |
1020 | 914 | &kubuntu;. Some emails may be sent to the registered address to update progress | 957 | &kubuntu;. Some emails may be sent to the registered address to update progress |
1021 | 915 | or to allow developers to get additional information about the bug. | 958 | or to allow developers to get additional information about the bug. |
1022 | 916 | </para> | 959 | </para> |
1023 | @@ -920,21 +963,24 @@ | |||
1024 | 920 | <sect1 id="filing-wishlist"> | 963 | <sect1 id="filing-wishlist"> |
1025 | 921 | <title>Filing a Feature Request or Wishlist Report</title> | 964 | <title>Filing a Feature Request or Wishlist Report</title> |
1026 | 922 | <para> | 965 | <para> |
1029 | 923 | The easiest way to request a new feature in either an application or the | 966 | The easiest way to request a new feature, in either an application or the |
1030 | 924 | operating system is to file a bug, otherwise known as a wishlist report. | 967 | operating system, is to file a bug — otherwise known as a wishlist |
1031 | 968 | report. | ||
1032 | 925 | </para> | 969 | </para> |
1033 | 926 | <sect2 id="filing-wishlist-kde"> | 970 | <sect2 id="filing-wishlist-kde"> |
1034 | 927 | <title>KDE</title> | 971 | <title>KDE</title> |
1035 | 928 | <para> | 972 | <para> |
1038 | 929 | Filing a feature request report in KDE is exactly the same as filing a <link | 973 | Filing a feature request report in <trademark>KDE</trademark> is exactly the |
1039 | 930 | linkend="filing-non-crash-kde">non-crash KDE bug report</link>. | 974 | same as filing a <link linkend="filing-non-crash-kde">non-crash |
1040 | 975 | <trademark>KDE</trademark> bug report</link>. | ||
1041 | 931 | </para> | 976 | </para> |
1042 | 932 | </sect2> | 977 | </sect2> |
1043 | 933 | <sect2 id="filing-wishlist-lp"> | 978 | <sect2 id="filing-wishlist-lp"> |
1044 | 934 | <title>Launchpad</title> | 979 | <title>Launchpad</title> |
1045 | 935 | <para> | 980 | <para> |
1046 | 936 | Filing a wishlist report for &kubuntu; is exactly the same as filing a <link | 981 | Filing a wishlist report for &kubuntu; is exactly the same as filing a <link |
1048 | 937 | linkend="filing-non-crash-lp">non-crash Launchpad bug report</link>. | 982 | linkend="filing-non-crash-lp">non-crash <trademark>Launchpad</trademark> bug |
1049 | 983 | report</link>. | ||
1050 | 938 | </para> | 984 | </para> |
1051 | 939 | </sect2> | 985 | </sect2> |
1052 | 940 | </sect1> | 986 | </sect1> |
1053 | 941 | 987 | ||
1054 | === modified file 'docs/cli/C/cli.xml' | |||
1055 | --- docs/cli/C/cli.xml 2011-09-04 21:26:14 +0000 | |||
1056 | +++ docs/cli/C/cli.xml 2012-03-22 07:41:34 +0000 | |||
1057 | @@ -13,9 +13,9 @@ | |||
1058 | 13 | &legalnotice; | 13 | &legalnotice; |
1059 | 14 | <abstract> | 14 | <abstract> |
1060 | 15 | <para> | 15 | <para> |
1064 | 16 | This document provides a brief description of the Linux command line. It is not | 16 | This document provides a brief description of the <trademark>Linux</trademark> |
1065 | 17 | a complete guide to the command line, but rather an introduction to complement | 17 | command line. It is not a complete guide, but rather an introduction to |
1066 | 18 | &kubuntu;'s graphical tools. | 18 | complement &kubuntu;'s graphical tools. |
1067 | 19 | </para> | 19 | </para> |
1068 | 20 | </abstract> | 20 | </abstract> |
1069 | 21 | </articleinfo> | 21 | </articleinfo> |
1070 | @@ -25,37 +25,41 @@ | |||
1071 | 25 | 25 | ||
1072 | 26 | <para> | 26 | <para> |
1073 | 27 | <emphasis> | 27 | <emphasis> |
1080 | 28 | "Under Linux there are GUIs (graphical user interfaces), where you can point and | 28 | "Under <trademark>Linux</trademark> there are <acronym>GUI</acronym>s |
1081 | 29 | click and drag, and hopefully get work done without first reading lots of | 29 | (graphical user interfaces), where you can point and click and drag and |
1082 | 30 | documentation. The traditional Unix environment is a CLI (command line | 30 | hopefully get work done without first reading lots of documentation. The |
1083 | 31 | interface), where you type commands to tell the computer what to do. That is | 31 | traditional <trademark>Unix</trademark> environment is a |
1084 | 32 | faster and more powerful, but requires finding out what the commands are." -- | 32 | <acronym>CLI</acronym> (command line interface), where you type commands to |
1085 | 33 | from <emphasis role="strong">man intro(1)</emphasis> | 33 | tell the computer what to do. That is faster and more powerful, but requires |
1086 | 34 | finding out what the commands are." -- from <emphasis>man intro(1)</emphasis> | ||
1087 | 34 | </emphasis> | 35 | </emphasis> |
1088 | 35 | </para> | 36 | </para> |
1089 | 36 | <para> | 37 | <para> |
1093 | 37 | This guide describes some basic GNU/Linux shell commands. It is not intended to | 38 | This guide describes some basic <trademark>GNU</trademark>/ |
1094 | 38 | be a complete guide to the command line, just an introduction to complement | 39 | <trademark>Linux</trademark> shell commands. It is not intended to be a |
1095 | 39 | &kubuntu;'s graphical tools. | 40 | complete guide to the command line, just an introduction to complement |
1096 | 41 | &kubuntu;'s graphical tools. | ||
1097 | 40 | </para> | 42 | </para> |
1098 | 41 | <para> | 43 | <para> |
1099 | 42 | <itemizedlist> | 44 | <itemizedlist> |
1100 | 43 | <listitem> | 45 | <listitem> |
1101 | 44 | <para> | 46 | <para> |
1103 | 45 | All command names, file names or paths to directories will be shown using a <command>monospace font</command>. | 47 | All command names, file names, or paths to directories will be shown using a |
1104 | 48 | <command>monospace font</command>. | ||
1105 | 46 | </para> | 49 | </para> |
1106 | 47 | </listitem> | 50 | </listitem> |
1107 | 48 | <listitem> | 51 | <listitem> |
1108 | 49 | <para> | 52 | <para> |
1110 | 50 | The commands should be issued from a command prompt within a | 53 | The commands should be issued from a command prompt within a |
1111 | 51 | <application>Terminal</application> and will be shown as: | 54 | <application>Terminal</application> and will be shown as: |
1112 | 52 | <screen>command to type</screen> | 55 | <screen>command to type</screen> |
1113 | 53 | </para> | 56 | </para> |
1114 | 54 | </listitem> | 57 | </listitem> |
1115 | 55 | <listitem> | 58 | <listitem> |
1116 | 56 | <para> | 59 | <para> |
1119 | 57 | <emphasis role="strong">Command Line Linux is case sensitive.</emphasis> User, | 60 | <emphasis>Command Line <trademark>Linux</trademark> is case |
1120 | 58 | user, and USER are each different and distinct in Linux. | 61 | sensitive.</emphasis> User, user, and USER are each different and distinct in |
1121 | 62 | <trademark>Linux</trademark>. | ||
1122 | 59 | </para> | 63 | </para> |
1123 | 60 | </listitem> | 64 | </listitem> |
1124 | 61 | </itemizedlist> | 65 | </itemizedlist> |
1125 | @@ -65,12 +69,12 @@ | |||
1126 | 65 | <sect1 id="terminal"> | 69 | <sect1 id="terminal"> |
1127 | 66 | <title>Starting A Terminal</title> | 70 | <title>Starting A Terminal</title> |
1128 | 67 | <para> | 71 | <para> |
1131 | 68 | &kubuntu;'s Terminal application is called | 72 | &kubuntu;'s Terminal application is called <application>Konsole</application>, |
1132 | 69 | <application>Konsole</application>, and is opened by going to &menukonsole;. | 73 | and is opened by going to &menukonsole;. |
1133 | 70 | </para> | 74 | </para> |
1134 | 71 | <para> | 75 | <para> |
1135 | 72 | <example> | 76 | <example> |
1137 | 73 | <title>&kubuntu;'s terminal - Konsole</title> | 77 | <title>&kubuntu;'s terminal - Konsole</title> |
1138 | 74 | <mediaobject> | 78 | <mediaobject> |
1139 | 75 | <imageobject> | 79 | <imageobject> |
1140 | 76 | <imagedata fileref="help:/images/C/C/konsole.png" format="PNG"/> | 80 | <imagedata fileref="help:/images/C/C/konsole.png" format="PNG"/> |
1141 | @@ -86,12 +90,10 @@ | |||
1142 | 86 | <sect2 id="pwd"> | 90 | <sect2 id="pwd"> |
1143 | 87 | <title>pwd - print working directory</title> | 91 | <title>pwd - print working directory</title> |
1144 | 88 | <para> | 92 | <para> |
1151 | 89 | The <command>pwd</command> command displays the directory where the user is | 93 | The <command>pwd</command> command displays the directory where the user is |
1152 | 90 | currently | 94 | currently located. (<acronym>pwd</acronym> stands for <quote>print working |
1153 | 91 | located. (<acronym>pwd</acronym> stands for <quote>print working | 95 | directory</quote>). For example, typing <screen>pwd</screen> while in the |
1154 | 92 | directory</quote>). For example, typing | 96 | <filename class="directory">Desktop</filename> directory will show |
1149 | 93 | <screen>pwd</screen> while in the <filename | ||
1150 | 94 | class="directory">Desktop</filename> will show | ||
1155 | 95 | <computeroutput>/home/[username]/Desktop</computeroutput>. | 97 | <computeroutput>/home/[username]/Desktop</computeroutput>. |
1156 | 96 | <note> | 98 | <note> |
1157 | 97 | <para> | 99 | <para> |
1158 | @@ -105,9 +107,9 @@ | |||
1159 | 105 | <title>cd - change directory</title> | 107 | <title>cd - change directory</title> |
1160 | 106 | <para> | 108 | <para> |
1161 | 107 | The <command>cd</command> command changes directories. (<acronym>cd</acronym> | 109 | The <command>cd</command> command changes directories. (<acronym>cd</acronym> |
1165 | 108 | stands for | 110 | stands for <quote>change directory</quote>). When a terminal window is opened, |
1166 | 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 the | 111 | it will be in the user's home directory. Moving around the file system requires |
1167 | 110 | use of the <command>cd</command>. | 112 | the use of the <command>cd</command> command. |
1168 | 111 | </para> | 113 | </para> |
1169 | 112 | <itemizedlist> | 114 | <itemizedlist> |
1170 | 113 | <listitem> | 115 | <listitem> |
1171 | @@ -125,8 +127,8 @@ | |||
1172 | 125 | </para> | 127 | </para> |
1173 | 126 | <note> | 128 | <note> |
1174 | 127 | <para> | 129 | <para> |
1177 | 128 | The <command>~</command> character represents the current user's home directory. | 130 | The <command>~</command> character represents the current user's home |
1178 | 129 | As shown above, <command>cd ~</command> is equivalent to <command>cd | 131 | directory. As shown above, <command>cd ~</command> is equivalent to <command>cd |
1179 | 130 | /home/username/</command>. However, when running a command as root (using | 132 | /home/username/</command>. However, when running a command as root (using |
1180 | 131 | <command>sudo</command>, for example), <command>~</command> points to <filename | 133 | <command>sudo</command>, for example), <command>~</command> points to <filename |
1181 | 132 | class="directory">/root</filename>. When running a <command>cd</command> command | 134 | class="directory">/root</filename>. When running a <command>cd</command> command |
1182 | @@ -161,8 +163,8 @@ | |||
1183 | 161 | of <filename class="directory">/var/</filename>. For another example, typing: | 163 | of <filename class="directory">/var/</filename>. For another example, typing: |
1184 | 162 | <screen>cd ~/Desktop</screen> | 164 | <screen>cd ~/Desktop</screen> |
1185 | 163 | moves to the <filename | 165 | moves to the <filename |
1188 | 164 | class="directory">Desktop</filename> subdirectory inside the current user's home | 166 | class="directory">Desktop</filename> subdirectory inside the current user's |
1189 | 165 | directory. | 167 | home directory. |
1190 | 166 | </para> | 168 | </para> |
1191 | 167 | </listitem> | 169 | </listitem> |
1192 | 168 | </itemizedlist> | 170 | </itemizedlist> |
1193 | @@ -171,11 +173,9 @@ | |||
1194 | 171 | <title>ls - list files</title> | 173 | <title>ls - list files</title> |
1195 | 172 | <para> | 174 | <para> |
1196 | 173 | The <command>ls</command> command outputs a list of the files in the current | 175 | The <command>ls</command> command outputs a list of the files in the current |
1202 | 174 | directory. (<acronym>ls</acronym> is short for <quote>list</quote>). For example, | 176 | directory. (<acronym>ls</acronym> is short for <quote>list</quote>). For |
1203 | 175 | typing | 177 | example, typing <screen>ls ~</screen> will display the files that are in the |
1204 | 176 | <screen>ls ~</screen> | 178 | current user's home directory. |
1200 | 177 | will display the files that are in the current | ||
1201 | 178 | user's home directory. | ||
1205 | 179 | </para> | 179 | </para> |
1206 | 180 | <para> | 180 | <para> |
1207 | 181 | Used with the <command>-l</command> option, <command>ls</command> outputs other | 181 | Used with the <command>-l</command> option, <command>ls</command> outputs other |
1208 | @@ -185,34 +185,34 @@ | |||
1209 | 185 | <para> | 185 | <para> |
1210 | 186 | Used with the <command>-al</command> options, <command>ls</command> outputs | 186 | Used with the <command>-al</command> options, <command>ls</command> outputs |
1211 | 187 | the information associated with the <command>-l</command> option in addition to | 187 | the information associated with the <command>-l</command> option in addition to |
1214 | 188 | showing hidden files (<command>a</command> | 188 | showing hidden files (<command>a</command> option). |
1213 | 189 | option). | ||
1215 | 190 | </para> | 189 | </para> |
1216 | 191 | </sect2> | 190 | </sect2> |
1217 | 192 | <sect2 id="touch"> | 191 | <sect2 id="touch"> |
1218 | 193 | <title>touch - create empty file</title> | 192 | <title>touch - create empty file</title> |
1219 | 194 | <para> | 193 | <para> |
1227 | 195 | The <command>touch</command> command is used either to change a file's access | 194 | The <command>touch</command> command is used to change a file's access and |
1228 | 196 | and modification timestamps or to create a new empty file. For example, | 195 | modification timestamps or to create a new empty file. For example, |
1229 | 197 | <screen>touch foo</screen> | 196 | <screen>touch foo</screen> will create a new empty file named |
1230 | 198 | will create a new empty file named <filename>foo</filename>. If | 197 | <filename>foo</filename>. If <filename>foo</filename> is already a file, then |
1231 | 199 | <filename>foo</filename> is already a file, then using <command>touch</command> | 198 | using <command>touch</command> will update the timestamps on the file, which |
1232 | 200 | will update the timestamps on the file which will show | 199 | show the last time a file was <emphasis>touched</emphasis>. |
1226 | 201 | the last time a file was <emphasis>touched</emphasis>. | ||
1233 | 202 | </para> | 200 | </para> |
1234 | 203 | </sect2> | 201 | </sect2> |
1235 | 204 | <sect2 id="mkdir"> | 202 | <sect2 id="mkdir"> |
1236 | 205 | <title>mkdir - make directory</title> | 203 | <title>mkdir - make directory</title> |
1237 | 206 | <para> | 204 | <para> |
1240 | 207 | The <command>mkdir</command> command is used to create a new directory. (<acronym>mkdir</acronym> stands for <quote>make directory</quote>). To create a | 205 | The <command>mkdir</command> command is used to create a new directory. |
1241 | 208 | new directory named <filename class="directory">foobar</filename>, type: | 206 | (<acronym>mkdir</acronym> stands for <quote>make directory</quote>). To create |
1242 | 207 | a new directory named <filename class="directory">foobar</filename>, type: | ||
1243 | 209 | <screen>mkdir foobar</screen> | 208 | <screen>mkdir foobar</screen> |
1244 | 210 | </para> | 209 | </para> |
1245 | 211 | </sect2> | 210 | </sect2> |
1246 | 212 | <sect2 id="cp"> | 211 | <sect2 id="cp"> |
1247 | 213 | <title>cp - copy files or directories</title> | 212 | <title>cp - copy files or directories</title> |
1248 | 214 | <para> | 213 | <para> |
1250 | 215 | The <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 copy | 214 | The <command>cp</command> command makes a copy of a file or directory. |
1251 | 215 | (<acronym>cp</acronym> is short for <quote>copy</quote>). To make an exact copy | ||
1252 | 216 | of <filename>foo</filename> and name it <filename>bar</filename>, type: | 216 | of <filename>foo</filename> and name it <filename>bar</filename>, type: |
1253 | 217 | <screen>cp foo bar</screen> | 217 | <screen>cp foo bar</screen> |
1254 | 218 | To make an exact copy of the <filename class="directory">foo_dir</filename> | 218 | To make an exact copy of the <filename class="directory">foo_dir</filename> |
1255 | @@ -224,34 +224,32 @@ | |||
1256 | 224 | <title>mv - move files or directories</title> | 224 | <title>mv - move files or directories</title> |
1257 | 225 | <para> | 225 | <para> |
1258 | 226 | The <command>mv</command> command moves a file or directory to a different | 226 | The <command>mv</command> command moves a file or directory to a different |
1260 | 227 | location or will rename a file or directory. (<acronym>mv</acronym> is short for | 227 | location or renames a file or directory. (<acronym>mv</acronym> is short for |
1261 | 228 | <quote>move</quote>). To rename the file <filename>foo</filename> to | 228 | <quote>move</quote>). To rename the file <filename>foo</filename> to |
1270 | 229 | <filename>bar</filename>, type: | 229 | <filename>bar</filename>, type: <screen>mv foo bar</screen> To move the file |
1271 | 230 | <screen>mv foo bar</screen> | 230 | <filename>foo</filename> into the current user's <filename |
1272 | 231 | To move the file <filename>foo</filename> into the current user's <filename | 231 | class="directory">Desktop</filename> directory, type: <screen>mv foo |
1273 | 232 | class="directory">Desktop</filename> directory, type: | 232 | ~/Desktop</screen> This will not rename <filename>foo</filename> to |
1274 | 233 | <screen>mv foo ~/Desktop</screen> | 233 | <filename>Desktop</filename>, because <filename>foo</filename> is a file and |
1275 | 234 | This will not rename <filename>foo</filename> to <filename>Desktop</filename> | 234 | <filename class="directory">Desktop</filename> is a directory. |
1268 | 235 | because <filename>foo</filename> is a file and <filename | ||
1269 | 236 | class="directory">Desktop</filename> is a directory. | ||
1276 | 237 | </para> | 235 | </para> |
1277 | 238 | </sect2> | 236 | </sect2> |
1278 | 239 | <sect2 id="rm"> | 237 | <sect2 id="rm"> |
1279 | 240 | <title>rm - remove files or directories</title> | 238 | <title>rm - remove files or directories</title> |
1280 | 241 | <para> | 239 | <para> |
1283 | 242 | The <command>rm</command> command is used to delete files and directories. (<acronym>rm</acronym> is short for <quote>remove</quote>). To delete the file | 240 | The <command>rm</command> command is used to delete files and directories. |
1284 | 243 | <filename>foo</filename> for the current directory, type: | 241 | (<acronym>rm</acronym> is short for <quote>remove</quote>). To delete the file |
1285 | 242 | <filename>foo</filename> from the current directory, type: | ||
1286 | 244 | <screen>rm foo</screen> | 243 | <screen>rm foo</screen> |
1287 | 245 | </para> | 244 | </para> |
1288 | 246 | <para> | 245 | <para> |
1289 | 247 | By default, <command>rm</command> will not remove directories. To remove a | 246 | By default, <command>rm</command> will not remove directories. To remove a |
1297 | 248 | directory, you must use the <command>-r</command> option (also can be entered | 247 | directory, you must use the <command>-r</command> option (which can also be |
1298 | 249 | as either <command>-R</command> or <command>--recursive</command>). For example, | 248 | entered as <command>-R</command> or <command>--recursive</command>). For |
1299 | 250 | <screen>rm -r foobar</screen> or | 249 | example, <screen>rm -r foobar</screen> or <screen>rm -R foobar</screen> or |
1300 | 251 | <screen>rm -R foobar</screen> or | 250 | <screen>rm --recursive foobar</screen> will remove the directory |
1301 | 252 | <screen>rm --recursive foobar</screen> | 251 | <filename class="directory">foobar</filename> <emphasis> and all of its |
1302 | 253 | will remove the directory <filename class="directory">foobar</filename>, | 252 | contents!</emphasis> |
1296 | 254 | <emphasis role="strong"> and all of its contents!</emphasis> | ||
1303 | 255 | </para> | 253 | </para> |
1304 | 256 | </sect2> | 254 | </sect2> |
1305 | 257 | 255 | ||
1306 | @@ -265,8 +263,7 @@ | |||
1307 | 265 | <para> | 263 | <para> |
1308 | 266 | The <command>df</command> command displays filesystem disk space usage for all | 264 | The <command>df</command> command displays filesystem disk space usage for all |
1309 | 267 | partitions. (<acronym>df</acronym> stands for <quote>disk free</quote>). | 265 | partitions. (<acronym>df</acronym> stands for <quote>disk free</quote>). |
1312 | 268 | <screen>df -h</screen> | 266 | <screen>df -h</screen> will give information using megabytes |
1311 | 269 | will give information using megabytes | ||
1313 | 270 | (<abbrev>M</abbrev>) and gigabytes (<abbrev>G</abbrev>) instead of blocks | 267 | (<abbrev>M</abbrev>) and gigabytes (<abbrev>G</abbrev>) instead of blocks |
1314 | 271 | (<command>-h</command> means <quote>human readable</quote>). | 268 | (<command>-h</command> means <quote>human readable</quote>). |
1315 | 272 | </para> | 269 | </para> |
1316 | @@ -275,26 +272,24 @@ | |||
1317 | 275 | <title>free - display amount of free and used memory</title> | 272 | <title>free - display amount of free and used memory</title> |
1318 | 276 | <para> | 273 | <para> |
1319 | 277 | The <command>free</command> command displays the amount of free and used memory | 274 | The <command>free</command> command displays the amount of free and used memory |
1324 | 278 | in the system. | 275 | in the system. <screen>free -m</screen> will give the information using |
1325 | 279 | <screen>free -m</screen> | 276 | megabytes, which is probably the most useful for current computers. |
1322 | 280 | will give the information using megabytes, which is probably the most useful for | ||
1323 | 281 | current computers. | ||
1326 | 282 | </para> | 277 | </para> |
1327 | 283 | </sect2> | 278 | </sect2> |
1328 | 284 | <sect2 id="top"> | 279 | <sect2 id="top"> |
1329 | 285 | <title>top - display top consuming processes</title> | 280 | <title>top - display top consuming processes</title> |
1330 | 286 | <para> | 281 | <para> |
1336 | 287 | The <command>top</command> command displays information on the Linux system - | 282 | The <command>top</command> command displays information on the |
1337 | 288 | processes that are running, system resources including <acronym>CPU</acronym>, | 283 | <trademark>Linux</trademark> system - processes that are running, system |
1338 | 289 | <acronym>RAM</acronym> & swap usage, and the total number of tasks being | 284 | resources including <acronym>CPU</acronym>, <acronym>RAM</acronym> & swap |
1339 | 290 | run. To | 285 | usage, and the total number of tasks being run. To exit <command>top</command>, |
1340 | 291 | exit <command>top</command>, press <keycap>q</keycap>. | 286 | press <keycap>q</keycap>. |
1341 | 292 | </para> | 287 | </para> |
1342 | 293 | </sect2> | 288 | </sect2> |
1343 | 294 | <sect2 id="uname"> | 289 | <sect2 id="uname"> |
1344 | 295 | <title>uname - print details about the current machine</title> | 290 | <title>uname - print details about the current machine</title> |
1345 | 296 | <para> | 291 | <para> |
1347 | 297 | The <command>uname</command> command with the <command>-a</command> options | 292 | The <command>uname</command> command with the <command>-a</command> option |
1348 | 298 | displays all system information, including machine name, kernel name & | 293 | displays all system information, including machine name, kernel name & |
1349 | 299 | version, and other details. This command is useful for checking which kernel is | 294 | version, and other details. This command is useful for checking which kernel is |
1350 | 300 | in use. (<abbrev>uname</abbrev> is short for <quote>unix name</quote>). | 295 | in use. (<abbrev>uname</abbrev> is short for <quote>unix name</quote>). |
1351 | @@ -304,8 +299,8 @@ | |||
1352 | 304 | <title>lsb_release - print details about current Linux release</title> | 299 | <title>lsb_release - print details about current Linux release</title> |
1353 | 305 | <para> | 300 | <para> |
1354 | 306 | The <command>lsb_release</command> with the <command>-a</command> option prints | 301 | The <command>lsb_release</command> with the <command>-a</command> option prints |
1357 | 307 | version information for the Linux release in use. For example, typing: | 302 | version information for the <trademark>Linux</trademark> release in use. For |
1358 | 308 | <screen>lsb_release -a</screen> will display: | 303 | example, typing: <screen>lsb_release -a</screen> will display: |
1359 | 309 | <screen>No LSB modules are available. | 304 | <screen>No LSB modules are available. |
1360 | 310 | Distributor ID: Ubuntu | 305 | Distributor ID: Ubuntu |
1361 | 311 | Description: Ubuntu &distro-rev; | 306 | Description: Ubuntu &distro-rev; |
1362 | @@ -323,49 +318,41 @@ | |||
1363 | 323 | The following commands must be prefaced with the | 318 | The following commands must be prefaced with the |
1364 | 324 | <command>sudo</command> command. Please see <ulink | 319 | <command>sudo</command> command. Please see <ulink |
1365 | 325 | url="https://help.ubuntu.com/community/RootSudo">RootSudo</ulink> for | 320 | url="https://help.ubuntu.com/community/RootSudo">RootSudo</ulink> for |
1368 | 326 | information on using <command>sudo</command>. (<abbrev>sudo</abbrev> is short for | 321 | information on using <command>sudo</command>. (<abbrev>sudo</abbrev> is short |
1369 | 327 | <quote>superuser do</quote>). | 322 | for <quote>superuser do</quote>). |
1370 | 328 | </para> | 323 | </para> |
1371 | 329 | <sect2 id="add-group"> | 324 | <sect2 id="add-group"> |
1372 | 330 | <title>Adding a New Group</title> | 325 | <title>Adding a New Group</title> |
1373 | 331 | <para> | 326 | <para> |
1374 | 332 | The <command>addgroup</command> command is used to create a new group in the | 327 | The <command>addgroup</command> command is used to create a new group in the |
1379 | 333 | system. To create a new group, type: | 328 | system. To create a new group, type: <screen>sudo addgroup foobar</screen> The |
1380 | 334 | <screen>sudo addgroup foobar</screen> | 329 | above command will create a new group called <emphasis>foobar</emphasis>. |
1377 | 335 | The above command will create a new group called <emphasis | ||
1378 | 336 | role="strong">foobar</emphasis>. | ||
1381 | 337 | </para> | 330 | </para> |
1382 | 338 | </sect2> | 331 | </sect2> |
1383 | 339 | <sect2 id="add-user"> | 332 | <sect2 id="add-user"> |
1384 | 340 | <title>Adding a New User</title> | 333 | <title>Adding a New User</title> |
1385 | 341 | <para> | 334 | <para> |
1386 | 342 | The <command>adduser</command> command is used to create a new user on the | 335 | The <command>adduser</command> command is used to create a new user on the |
1390 | 343 | system. To create a new user, type: | 336 | system. To create a new user, type: <screen>adduser foobar</screen> which will |
1391 | 344 | <screen>adduser foobar</screen> | 337 | create a new user called <emphasis>foobar</emphasis>. |
1389 | 345 | which will create a new user called <emphasis role="strong">foobar</emphasis>. | ||
1392 | 346 | </para> | 338 | </para> |
1393 | 347 | </sect2> | 339 | </sect2> |
1394 | 348 | <sect2 id="passwd"> | 340 | <sect2 id="passwd"> |
1395 | 349 | <title>Add or Change a User Password</title> | 341 | <title>Add or Change a User Password</title> |
1396 | 350 | <para> | 342 | <para> |
1397 | 351 | The <command>passwd</command> command is used to assign a new password to a | 343 | The <command>passwd</command> command is used to assign a new password to a |
1407 | 352 | new user or to change the current password for an existing user. To add a | 344 | new user or change the current password for an existing user. To add a password |
1408 | 353 | password or change the password for the user <emphasis | 345 | or change the password for the user <emphasis>foobar</emphasis>, type: |
1409 | 354 | role="strong">foobar</emphasis>, | 346 | <screen>passwd foobar</screen> For new users, this will generate a prompt to |
1410 | 355 | type: | 347 | enter the new password. For an existing user, there will be a prompt for the |
1411 | 356 | <screen>passwd foobar</screen> | 348 | existing password before the prompt for a new password. |
1403 | 357 | For new users, this will generate a prompt to enter the new password. For | ||
1404 | 358 | an | ||
1405 | 359 | existing user, there will be a prompt for the existing password before the | ||
1406 | 360 | prompt for a new password. | ||
1412 | 361 | </para> | 349 | </para> |
1413 | 362 | </sect2> | 350 | </sect2> |
1414 | 363 | <sect2 id="assign-user-group"> | 351 | <sect2 id="assign-user-group"> |
1415 | 364 | <title>Assign User to Group</title> | 352 | <title>Assign User to Group</title> |
1416 | 365 | <para> | 353 | <para> |
1420 | 366 | To assign the user <emphasis role="strong">foobar</emphasis> to the group | 354 | To assign the user <emphasis>foobar</emphasis> to the group |
1421 | 367 | <emphasis role="strong">barfoo</emphasis>, type: | 355 | <emphasis>barfoo</emphasis>, type: <screen>adduser foobar barfoo</screen> |
1419 | 368 | <screen>adduser foobar barfoo</screen> | ||
1422 | 369 | </para> | 356 | </para> |
1423 | 370 | </sect2> | 357 | </sect2> |
1424 | 371 | </sect1> | 358 | </sect1> |
1425 | @@ -374,20 +361,20 @@ | |||
1426 | 374 | <sect1 id="options"> | 361 | <sect1 id="options"> |
1427 | 375 | <title>Options</title> | 362 | <title>Options</title> |
1428 | 376 | <para> | 363 | <para> |
1434 | 377 | The default behavior for a command may usually be modified by adding <command>--option</command> to the command. For example, the <link | 364 | The default behavior for a command may usually be modified by adding |
1435 | 378 | linkend="ls"><command>ls</command></link> command has an | 365 | <command>--option</command> to the command. For example, the <link |
1436 | 379 | <command>-s</command> option. The <command>ls -s</command> will include file | 366 | linkend="ls"><command>ls</command></link> command has an <command>-s</command> |
1437 | 380 | sizes in the listing. There is also a <command>-h</command> option to display | 367 | option. The <command>ls -s</command> will include file sizes in the listing. |
1438 | 381 | file sizes in a <quote>human readable</quote> format. | 368 | There is also a <command>-h</command> option to display file sizes in a |
1439 | 369 | <quote>human readable</quote> format. | ||
1440 | 382 | </para> | 370 | </para> |
1441 | 383 | <para> | 371 | <para> |
1442 | 384 | Options can be grouped in clusters, so | 372 | Options can be grouped in clusters, so |
1443 | 385 | <screen>ls -sh</screen> | 373 | <screen>ls -sh</screen> |
1444 | 386 | is the same command as | 374 | is the same command as |
1445 | 387 | <screen> ls -s -h</screen> | 375 | <screen> ls -s -h</screen> |
1449 | 388 | Most options have a long version, prefixed with two dashes instead of one, so | 376 | Most options have a long version prefixed with two dashes instead of one, so |
1450 | 389 | <screen>ls --size --human-readable</screen> | 377 | <screen>ls --size --human-readable</screen> is the same command as |
1448 | 390 | is also the same command as | ||
1451 | 391 | <screen>ls -sh</screen> | 378 | <screen>ls -sh</screen> |
1452 | 392 | </para> | 379 | </para> |
1453 | 393 | </sect1> | 380 | </sect1> |
1454 | @@ -396,14 +383,13 @@ | |||
1455 | 396 | <sect1 id="man-help"> | 383 | <sect1 id="man-help"> |
1456 | 397 | <title><quote>Man</quote> and Getting Help</title> | 384 | <title><quote>Man</quote> and Getting Help</title> |
1457 | 398 | <para> | 385 | <para> |
1461 | 399 | <emphasis role="strong"><emphasis>command</emphasis> --help</emphasis> and | 386 | <emphasis><emphasis>command</emphasis> --help</emphasis> and |
1462 | 400 | <command>man</command> <emphasis | 387 | <command>man</command> <emphasis>command</emphasis> are the two most important |
1460 | 401 | role="strong"><emphasis>command</emphasis></emphasis> are the two most important | ||
1463 | 402 | tools at the command line. | 388 | tools at the command line. |
1464 | 403 | </para> | 389 | </para> |
1465 | 404 | <para> | 390 | <para> |
1466 | 405 | Virtually all commands understand the <command>-h</command> (or | 391 | Virtually all commands understand the <command>-h</command> (or |
1468 | 406 | <command>--help</command>) option which will produce a short usage description | 392 | <command>--help</command>) option, which will produce a short usage description |
1469 | 407 | of the command and its options, then exit back to the command prompt. Type: | 393 | of the command and its options, then exit back to the command prompt. Type: |
1470 | 408 | <screen>man -h</screen> | 394 | <screen>man -h</screen> |
1471 | 409 | or | 395 | or |
1472 | @@ -411,33 +397,29 @@ | |||
1473 | 411 | to see this in action. | 397 | to see this in action. |
1474 | 412 | </para> | 398 | </para> |
1475 | 413 | <para> | 399 | <para> |
1478 | 414 | Every command and nearly every application in Linux has a | 400 | Every command and nearly every application in <trademark>Linux</trademark> has |
1479 | 415 | <abbrev>man</abbrev> (manual) file. It is as simple as typing <command>man | 401 | a <abbrev>man</abbrev> (manual) file. It is as simple as typing <command>man |
1480 | 416 | command</command> to bring up a longer manual entry for the specified command. | 402 | command</command> to bring up a longer manual entry for the specified command. |
1484 | 417 | For example: | 403 | For example: <screen>man mv</screen> brings up the <command>mv</command> |
1485 | 418 | <screen>man mv</screen> | 404 | manual. |
1483 | 419 | brings up the <command>mv</command> manual. | ||
1486 | 420 | </para> | 405 | </para> |
1487 | 421 | <para> | 406 | <para> |
1488 | 422 | Move up and down the man file with the arrow keys, and quit back to the command | 407 | Move up and down the man file with the arrow keys, and quit back to the command |
1489 | 423 | prompt with <keycap>q</keycap>. | 408 | prompt with <keycap>q</keycap>. |
1490 | 424 | </para> | 409 | </para> |
1491 | 425 | <para> | 410 | <para> |
1495 | 426 | <screen>man man</screen> | 411 | <screen>man man</screen> brings up the manual entry for the |
1496 | 427 | brings up the manual entry for the <command>man</command> command, which is a | 412 | <command>man</command> command, which is a good place to start. |
1494 | 428 | good place to start. | ||
1497 | 429 | </para> | 413 | </para> |
1498 | 430 | <para> | 414 | <para> |
1503 | 431 | <screen>man intro</screen> | 415 | <screen>man intro</screen> is especially useful. It displays the |
1504 | 432 | is especially useful. It displays the <quote>introduction to user | 416 | <quote>introduction to user commands</quote> which is a well-written, brief |
1505 | 433 | commands</quote> which is a well-written, brief introduction to the Linux | 417 | introduction to the <trademark>Linux</trademark> command line. |
1502 | 434 | command line. | ||
1506 | 435 | </para> | 418 | </para> |
1507 | 436 | <para> | 419 | <para> |
1508 | 437 | There are also <command>info</command> pages, which generally go into more | 420 | There are also <command>info</command> pages, which generally go into more |
1512 | 438 | detail than <command>man</command> pages. Try: | 421 | detail than <command>man</command> pages. Try: <screen>info info</screen> for |
1513 | 439 | <screen>info info</screen> | 422 | the introduction to info pages. |
1511 | 440 | for the introduction to info pages. | ||
1514 | 441 | </para> | 423 | </para> |
1515 | 442 | <sect2 id="searching-for-man-files"> | 424 | <sect2 id="searching-for-man-files"> |
1516 | 443 | <title>Searching for man files</title> | 425 | <title>Searching for man files</title> |
1517 | @@ -473,14 +455,14 @@ | |||
1518 | 473 | There are often situations that require text to be pasted into the terminal. | 455 | There are often situations that require text to be pasted into the terminal. |
1519 | 474 | </para> | 456 | </para> |
1520 | 475 | <para> | 457 | <para> |
1522 | 476 | Text copied from a web page using | 458 | Text copied from a web page using |
1523 | 477 | <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> won't paste with | 459 | <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> won't paste with |
1524 | 478 | <keycombo><keycap>Ctrl</keycap><keycap>V</keycap></keycombo> as it does in | 460 | <keycombo><keycap>Ctrl</keycap><keycap>V</keycap></keycombo> as it does in |
1530 | 479 | other applications because the | 461 | other applications, because the terminal uses the |
1531 | 480 | terminal uses a different combination for paste, | 462 | <keycombo><keycap>Shift</keycap><keycap>Insert</keycap></keycombo> |
1532 | 481 | <keycombo><keycap>Shift</keycap><keycap>Insert</keycap></keycombo>. Pasting can | 463 | combination. Pasting can also be done using the mouse by |
1533 | 482 | also be done using the mouse by <mousebutton>right-clicking</mousebutton> in | 464 | <mousebutton>right-clicking</mousebutton> in the terminal and selecting |
1534 | 483 | the terminal and selecting <guimenuitem>Paste</guimenuitem> from the menu. | 465 | <guimenuitem>Paste</guimenuitem> from the menu. |
1535 | 484 | </para> | 466 | </para> |
1536 | 485 | <para> | 467 | <para> |
1537 | 486 | Text can also be copied by selecting (highlighting) the text to be copied. | 468 | Text can also be copied by selecting (highlighting) the text to be copied. |
1538 | @@ -490,8 +472,9 @@ | |||
1539 | 490 | </para> | 472 | </para> |
1540 | 491 | <note> | 473 | <note> |
1541 | 492 | <para> | 474 | <para> |
1544 | 493 | These actions may work differently in other terminal emulators than <application>Konsole</application>. | 475 | These actions may work differently in other terminal emulators than |
1545 | 494 | Consult your terminal emulator's documentation for details. | 476 | <application>Konsole</application>. Consult your terminal emulator's |
1546 | 477 | documentation for details. | ||
1547 | 495 | </para> | 478 | </para> |
1548 | 496 | </note> | 479 | </note> |
1549 | 497 | </sect1> | 480 | </sect1> |
1550 | @@ -507,7 +490,7 @@ | |||
1551 | 507 | </term> | 490 | </term> |
1552 | 508 | <listitem> | 491 | <listitem> |
1553 | 509 | <para> | 492 | <para> |
1555 | 510 | Scrolls backwards through the commands entered previously | 493 | Scrolls backwards through the commands entered previously. |
1556 | 511 | </para> | 494 | </para> |
1557 | 512 | </listitem> | 495 | </listitem> |
1558 | 513 | </varlistentry> | 496 | </varlistentry> |
1559 | @@ -518,7 +501,7 @@ | |||
1560 | 518 | </term> | 501 | </term> |
1561 | 519 | <listitem> | 502 | <listitem> |
1562 | 520 | <para> | 503 | <para> |
1564 | 521 | Scrolls forward through previous commands | 504 | Scrolls forward through previous commands. |
1565 | 522 | </para> | 505 | </para> |
1566 | 523 | </listitem> | 506 | </listitem> |
1567 | 524 | </varlistentry> | 507 | </varlistentry> |
1568 | @@ -528,7 +511,7 @@ | |||
1569 | 528 | </term> | 511 | </term> |
1570 | 529 | <listitem> | 512 | <listitem> |
1571 | 530 | <para> | 513 | <para> |
1573 | 531 | Executes the command selected | 514 | Executes the selected command. |
1574 | 532 | </para> | 515 | </para> |
1575 | 533 | </listitem> | 516 | </listitem> |
1576 | 534 | </varlistentry> | 517 | </varlistentry> |
1577 | @@ -539,7 +522,7 @@ | |||
1578 | 539 | <listitem> | 522 | <listitem> |
1579 | 540 | <para> | 523 | <para> |
1580 | 541 | Tab is a useful feature. It autocompletes any commands or filenames if there is | 524 | Tab is a useful feature. It autocompletes any commands or filenames if there is |
1582 | 542 | one option, otherwise it displays a list of options that fit the information | 525 | one option. Otherwise it displays a list of options that fit the information |
1583 | 543 | entered. Using tab in this way reduces typing errors. | 526 | entered. Using tab in this way reduces typing errors. |
1584 | 544 | </para> | 527 | </para> |
1585 | 545 | </listitem> | 528 | </listitem> |
1586 | @@ -567,7 +550,7 @@ | |||
1587 | 567 | </term> | 550 | </term> |
1588 | 568 | <listitem> | 551 | <listitem> |
1589 | 569 | <para> | 552 | <para> |
1591 | 570 | Moves the cursor to the <emphasis>start</emphasis> of the line | 553 | Moves the cursor to the <emphasis>start</emphasis> of the line. |
1592 | 571 | </para> | 554 | </para> |
1593 | 572 | </listitem> | 555 | </listitem> |
1594 | 573 | </varlistentry> | 556 | </varlistentry> |
1595 | @@ -578,7 +561,7 @@ | |||
1596 | 578 | </term> | 561 | </term> |
1597 | 579 | <listitem> | 562 | <listitem> |
1598 | 580 | <para> | 563 | <para> |
1600 | 581 | Moves the cursor to the <emphasis>end</emphasis> of the line | 564 | Moves the cursor to the <emphasis>end</emphasis> of the line. |
1601 | 582 | </para> | 565 | </para> |
1602 | 583 | </listitem> | 566 | </listitem> |
1603 | 584 | </varlistentry> | 567 | </varlistentry> |
1604 | @@ -588,7 +571,7 @@ | |||
1605 | 588 | </term> | 571 | </term> |
1606 | 589 | <listitem> | 572 | <listitem> |
1607 | 590 | <para> | 573 | <para> |
1609 | 591 | Deletes from the current cursor position to the end of the line | 574 | Deletes from the current cursor position to the end of the line. |
1610 | 592 | </para> | 575 | </para> |
1611 | 593 | </listitem> | 576 | </listitem> |
1612 | 594 | </varlistentry> | 577 | </varlistentry> |
1613 | @@ -598,7 +581,7 @@ | |||
1614 | 598 | </term> | 581 | </term> |
1615 | 599 | <listitem> | 582 | <listitem> |
1616 | 600 | <para> | 583 | <para> |
1618 | 601 | Deletes the entire current line | 584 | Deletes the entire current line. |
1619 | 602 | </para> | 585 | </para> |
1620 | 603 | </listitem> | 586 | </listitem> |
1621 | 604 | </varlistentry> | 587 | </varlistentry> |
1622 | @@ -608,7 +591,7 @@ | |||
1623 | 608 | </term> | 591 | </term> |
1624 | 609 | <listitem> | 592 | <listitem> |
1625 | 610 | <para> | 593 | <para> |
1627 | 611 | Deletes the word before the cursor | 594 | Deletes the word before the cursor. |
1628 | 612 | </para> | 595 | </para> |
1629 | 613 | </listitem> | 596 | </listitem> |
1630 | 614 | </varlistentry> | 597 | </varlistentry> |
1631 | @@ -624,8 +607,8 @@ | |||
1632 | 624 | <itemizedlist> | 607 | <itemizedlist> |
1633 | 625 | <listitem> | 608 | <listitem> |
1634 | 626 | <para> | 609 | <para> |
1637 | 627 | <ulink url="https://help.ubuntu.com/community/AptGetHowto">AptGetHowto</ulink> - | 610 | <ulink url="https://help.ubuntu.com/community/AptGetHowto">AptGetHowto</ulink> |
1638 | 628 | using <command>apt-get</command> to install packages from the command line. | 611 | - using <command>apt-get</command> to install packages from the command line. |
1639 | 629 | </para> | 612 | </para> |
1640 | 630 | </listitem> | 613 | </listitem> |
1641 | 631 | <listitem> | 614 | <listitem> |
1642 | @@ -653,25 +636,26 @@ | |||
1643 | 653 | <para> | 636 | <para> |
1644 | 654 | <ulink url="https://help.ubuntu.com/community/CommandlineHowto">Commandline | 637 | <ulink url="https://help.ubuntu.com/community/CommandlineHowto">Commandline |
1645 | 655 | Howto</ulink> - longer and more complete than this basic guide; still not | 638 | Howto</ulink> - longer and more complete than this basic guide; still not |
1647 | 656 | finished however. | 639 | finished, however. |
1648 | 657 | </para> | 640 | </para> |
1649 | 658 | </listitem> | 641 | </listitem> |
1650 | 659 | <listitem> | 642 | <listitem> |
1651 | 660 | <para> | 643 | <para> |
1652 | 661 | <ulink url="https://help.ubuntu.com/community/HowToReadline">Howto | 644 | <ulink url="https://help.ubuntu.com/community/HowToReadline">Howto |
1655 | 662 | Readline</ulink> - information on more advanced customization for the | 645 | Readline</ulink> - information on more advanced customization for the command |
1656 | 663 | command line. | 646 | line. |
1657 | 664 | </para> | 647 | </para> |
1658 | 665 | </listitem> | 648 | </listitem> |
1659 | 666 | </itemizedlist> | 649 | </itemizedlist> |
1660 | 667 | <para> | 650 | <para> |
1662 | 668 | For more detailed tutorials on the Linux command line, please see: | 651 | For more detailed tutorials on the <trademark>Linux</trademark> command line, |
1663 | 652 | please see: | ||
1664 | 669 | </para> | 653 | </para> |
1665 | 670 | <itemizedlist> | 654 | <itemizedlist> |
1666 | 671 | <listitem> | 655 | <listitem> |
1667 | 672 | <para> | 656 | <para> |
1670 | 673 | <ulink url="http://ss64.com/bash/"/> - an A-Z index of the Bash command line for | 657 | <ulink url="http://ss64.com/bash/"/> - an A-Z index of the |
1671 | 674 | Linux. | 658 | <trademark>Bash</trademark> command line for <trademark>Linux</trademark>. |
1672 | 675 | </para> | 659 | </para> |
1673 | 676 | </listitem> | 660 | </listitem> |
1674 | 677 | <listitem> | 661 | <listitem> |
1675 | @@ -682,19 +666,20 @@ | |||
1676 | 682 | </listitem> | 666 | </listitem> |
1677 | 683 | <listitem> | 667 | <listitem> |
1678 | 684 | <para> | 668 | <para> |
1680 | 685 | <ulink url="http://linuxsurvival.com/index.php" /> - Java-based tutorials. | 669 | <ulink url="http://linuxsurvival.com/index.php" /> - |
1681 | 670 | <trademark>Java</trademark>-based tutorials. | ||
1682 | 686 | </para> | 671 | </para> |
1683 | 687 | </listitem> | 672 | </listitem> |
1684 | 688 | <listitem> | 673 | <listitem> |
1685 | 689 | <para> | 674 | <para> |
1686 | 690 | <ulink url="http://rute.2038bug.com/index.html.gz"/> - a massive online book | 675 | <ulink url="http://rute.2038bug.com/index.html.gz"/> - a massive online book |
1688 | 691 | about system administration, almost all from the command line. | 676 | about system administration — almost all from the command line. |
1689 | 692 | </para> | 677 | </para> |
1690 | 693 | </listitem> | 678 | </listitem> |
1691 | 694 | <listitem> | 679 | <listitem> |
1692 | 695 | <para> | 680 | <para> |
1695 | 696 | <ulink url="http://www.commandlinefu.com/"/> - a place to record command-line | 681 | <ulink url="http://www.commandlinefu.com/"/> - a place to record command line |
1696 | 697 | favorites and view other's gems as well. | 682 | favorites and view others' gems as well. |
1697 | 698 | </para> | 683 | </para> |
1698 | 699 | </listitem> | 684 | </listitem> |
1699 | 700 | </itemizedlist> | 685 | </itemizedlist> |
1700 | 701 | 686 | ||
1701 | === modified file 'docs/security/C/security.xml' | |||
1702 | --- docs/security/C/security.xml 2010-03-26 21:38:03 +0000 | |||
1703 | +++ docs/security/C/security.xml 2012-03-22 07:41:34 +0000 | |||
1704 | @@ -70,24 +70,25 @@ | |||
1705 | 70 | Keyboard shortcuts can be changed in <application>System Settings</application> | 70 | Keyboard shortcuts can be changed in <application>System Settings</application> |
1706 | 71 | under the <guilabel>Keyboard & Mouse</guilabel>. To access these settings, | 71 | under the <guilabel>Keyboard & Mouse</guilabel>. To access these settings, |
1707 | 72 | go to Menu Bread Crumbs. Select <guilabel>Global Keyboard Shortcuts</guilabel>, | 72 | go to Menu Bread Crumbs. Select <guilabel>Global Keyboard Shortcuts</guilabel>, |
1710 | 73 | in the KDE component dropdown, select <guilabel>Run Command Interface</guilabel> | 73 | in the <trademark>KDE</trademark> component drop-down, select <guilabel>Run |
1711 | 74 | and locate <guilabel>Lock Session</guilabel>. | 74 | Command Interface</guilabel>, and locate <guilabel>Lock Session</guilabel>. |
1712 | 75 | </para> | 75 | </para> |
1713 | 76 | </note> | 76 | </note> |
1714 | 77 | 77 | ||
1715 | 78 | <note><title>Adding a lock screen button to the panel</title> | 78 | <note><title>Adding a lock screen button to the panel</title> |
1716 | 79 | <para> | 79 | <para> |
1717 | 80 | A <guibutton>Lock Screen</guibutton> button can be added to the | 80 | A <guibutton>Lock Screen</guibutton> button can be added to the |
1722 | 81 | <application>Panel</application> for quick and easy screen locking. Right-click | 81 | <application>Panel</application> for quick and easy screen locking. |
1723 | 82 | the <application>Panel</application>, select <guibutton>Add | 82 | <mousebutton>Right-click</mousebutton> the <application>Panel</application>, |
1724 | 83 | Widgets...</guibutton>, select <guibutton>Lock/Logout</guibutton> and drag it | 83 | select <guibutton>Add Widgets...</guibutton>, select |
1725 | 84 | to the proper location on the Panel. | 84 | <guibutton>Lock/Logout</guibutton>, and drag it to the proper location on the |
1726 | 85 | <application>Panel</application>. | ||
1727 | 85 | </para> | 86 | </para> |
1728 | 86 | </note> | 87 | </note> |
1729 | 87 | 88 | ||
1730 | 88 | <para> | 89 | <para> |
1731 | 89 | To unlock the screen, move the mouse or press a key. Enter the password, and | 90 | To unlock the screen, move the mouse or press a key. Enter the password, and |
1733 | 90 | either press the <keycap>Return</keycap> key or press the | 91 | either press the <keycap>Return</keycap> key or press the |
1734 | 91 | <guibutton>Unlock</guibutton> button. | 92 | <guibutton>Unlock</guibutton> button. |
1735 | 92 | </para> | 93 | </para> |
1736 | 93 | <para> | 94 | <para> |
1737 | @@ -105,17 +106,17 @@ | |||
1738 | 105 | 106 | ||
1739 | 106 | <para> | 107 | <para> |
1740 | 107 | <application>Guarddog</application> is the firewall of choice for &kubuntu;. | 108 | <application>Guarddog</application> is the firewall of choice for &kubuntu;. |
1744 | 108 | Please review the <ulink type="help" | 109 | Please review the <ulink type="help" |
1745 | 109 | url="help:/kubuntu/network/">Networking</ulink> | 110 | url="help:/kubuntu/network/">Networking</ulink> documentation and locate the |
1746 | 110 | documentation and locate the <application>Guarddog</application> section. | 111 | <application>Guarddog</application> section. |
1747 | 111 | </para> | 112 | </para> |
1748 | 112 | </sect1> | 113 | </sect1> |
1749 | 113 | 114 | ||
1750 | 114 | <sect1 id="keep-safe-avoid-internet-crime" status="complete"> | 115 | <sect1 id="keep-safe-avoid-internet-crime" status="complete"> |
1751 | 115 | <title>Avoid Internet nuisances and crime</title> | 116 | <title>Avoid Internet nuisances and crime</title> |
1752 | 116 | 117 | ||
1755 | 117 | <para>From time to time, email messages carry viruses or links to fraudulent | 118 | <para>From time to time email messages carry viruses or links to fraudulent |
1756 | 118 | websites. It is important to learn how to deal with these messages, in order to | 119 | web sites. It is important to learn how to deal with these messages in order to |
1757 | 119 | prevent the computer or personal information from being compromised or misused. | 120 | prevent the computer or personal information from being compromised or misused. |
1758 | 120 | </para> | 121 | </para> |
1759 | 121 | 122 | ||
1760 | @@ -131,20 +132,20 @@ | |||
1761 | 131 | <itemizedlist> | 132 | <itemizedlist> |
1762 | 132 | <listitem> | 133 | <listitem> |
1763 | 133 | <para> | 134 | <para> |
1778 | 134 | Spam (junk) email with offers for unwanted services and products | 135 | Spam (junk) email with offers for unwanted services and products. |
1779 | 135 | </para> | 136 | </para> |
1780 | 136 | </listitem> | 137 | </listitem> |
1781 | 137 | 138 | ||
1782 | 138 | <listitem> | 139 | <listitem> |
1783 | 139 | <para> | 140 | <para> |
1784 | 140 | Scam emails asking for help in exchange for money | 141 | Scam emails asking for help in exchange for money. |
1785 | 141 | </para> | 142 | </para> |
1786 | 142 | </listitem> | 143 | </listitem> |
1787 | 143 | 144 | ||
1788 | 144 | <listitem> | 145 | <listitem> |
1789 | 145 | <para> | 146 | <para> |
1790 | 146 | Phishing email that appears to be from a bank or other online service, asking | 147 | Phishing email, that appears to be from a bank or other online service, asking |
1791 | 147 | for personal and financial details, or passwords | 148 | for personal and financial details or passwords. |
1792 | 148 | </para> | 149 | </para> |
1793 | 149 | </listitem> | 150 | </listitem> |
1794 | 150 | </itemizedlist> | 151 | </itemizedlist> |
1795 | @@ -159,7 +160,7 @@ | |||
1796 | 159 | 160 | ||
1797 | 160 | <listitem> | 161 | <listitem> |
1798 | 161 | <para> | 162 | <para> |
1800 | 162 | Never click on links in emails that lead to websites asking for passwords or | 163 | Never click on links in emails that lead to web sites asking for passwords or |
1801 | 163 | similar information. It is possible for the text of the link to show one | 164 | similar information. It is possible for the text of the link to show one |
1802 | 164 | address, but clicking on the link actually connects to a different (possibly | 165 | address, but clicking on the link actually connects to a different (possibly |
1803 | 165 | dangerous) address. Instead of clicking a potentially misleading link, type the | 166 | dangerous) address. Instead of clicking a potentially misleading link, type the |
1804 | @@ -169,22 +170,22 @@ | |||
1805 | 169 | 170 | ||
1806 | 170 | <listitem> | 171 | <listitem> |
1807 | 171 | <para> | 172 | <para> |
1810 | 172 | When visiting a website that asks for financial information, ensure that it is | 173 | When visiting a web site that asks for financial information, ensure that it is |
1811 | 173 | secure. <application>Konqueror</application> and | 174 | secure. <application>Konqueror</application> and |
1812 | 174 | <application>Firefox</application> are two browsers commonly used in &kubuntu;. | 175 | <application>Firefox</application> are two browsers commonly used in &kubuntu;. |
1819 | 175 | Both have two areas that indicate if the current page is secure. On secure | 176 | Both have two areas that indicate if the current page is secure. On secure web |
1820 | 176 | webpages, the address bar will have a yellow background and a lock | 177 | pages, the address bar will have a yellow background and a lock symbol to the |
1821 | 177 | symbol to the right of the address. The second area is the status bar located at | 178 | right of the address. The second area is the status bar located at the bottom |
1822 | 178 | the bottom right of the browser window. If the page is secure, a lock icon will | 179 | right of the browser window. If the page is secure, a lock icon will appear in |
1823 | 179 | appear in this area. Clicking on either of the lock symbols will produce a | 180 | this area. Clicking on either of the lock symbols will produce a dialog that |
1824 | 180 | dialog that explains the type of licensing and security for that page. | 181 | explains the type of licensing and security for the page. |
1825 | 181 | </para> | 182 | </para> |
1826 | 182 | </listitem> | 183 | </listitem> |
1827 | 183 | 184 | ||
1828 | 184 | <listitem> | 185 | <listitem> |
1829 | 185 | <para> | 186 | <para> |
1830 | 186 | Only download and run software from trusted sources. By default, software can | 187 | Only download and run software from trusted sources. By default, software can |
1832 | 187 | only be downloaded directly from Ubuntu. | 188 | only be downloaded directly from &ubuntu;. |
1833 | 188 | </para> | 189 | </para> |
1834 | 189 | </listitem> | 190 | </listitem> |
1835 | 190 | </itemizedlist> | 191 | </itemizedlist> |
1836 | @@ -196,8 +197,8 @@ | |||
1837 | 196 | <para> | 197 | <para> |
1838 | 197 | Occasionally users lose computer information. There are many possible causes | 198 | Occasionally users lose computer information. There are many possible causes |
1839 | 198 | for such unforeseen <emphasis>data loss</emphasis>. The problem could be | 199 | for such unforeseen <emphasis>data loss</emphasis>. The problem could be |
1842 | 199 | anything from a power loss or equipment failure to accidentally deleting a file. | 200 | anything from a power loss or equipment failure to accidentally deleting a |
1843 | 200 | With regular backup copies, if a problem should occur, it may be possible | 201 | file. With regular backup copies, if a problem should occur, it may be possible |
1844 | 201 | to retrieve important files. Users are strongly encouraged to make backups. | 202 | to retrieve important files. Users are strongly encouraged to make backups. |
1845 | 202 | </para> | 203 | </para> |
1846 | 203 | <para> | 204 | <para> |
1847 | @@ -206,9 +207,11 @@ | |||
1848 | 206 | attached to the computer. Options include: | 207 | attached to the computer. Options include: |
1849 | 207 | </para> | 208 | </para> |
1850 | 208 | <itemizedlist> | 209 | <itemizedlist> |
1854 | 209 | <listitem><para>Writable CDs and DVDs</para></listitem> | 210 | <listitem><para>Writable <acronym>CD</acronym>s and <acronym>DVD</acronym>s. |
1855 | 210 | <listitem><para>External hard disks and flash memory devices</para></listitem> | 211 | </para></listitem> |
1856 | 211 | <listitem><para>Another computer on the network</para></listitem> | 212 | <listitem><para>External hard disks.</para></listitem> |
1857 | 213 | <listitem><para>Flash memory devices.</para></listitem> | ||
1858 | 214 | <listitem><para>Another computer on the network.</para></listitem> | ||
1859 | 212 | </itemizedlist> | 215 | </itemizedlist> |
1860 | 213 | <para> | 216 | <para> |
1861 | 214 | A simple way of backing up your files is to copy them manually to a safe | 217 | A simple way of backing up your files is to copy them manually to a safe |
1862 | @@ -217,7 +220,7 @@ | |||
1863 | 217 | </para> | 220 | </para> |
1864 | 218 | <para> | 221 | <para> |
1865 | 219 | Another backup method is <application>Keep</application>, an automated &kubuntu; | 222 | Another backup method is <application>Keep</application>, an automated &kubuntu; |
1867 | 220 | backup solution, preferred by many &kubuntu; veterans. To install the | 223 | backup solution preferred by many &kubuntu; veterans. To install the |
1868 | 221 | <application>Keep</application> package, please refer to the <ulink | 224 | <application>Keep</application> package, please refer to the <ulink |
1869 | 222 | type="help" url="help:/kubuntu/manage-software/">Adding Applications</ulink> | 225 | type="help" url="help:/kubuntu/manage-software/">Adding Applications</ulink> |
1870 | 223 | document for help on installing applications. Once installed, | 226 | document for help on installing applications. Once installed, |
1871 | 224 | 227 | ||
1872 | === modified file 'docs/video/C/video.xml' | |||
1873 | --- docs/video/C/video.xml 2011-09-15 06:32:00 +0000 | |||
1874 | +++ docs/video/C/video.xml 2012-03-22 07:41:34 +0000 | |||
1875 | @@ -21,14 +21,15 @@ | |||
1876 | 21 | <sect1 id="introduction"> | 21 | <sect1 id="introduction"> |
1877 | 22 | <title>Introduction</title> | 22 | <title>Introduction</title> |
1878 | 23 | <para> | 23 | <para> |
1881 | 24 | &kubuntu; comes with a video player installed by default called | 24 | &kubuntu; comes with a video player installed by default called |
1882 | 25 | <application>Dragon Player</application>. It is a simple and lightweight video | 25 | <application>Dragon Player</application>. It is a simple and light-weight video |
1883 | 26 | player that can play almost any video file (provided the necessary codecs are | 26 | player that can play almost any video file (provided the necessary codecs are |
1889 | 27 | installed). For video editing, the preferred choice is | 27 | installed). For video editing, the preferred choice is |
1890 | 28 | <application>Kino</application>, a non-linear video editor. | 28 | <application>Kino</application> — a non-linear video editor. |
1891 | 29 | <application>Kino</application> is not installed by default with &kubuntu;, but | 29 | <application>Kino</application> is not installed by default in &kubuntu;, but |
1892 | 30 | it can be easily installed from the &kubuntu; Software Center: | 30 | can be easily installed from the &kubuntu; Software Center: |
1893 | 31 | (<application>Muon</application>). | 31 | (<application>Muon</application>), which can be started by choosing |
1894 | 32 | &menusysmuon;. | ||
1895 | 32 | </para> | 33 | </para> |
1896 | 33 | </sect1> | 34 | </sect1> |
1897 | 34 | 35 | ||
1898 | @@ -41,16 +42,20 @@ | |||
1899 | 41 | 42 | ||
1900 | 42 | <procedure> | 43 | <procedure> |
1901 | 43 | <title>Open Files From The File Manager</title> | 44 | <title>Open Files From The File Manager</title> |
1903 | 44 | <step><para>Open the <application>Dolphin</application> file manager.</para></step> | 45 | <step><para>Open the <application>Dolphin</application> file manager. |
1904 | 46 | </para></step> | ||
1905 | 45 | <step><para>Navigate to the video file.</para></step> | 47 | <step><para>Navigate to the video file.</para></step> |
1907 | 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 |
1908 | 49 | (<application>Dragon Player</application>).</para></step> | ||
1909 | 47 | </procedure> | 50 | </procedure> |
1910 | 48 | 51 | ||
1911 | 49 | <procedure> | 52 | <procedure> |
1912 | 50 | <title>Open Files From Within Dragon Player</title> | 53 | <title>Open Files From Within Dragon Player</title> |
1916 | 51 | <step><para>Open <application>Dragon Player</application>; &menudragon;</para></step> | 54 | <step><para>Open <application>Dragon Player</application>; &menudragon;</para> |
1917 | 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> |
1918 | 53 | <step><para>Navigate to the selected video file, and click | 56 | <step><para>Click on the <guibutton>Play File</guibutton> button or press |
1919 | 57 | <keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></para></step> | ||
1920 | 58 | <step><para>Navigate to the selected video file, and click | ||
1921 | 54 | <guibutton>Open</guibutton></para></step> | 59 | <guibutton>Open</guibutton></para></step> |
1922 | 55 | </procedure> | 60 | </procedure> |
1923 | 56 | 61 | ||
1924 | @@ -61,11 +66,11 @@ | |||
1925 | 61 | <title>Editing Videos</title> | 66 | <title>Editing Videos</title> |
1926 | 62 | <para> | 67 | <para> |
1927 | 63 | Video editing in &kubuntu; can be done with an application called | 68 | Video editing in &kubuntu; can be done with an application called |
1929 | 64 | <application>Kino</application> a non-linear video editor. | 69 | <application>Kino</application> — a non-linear video editor. |
1930 | 65 | <application>Kino</application> is not installed by default. It can be | 70 | <application>Kino</application> is not installed by default. It can be |
1934 | 66 | installed using <application>Muon</application> by going | 71 | installed using <application>Muon</application> by going to &menusysmuon;. |
1935 | 67 | to &menusysmuon;.</para> | 72 | </para> |
1936 | 68 | <para>Here's how to open and edit video files in | 73 | <para>Here's how to open and edit video files in |
1937 | 69 | <application>Kino</application>: | 74 | <application>Kino</application>: |
1938 | 70 | </para> | 75 | </para> |
1939 | 71 | 76 | ||
1940 | @@ -84,11 +89,12 @@ | |||
1941 | 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> |
1942 | 85 | <procedure> | 90 | <procedure> |
1943 | 86 | <title>Trimming Videos</title> | 91 | <title>Trimming Videos</title> |
1945 | 87 | <step><para>Once a video file has been imported into | 92 | <step><para>Once a video file has been imported into |
1946 | 88 | <application>Kino</application>, click on the <guibutton>Trim</guibutton> | 93 | <application>Kino</application>, click on the <guibutton>Trim</guibutton> |
1947 | 89 | button.</para></step> | 94 | button.</para></step> |
1950 | 90 | <step><para>A slider below the video preview can be used to specify the starting | 95 | <step><para>A slider below the video preview can be used to specify the |
1951 | 91 | (In Point) and the ending (Out Point) points of the trimmed video.</para></step> | 96 | starting (In Point) and the ending (Out Point) points of the trimmed video. |
1952 | 97 | </para></step> | ||
1953 | 92 | <step><para>Specify the starting and ending points by dragging each end of the | 98 | <step><para>Specify the starting and ending points by dragging each end of the |
1954 | 93 | slider.</para></step> | 99 | slider.</para></step> |
1955 | 94 | <step><para>After the sliders have been positioned, press the | 100 | <step><para>After the sliders have been positioned, press the |
1956 | @@ -98,21 +104,20 @@ | |||
1957 | 98 | 104 | ||
1958 | 99 | <procedure> | 105 | <procedure> |
1959 | 100 | <title>Exporting videos</title> | 106 | <title>Exporting videos</title> |
1965 | 101 | <step><para>When the editing, trimming, etc. are complete, the video is ready | 107 | <step><para>When the editing, trimming, etc., are complete, the video is ready |
1966 | 102 | to be exported. To do this, click on the <guibutton>Export</guibutton> on the | 108 | to be exported. To do this, click on the <guibutton>Export</guibutton> button |
1967 | 103 | right side of the window or go to | 109 | on the right side of the window or go to <menuchoice><guimenu>View</guimenu> |
1968 | 104 | <menuchoice><guimenu>View</guimenu><guisubmenu>Export</guisubmenu></menuchoice | 110 | <guisubmenu>Export</guisubmenu></menuchoice>.</para></step> |
1964 | 105 | >.</para></step> | ||
1969 | 106 | <step><para>In the Export mode, the output mode can be specified for saving the | 111 | <step><para>In the Export mode, the output mode can be specified for saving the |
1972 | 107 | edited video. Exporting to a 'DV' file maintains the quality of the video (this | 112 | edited video. Exporting to a '<acronym>DV</acronym>' file maintains the quality |
1973 | 108 | generally results in a large file).</para></step> | 113 | of the video (this generally results in a large file).</para></step> |
1974 | 109 | <step><para>To export the video to a common format such as | 114 | <step><para>To export the video to a common format such as |
1975 | 110 | <acronym>AVI</acronym>, select the 'Other' tab and specify the type of video to | 115 | <acronym>AVI</acronym>, select the 'Other' tab and specify the type of video to |
1978 | 111 | export, the quality of the output video and the location where the | 116 | export, the quality of the output video and the location the video should be |
1979 | 112 | video should be saved.</para></step> | 117 | saved to.</para></step> |
1980 | 113 | <step><para>When the settings have been customized, click on the | 118 | <step><para>When the settings have been customized, click on the |
1983 | 114 | <guibutton>Export</guibutton> button to export the file. This may take some time | 119 | <guibutton>Export</guibutton> button to export the file. This may take some |
1984 | 115 | depending on the size of file, the format, the quality selected and other | 120 | time depending on the size of file, the format, the quality selected, and other |
1985 | 116 | customization choices.</para></step> | 121 | customization choices.</para></step> |
1986 | 117 | </procedure> | 122 | </procedure> |
1987 | 118 | </sect1> | 123 | </sect1> |
1988 | @@ -120,14 +125,15 @@ | |||
1989 | 120 | <sect1 id="video-codecs"> | 125 | <sect1 id="video-codecs"> |
1990 | 121 | <title>Video Codecs</title> | 126 | <title>Video Codecs</title> |
1991 | 122 | <para> | 127 | <para> |
1995 | 123 | Codecs are software that allow different types of video/audio files to be | 128 | Codecs are software that allow different types of video/audio files to be |
1996 | 124 | played. Some codecs are proprietary, meaning that a license is required to use | 129 | played. Some codecs are proprietary — meaning that a license is required |
1997 | 125 | them. Some codecs are available under free licenses like GPL. | 130 | to use them. Some codecs are available under free licenses like the |
1998 | 131 | <acronym>GPL</acronym>. | ||
1999 | 126 | </para> | 132 | </para> |
2000 | 127 | <para> | 133 | <para> |
2001 | 128 | &kubuntu; does not come pre-installed with codecs to play proprietary formats | 134 | &kubuntu; does not come pre-installed with codecs to play proprietary formats |
2004 | 129 | like mp3, rm (Real Media) and others. The necessary codecs can be installed from | 135 | like mp3, rm (<trademark>Real Media</trademark>), and others. The necessary |
2005 | 130 | the repositories. | 136 | codecs can be installed from the repositories. |
2006 | 131 | </para> | 137 | </para> |
2007 | 132 | <para> | 138 | <para> |
2008 | 133 | For more information on which formats are supported out of the box by &kubuntu; | 139 | For more information on which formats are supported out of the box by &kubuntu; |