~ubuntu-branches/debian/sid/xfce4-clipman-plugin/sid

« back to all changes in this revision

Viewing changes to docs/manual/gl/xfce4-clipman-plugin.xml.in

  • Committer: Bazaar Package Importer
  • Author(s): Yves-Alexis Perez, Evgeni Golov, Yves-Alexis Perez
  • Date: 2009-06-29 07:50:15 UTC
  • mfrom: (1.3.1 upstream) (7.1.1 sid)
  • Revision ID: james.westby@ubuntu.com-20090629075015-l9z65w1bezcg272x
Tags: 2:1.0.2-1
[ Evgeni Golov ]
* Fix Vcs-* fields, they were missing 'trunk' in the path.

[ Yves-Alexis Perez ]
* New upstream release.
* debian/control:
  - bump standards version to 3.8.2.

Show diffs side-by-side

added added

removed removed

Lines of Context:
21
21
    <copyright>
22
22
      <year>2009</year>
23
23
      <holder>&doc-author;</holder>
24
 
    </copyright><copyright><year>2009.</year><holder>Leandro Regueiro (leandro.regueiro@gmail.com)</holder></copyright><copyright><year>podes atopar máis información en http://trasno.net</year><holder>Se desexas colaborar connosco</holder></copyright>
 
24
    </copyright><copyright><year>2009.</year><holder>Leandro Regueiro (leandro.regueiro@gmail.com)</holder></copyright>
25
25
 
26
26
    <legalnotice id="legalnotice">
27
27
      <para>
57
57
      specific text selections by matching them against regular expressions.
58
58
    </para>
59
59
 
60
 
    <para>
61
 
      There are two ways to run @PACKAGE_NAME@. You can select @PACKAGE_NAME@ in the applications menu under the category
62
 
      Utility or type <command>xfce4-clipman-plugin</command> on the command line, or you can add it into your panel. To
63
 
      add a new item in the panel right click the panel and select “Add new item…”.
64
 
    </para>
65
 
 
66
60
    <sect2 id="anatomy-clipboard">
67
61
      <title>Anatomy of a Clipboard</title>
68
62
 
78
72
        handling the selections, the default clipboard will always be synced with it and contain the same data.
79
73
      </para>
80
74
    </sect2>
81
 
  </sect1>
82
 
 
83
 
 
84
 
  <sect1 id="usage">
85
 
    <title>Usage</title>
86
 
 
87
 
    <para>
88
 
      @PACKAGE_NAME@ is used to keep in history a list of clipboard contents and to restore them. The history is
89
 
      displayed in a menu by clicking on the main icon. Within the menu it is possible to select an item to restore it,
90
 
      to clear the history and to activate or deactivate the clipboard manager.
91
 
    </para>
92
 
 
93
 
    <screenshot>
94
 
      <mediaobject>
95
 
        <imageobject>
96
 
          <imagedata fileref="images/clipman-menu.png" format="PNG"/>
97
 
        </imageobject>
98
 
        <textobject>
99
 
          <phrase>Menu displaying the history</phrase>
100
 
        </textobject>
101
 
      </mediaobject>
102
 
    </screenshot>
 
75
 
 
76
    <sect2 id="getting-started">
 
77
      <title>Getting Started</title>
 
78
 
 
79
      <para>
 
80
        @PACKAGE_NAME@ is used to keep in history a list of clipboard contents and to restore them. The history is
 
81
        displayed in a menu by clicking on the main icon. Within the menu it is possible to select an item to restore it,
 
82
        to clear the history and to activate or deactivate the clipboard manager.
 
83
      </para>
 
84
 
 
85
      <figure>
 
86
        <title>Menú de Clipman</title>
 
87
        <mediaobject>
 
88
          <imageobject>
 
89
            <imagedata fileref="images/clipman-menu.png" format="PNG"/>
 
90
          </imageobject>
 
91
          <textobject>
 
92
            <phrase>Menu displaying the history</phrase>
 
93
          </textobject>
 
94
        </mediaobject>
 
95
      </figure>
 
96
 
 
97
      <para>
 
98
        There are two ways to run @PACKAGE_NAME@. You can select @PACKAGE_NAME@ in the applications menu under the category
 
