← Back to branch summary

~ubuntu-branches/ubuntu/vivid/plasma-desktop/vivid-proposed

« back to all changes in this revision

Viewing changes to doc/en_US/kcontrol/solid-actions/index.docbook

  • Committer: Package Import Robot
  • Author(s): Scarlett Clark
  • Date: 2015-02-23 09:46:57 UTC
  • mfrom: (1.1.5)
  • Revision ID: package-import@ubuntu.com-20150223094657-6yyp5z2pjpla63rh
Tags: 4:5.2.1-0ubuntu1
New upstream release

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en_US/kcontrol/solid-actions/index.docbook
1
 
<?xml version="1.0" ?>
2
 
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
3
 
"dtd/kdedbx45.dtd" [
4
 
  <!ENTITY % addindex "IGNORE">
5
 
  <!ENTITY % English "INCLUDE">
6
 
]>
7
 
<article id="solid-actions" lang="&language;">
8
 
<articleinfo>
9
 
<title>Device Actions</title>
10
 
<authorgroup>
11
 
<author><firstname>Ben</firstname><surname>Cooksley</surname></author>
12
 
<author>&Anne-Marie.Mahfouf;</author>
13
 
<!-- TRANS:ROLES_OF_TRANSLATORS -->
14
 
</authorgroup>
15
 
 
16
 
<date>2013-12-05</date>
17
 
<releaseinfo>&kde; 4.12</releaseinfo>
18
 
 
19
 
<keywordset>
20
 
<keyword>KDE</keyword>
21
 
<keyword>System Settings</keyword>
22
 
<keyword>Solid</keyword>
23
 
<keyword>actions</keyword>
24
 
<keyword>devices</keyword>
25
 
<keyword>hardware</keyword>
26
 
</keywordset>
27
 
</articleinfo>
28
 
 
29
 
<sect1 id="kcm_solid_actions">
30
 
<title>Actions for new devices</title>
31
 
<sect2 id="icons-intro">
32
 
<title>Introduction</title>
33
 
 
34
 
<para>This module allows you to set up the actions you want to associate when
35
 
you plug new devices.</para>
36
 
<para>
37
 
<screenshot>
38
 
<screeninfo>Screenshot of the Device Actions Manager</screeninfo>
39
 
  <mediaobject>
40
 
    <imageobject>
41
 
      <imagedata fileref="main.png" format="PNG"/>
42
 
    </imageobject>
43
 
     <textobject>
44
 
      <phrase>Screenshot of the Device Actions Manager</phrase>
45
 
    </textobject>
46
 
  </mediaobject>
47
 
</screenshot>
48
 
</para>
49
 
 
50
 
<para>You will see listed all of the possible actions that are available when
51
 
devices are plugged in.
52
 
Please note that they will only be available under certain conditions.</para>
53
 
 
54
 
<itemizedlist>
55
 
<listitem><para><guibutton>Add</guibutton>
56
 
   This will ask you to supply a name for your new action, then will open that
57
 
action for editing.
58
 
   If you do not supply all the required details in that dialog, then your
59
 
action will be deleted.
60
 
</para></listitem>
61
 
<listitem><para>
62
 
<guibutton>Edit</guibutton>
63
 
   This will allow you to change the Name, Icon, command to execute 
64
 
   and the conditions the action must match to be shown. 
65
 
</para></listitem>
66
 
<listitem><para>
67
 
<guibutton>Discard / Cannot be deleted / Remove</guibutton>
68
 
   This will do different actions, depending on if it was supplied with your
69
 
system or created by you.
70
 
   You can only discard changes to system wide actions, if there are no changes
71
 
then these actions cannot be deleted.
72
 
   User created actions are completely removed, including all changes.
73
 
</para></listitem>
74
 
</itemizedlist>
75
 
 
76
 
</sect2>
77
 
 
78
 
<sect2 id="add-action">
79
 
<title>Add Action</title>
80
 
 
81
 
<para>
82
 
The <guibutton>Add</guibutton> button brings you a dialog to enter the
83
 
new action name.
84
 
</para>
85
 
<para>
86
 
<screenshot>
87
 
<screeninfo>Screenshot of the Add Action dialog</screeninfo>
88
 
  <mediaobject>
89
 
    <imageobject>
90
 
      <imagedata fileref="add-action.png" format="PNG"/>
91
 
    </imageobject>
92
 
     <textobject>
93
 
      <phrase>Screenshot of the Add Action dialog</phrase>
94
 
    </textobject>
95
 
  </mediaobject>
96
 
</screenshot>
97
 
</para>
98
 
<para>
99
 
The action name should correctly describe the action. After entering a name and
100
 