99
        Utility or type <application>xfce4-clipman-plugin</application> on the command-line, or you can add it into your
 
100
        panel. To add a new item in the panel right click the panel and select “Add new item…”.
 
101
      </para>
 
102
    </sect2>
 
103
 
 
104
    <sect2 id="popup-command">
 
105
      <title>Popup Command</title>
 
106
 
 
107
      <para>
 
108
        @PACKAGE_NAME@ provides the command-line tool <application>xfce4-popup-clipman</application>. When called it
 
109
        popups the main menu. The command is practical for the <emphasis role="bold">Application Shortcuts</emphasis>
 
110
        available at 
 
111
        <menuchoice>
 
112
          <guimenu>Xfce Menu</guimenu>
 
113
          <guimenu>Settings</guimenu>
 
114
          <guimenu>Keyboard</guimenu>
 
115
        </menuchoice>.
 
116
      </para>
 
117
    </sect2>
103
118
 
104
119
  </sect1>
105
120
 
106
121
 
107
122
  <sect1 id="settings">
108
 
    <title>Settings</title>
 
123
    <title>Configuración</title>
109
124
 
110
125
    <para>
111
126
      The settings dialog is available under the “Properties” item in the right click context menu on the main icon. It
112
127
      allows to tweak the history and to edit actions.
113
128
    </para>
114
129
 
115
 
    <sect2 id="history">
116
 
      <title>History</title>
 
130
    <sect2 id="general">
 
131
      <title>Xeral</title>
117
132
 
118
133
      <para>
119
 
        The following table describes the available options for the history:
 
134
        The following table describes the available options:
120
135
      </para>
121
136
 
122
 
      <table frame="all"><title>History options in the Settings dialog</title>
 
137
      <table frame="all"><title>General options in the Settings dialog</title>
123
138
      <tgroup cols="2" align="left">
124
139
      <thead>
125
140
      <row>
129
144
      </thead>
130
145
      <tbody>
131
146
      <row>
 
147
        <entry>Add selections</entry>
 
148
        <entry>Sync the primary clipboard with the default clipboard in a way that it is possible to paste what gets
 
149
        selected</entry>
 
150
      </row>
 
151
      <row>
 
152
        <entry>Exclude from history</entry>
 
153
        <entry>Prevents the primary clipboard from being inserted in the history</entry>
 
154
      </row>
 
155
      <row>
132
156
        <entry>Gardar ao saír</entry>
133
157
        <entry>Keeps the history at every new session</entry>
134
158
      </row>
135
159
      <row>
136
 
        <entry>Add selections</entry>
137
 
        <entry>Adds the selections to the history</entry>
138
 
      </row>
139
 
      <row>
140
160
        <entry>Store an image</entry>
141
161
        <entry>Allows to store one image in the history</entry>
142
162
      </row>
143
163
      <row>
144
 
        <entry>Size of the history</entry>
 
164
        <entry>Tamaño do historial</entry>
145
165
        <entry>Sets the number of items to keep in history</entry>
146
166
      </row>
147
167
      </tbody>
148
168
      </tgroup>
149
169
      </table>
150
170
 
151
 
      <screenshot>
 
171
      <figure>
 
172
        <title>Configuración de Clipman</title>
152
173
        <mediaobject>
153
174
          <imageobject>
154
175
            <imagedata fileref="images/clipman-settings-general.png" format="PNG"/>
157
178
            <phrase>Settings dialog with the General tab</phrase>
158
179
          </textobject>
159
180
        </mediaobject>
160
 
      </screenshot>
 
181
      </figure>
161
182
 
162
183
    </sect2>
163
184
 
164
185
    <sect2 id="actions">
165
 
      <title>Actions</title>
 
186
      <title>Accións</title>
166
187
 
167
188
      <para>
168
189
        An action is a pair of an action name and a regular expression. Each action can have one or more commands. The
179
200
        To learn more about actions go to <xref linkend="action"/>.
180
201
      </para>
181
202
 
182
 
      <screenshot>
 
203
      <figure>
 
204
        <title>Configuración de Clipman</title>
183
205
        <mediaobject>
184
206
          <imageobject>