clicking <guibutton>OK</guibutton>, the Edit Action dialog will show to allow
101
 
you to set up the action properties.
102
 
</para>
103
 
</sect2>
104
 
 
105
 
<sect2 id="edit-action">
106
 
<title>Edit Action</title>
107
 
 
108
 
<para>This dialog allows you to change the settings of the action you
109
 
selected.</para>
110
 
<para>
111
 
<screenshot>
112
 
<screeninfo>Screenshot of the Edit Action dialog</screeninfo>
113
 
  <mediaobject>
114
 
    <imageobject>
115
 
      <imagedata fileref="edit-action.png" format="PNG"/>
116
 
    </imageobject>
117
 
     <textobject>
118
 
      <phrase>Screenshot of the Edit Action dialog</phrase>
119
 
    </textobject>
120
 
  </mediaobject>
121
 
</screenshot>
122
 
</para>
123
 
<para>
124
 
This includes the icon, the action name, the action command and the various
125
 
parameters.
126
 
You can change the icon by clicking on it.</para>
127
 
<para>The parameters are displayed in a
128
 
tree, the top item having to be true in order for the action to be shown.</para>
129
 
 
130
 
<sect3 id="edit-parameter">
131
 
<title>Edit parameter</title>
132
 
 
133
 
<variablelist>
134
 
<varlistentry><term><guilabel>Parameter type</guilabel></term>
135
 
<listitem>
136
 
<para>This controls what can be contained inside it, or
137
 
what matching is performed to check if it is true.
138
 
 
139
 
<variablelist>
140
 
<varlistentry><term><guilabel>Property Match</guilabel></term>
141
 
<listitem>
142
 
<para>Compares the specified property of the Device (using 
143
 
<guilabel>Device type</guilabel> and <guilabel>Value name</guilabel>) and using the evaluator, compares it against the
144
 
text provided.</para>
145
 
</listitem>
146
 
</varlistentry>
147
 
 
148
 
<varlistentry><term><guilabel>Content Conjunction</guilabel></term>
149
 
<listitem>
150
 
<para>All sub-properties of this must be true for
151
 
it to be true itself.</para>
152
 
</listitem>
153
 
</varlistentry>
154
 
 
155
 
<varlistentry><term><guilabel>Content Disjunction</guilabel></term>
156
 
<listitem>
157
 
<para>Any sub-property of this may be true for it
158
 
to be true itself.</para>
159
 
</listitem>
160
 
</varlistentry>
161
 
 
162
 
<varlistentry><term><guilabel>Device interface match</guilabel></term>
163
 
<listitem>
164
 
<para>Checks to see if the Device can be
165
 
classed as the selected Device type.</para>
166
 
</listitem>
167
 
</varlistentry>
168
 
 
169
 
</variablelist>
170
 
</para>
171
 
</listitem>
172
 
</varlistentry>
173
 
 
174
 
<varlistentry><term><guilabel>Device type</guilabel></term>
175
 
<listitem>
176
 
<para>These are the possible device types supported by &kde; on
177
 
your system.
178
 
They are used in both Property and Device interface matches.
179
 
</para>
180
 
</listitem>
181
 
</varlistentry>
182
 
 
183
 
<varlistentry><term><guilabel>Value name</guilabel></term>
184
 
<listitem>
185
 
<para>This is a list of all possible property names for the
186
 
selected device type.
187
 
It also provides the selection of the value evaluator (which is either 
188
 
<guilabel>Equals</guilabel> or <guilabel>Contains</guilabel>), and allows
189
 
entry of the text to be compared with.</para>
190
 
</listitem>
191
 
</varlistentry>
192
 
 
193
 
<varlistentry><term><guibutton>Reset Parameter</guibutton></term>
194
 
<listitem>
195
 
<para>Reverts any unsaved changes you have made to this parameter.</para>
196
 
</listitem>
197
 
</varlistentry>
198
 
 
199
 
<varlistentry><term><guibutton>Save Parameter changes</guibutton></term>
200
 
<listitem>
201
 
<para>Saves the changes you have made to the parameter.</para>
202
 
</listitem>
203
 
</varlistentry>
204
 
 
205
 
</variablelist>
206
 
</sect3>
207
 
</sect2>
208
 
</sect1>
209
 
</article>
210
 
 
211
 
<!--
212
 
Local Variables:
213
 
mode: xml
214
 
sgml-minimize-attributes:nil
215
 
sgml-general-insert-case:lower
216
 
sgml-indent-step:0
217
 
sgml-indent-data:nil
218
 
End:
219
 
 
220
 
vim:tabstop=2:shiftwidth=2:expandtab
221
 
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
222
 
-->