185
207
            <imagedata fileref="images/clipman-settings-actions.png" format="PNG"/>
188
210
            <phrase>Settings dialog with the Actions tab</phrase>
189
211
          </textobject>
190
212
        </mediaobject>
191
 
      </screenshot>
 
213
      </figure>
192
214
 
193
215
    </sect2>
194
216
 
197
219
 
198
220
      <para>
199
221
        @PACKAGE_NAME@ uses Xfconf to store its settings in the <constant>xfce4-panel</constant> channel. That allows you
200
 
        to change the settings with the tool <command>xfconf-query</command>. The following table lists all the
 
222
        to change the settings with the tool <application>xfconf-query</application>. The following table lists all the
201
223
        properties with their possible values:
202
224
      </para>
203
225
 
204
 
      <table frame="all"><title>Xfconf Properties</title>
 
226
      <table frame="all"><title>Propiedades de Xfconf</title>
205
227
      <tgroup cols="4" align="left">
206
228
      <thead>
207
229
      <row>
216
238
        <entry>/plugins/clipman/settings/add-primary-clipboard</entry>
217
239
        <entry>bool</entry>
218
240
        <entry>false</entry>
219
 
        <entry>true to add selections</entry>
 
241
        <entry>true to sync the primary clipboard with the default clipboard</entry>
220
242
      </row>
221
243
      <row>
222
244
        <entry>/plugins/clipman/settings/enable-actions</entry>
225
247
        <entry>true to enable actions</entry>
226
248
      </row>
227
249
      <row>
 
250
        <entry>/plugins/clipman/settings/history-ignore-primary-clipboard</entry>
 
251
        <entry>bool</entry>
 
252
        <entry>false</entry>
 
253
        <entry>true to exclude the primary clipboard from the history</entry>
 
254
      </row>
 
255
        false
 
256
 
 
257
      <row>
228
258
        <entry>/plugins/clipman/settings/max-images-in-history</entry>
229
259
        <entry>uint</entry>
230
260
        <entry>0</entry>
255
285
  </sect1>
256
286
 
257
287
  <sect1 id="action">
258
 
    <title>Action</title>
 
288
    <title>Acción</title>
259
289
 
260
290
    <para>
261
291
      An action has a human readable name that describes the pattern it is going to match. The matches are made against
263
293
      also has a human readable name. The matched text can be reused in the command.
264
294
    </para>
265
295
 
266
 
    <screenshot>
 
296
    <figure>
 
297
      <title>Action Dialog</title>
267
298
      <mediaobject>
268
299
        <imageobject>
269
300
          <imagedata fileref="images/clipman-action-dialog.png" format="PNG"/>
272
303
          <phrase>Action edit dialog</phrase>
273
304
        </textobject>
274
305
      </mediaobject>
275
 
    </screenshot>
 
306
    </figure>
276
307
 
277
308
    <sect2 id="regexes">
278
 
      <title>Regular Expression</title>
 
309
      <title>Expresión regular</title>
279
310
 
280
311
      <para>
281
312
        Basic special characters: "<emphasis role="bold"><code>.?+*(|)[]\</code></emphasis>".
339
370
    </sect2>
340
371
 
341
372
    <sect2 id="command">
342
 
      <title>Command</title>
 
373
      <title>Comando</title>
343
374
 
344
375
      <para>
345
376
        A command can reuse one or more substitutions from the regular expression. The substitutions are represented by
367
398
 
368
399
 
369
400
  <sect1 id="about">
370
 
    <title>About @PACKAGE_NAME@</title>
 
401
    <title>Acerca de @PACKAGE_NAME@</title>
371
402
 
372
403
    <para>
373
404
      @PACKAGE_NAME@ was written by Eduard Roccatello and then maintained by Nick Schermer. Nowadays it is written by
386
417
      by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
387
418
    </para>
388
419
 
389
 
    <para>
390
 
      You should have received a copy of the <citetitle>GNU General Public License</citetitle> along with this program;
391
 
      if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA.
392
 
    </para>
 
420
    <para>Debeu recibir unha copia da Licenza Pública Xeral de GNU xunta con este programa; en caso contrario, escriba á Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA </para>
393
421
  </sect1>
394
422
 
395
423
</article>