[Goodies-commits] r7250 - in xfce4-clipman-plugin/trunk: . docs/manual docs/manual/C docs/manual/gl docs/manual/gl/images

Mike Massonnet mmassonnet at xfce.org
Mon Apr 20 15:56:16 CEST 2009 

Author: mmassonnet
Date: 2009-04-20 13:56:16 +0000 (Mon, 20 Apr 2009)
New Revision: 7250

Added:
   xfce4-clipman-plugin/trunk/docs/manual/gl/
   xfce4-clipman-plugin/trunk/docs/manual/gl/Makefile.am
   xfce4-clipman-plugin/trunk/docs/manual/gl/images/
   xfce4-clipman-plugin/trunk/docs/manual/gl/images/Makefile.am
   xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-action-dialog.png
   xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-menu.png
   xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-settings-actions.png
   xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-settings-general.png
   xfce4-clipman-plugin/trunk/docs/manual/gl/xfce4-clipman-plugin.html
   xfce4-clipman-plugin/trunk/docs/manual/gl/xfce4-clipman-plugin.xml.in
Modified:
   xfce4-clipman-plugin/trunk/configure.ac.in
   xfce4-clipman-plugin/trunk/docs/manual/C/xfce4-clipman-plugin.html
   xfce4-clipman-plugin/trunk/docs/manual/Makefile.am
Log:
create galician doc directory

Modified: xfce4-clipman-plugin/trunk/configure.ac.in
===================================================================
--- xfce4-clipman-plugin/trunk/configure.ac.in	2009-04-20 13:47:42 UTC (rev 7249)
+++ xfce4-clipman-plugin/trunk/configure.ac.in	2009-04-20 13:56:16 UTC (rev 7250)
@@ -121,6 +121,9 @@
 docs/manual/C/Makefile
 docs/manual/C/xfce4-clipman-plugin.xml
 docs/manual/C/images/Makefile
+docs/manual/gl/Makefile
+docs/manual/gl/xfce4-clipman-plugin.xml
+docs/manual/gl/images/Makefile
 ])
 
 dnl ***************************

Modified: xfce4-clipman-plugin/trunk/docs/manual/C/xfce4-clipman-plugin.html
===================================================================
--- xfce4-clipman-plugin/trunk/docs/manual/C/xfce4-clipman-plugin.html	2009-04-20 13:47:42 UTC (rev 7249)
+++ xfce4-clipman-plugin/trunk/docs/manual/C/xfce4-clipman-plugin.html	2009-04-20 13:56:16 UTC (rev 7250)
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Clipman Manual</title><link rel="stylesheet" href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="#xfce4-clipman-plugin" title="Clipman Manual"><link rel="next" href="#intro" title="Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="xfce4-clipman-plugin"></a>Clipman Manual</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Mike</span> <span class="surname">Massonnet</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a class="email" href="mailto:mmassonnet at xfce.org">mmassonnet at xfce.org</a>></code></p></div></div></div></div></div><div><span xmlns="http://www.w3.org/TR/xhtml1/transitional" 
 class="releaseinfo">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Clipman Manual</title><link rel="stylesheet" href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#xfce4-clipman-plugin" title="Clipman Manual"><link rel="next" href="#intro" title="Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="xfce4-clipman-plugin"></a>Clipman Manual</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Mike</span> <span class="surname">Massonnet</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a class="email" href="mailto:mmassonnet at xfce.org">mmassonnet at xfce.org</a>></code></p></div></div></div></div></div><div><span xmlns="http://www.w3.org/TR/xhtml1/transitional" c
 lass="releaseinfo">
       This manual describes version 1.0.0 of Clipman.
     <br></br></span></div><div><p class="copyright">Copyright © 2009 Mike Massonnet</p></div><div><div class="legalnotice"><a name="legalnotice"></a><p>
         Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free
@@ -30,7 +30,7 @@
       allows to tweak the history and to edit actions.
     </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="history"></a>History</h3></div></div></div><p>
         The following table describes the available options for the history:
-      </p><div class="table"><a name="id2836580"></a><p class="title"><b>Table 1. History options in the Settings dialog</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="History options in the Settings dialog" border="1"><colgroup><col xmlns=""><col xmlns=""></colgroup><thead xmlns=""><tr><th align="left">Options</th><th align="left">Description</th></tr></thead><tbody xmlns=""><tr><td align="left">Save on quit</td><td align="left">Keeps the history at every new session</td></tr><tr><td align="left">Add selections</td><td align="left">Adds the selections to the history</td></tr><tr><td align="left">Store an image</td><td align="left">Allows to store one image in the history</td></tr><tr><td align="left">Size of the history</td><td align="left">Sets the number of items to keep in history</td></tr></tbody></table></div></div><br class="table-break"><div class="screenshot"><div 
 class="mediaobject"><img src="images/clipman-settings-general.png" alt="Settings dialog with the General tab"></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="actions"></a>Actions</h3></div></div></div><p>
+      </p><div class="table"><a name="id2790546"></a><p class="title"><b>Table 1. History options in the Settings dialog</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="History options in the Settings dialog" border="1"><colgroup><col xmlns=""><col xmlns=""></colgroup><thead xmlns=""><tr><th align="left">Options</th><th align="left">Description</th></tr></thead><tbody xmlns=""><tr><td align="left">Save on quit</td><td align="left">Keeps the history at every new session</td></tr><tr><td align="left">Add selections</td><td align="left">Adds the selections to the history</td></tr><tr><td align="left">Store an image</td><td align="left">Allows to store one image in the history</td></tr><tr><td align="left">Size of the history</td><td align="left">Sets the number of items to keep in history</td></tr></tbody></table></div></div><br class="table-break"><div class="screenshot"><div 
 class="mediaobject"><img src="images/clipman-settings-general.png" alt="Settings dialog with the General tab"></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="actions"></a>Actions</h3></div></div></div><p>
         An action is a pair of an action name and a regular expression. Each action can have one or more commands. The
         support of actions is optional and can be enabled or disabled through the “Enable actions” option.
       </p><p>
@@ -43,7 +43,7 @@
         Clipman uses Xfconf to store its settings in the <code class="constant">xfce4-panel</code> channel. That allows you
         to change the settings with the tool <span class="command"><strong>xfconf-query</strong></span>. The following table lists all the
         properties with their possible values:
-      </p><div class="table"><a name="id2836928"></a><p class="title"><b>Table 2. Xfconf Properties</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Xfconf Properties" border="1"><colgroup><col xmlns=""><col xmlns=""><col xmlns=""><col xmlns=""></colgroup><thead xmlns=""><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Default</th><th align="left">Values</th></tr></thead><tbody xmlns=""><tr><td align="left">/plugins/clipman/settings/add-primary-clipboard</td><td align="left">bool</td><td align="left">false</td><td align="left">true to add selections</td></tr><tr><td align="left">/plugins/clipman/settings/enable-actions</td><td align="left">bool</td><td align="left">false</td><td align="left">true to enable actions</td></tr><tr><td align="left">/plugins/clipman/settings/max-images-in-history</td><td align="left">uint</td><td align="left">0</td><td a
 lign="left">0-5 number of images in history</td></tr><tr><td align="left">/plugins/clipman/settings/max-texts-in-history</td><td align="left">uint</td><td align="left">10</td><td align="left">5-100 number of texts in history</td></tr><tr><td align="left">/plugins/clipman/settings/save-on-quit</td><td align="left">bool</td><td align="left">true</td><td align="left">true to restore the history at every new session</td></tr></tbody></table></div></div><br class="table-break"><p>
+      </p><div class="table"><a name="id2790122"></a><p class="title"><b>Table 2. Xfconf Properties</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Xfconf Properties" border="1"><colgroup><col xmlns=""><col xmlns=""><col xmlns=""><col xmlns=""></colgroup><thead xmlns=""><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Default</th><th align="left">Values</th></tr></thead><tbody xmlns=""><tr><td align="left">/plugins/clipman/settings/add-primary-clipboard</td><td align="left">bool</td><td align="left">false</td><td align="left">true to add selections</td></tr><tr><td align="left">/plugins/clipman/settings/enable-actions</td><td align="left">bool</td><td align="left">false</td><td align="left">true to enable actions</td></tr><tr><td align="left">/plugins/clipman/settings/max-images-in-history</td><td align="left">uint</td><td align="left">0</td><td a
 lign="left">0-5 number of images in history</td></tr><tr><td align="left">/plugins/clipman/settings/max-texts-in-history</td><td align="left">uint</td><td align="left">10</td><td align="left">5-100 number of texts in history</td></tr><tr><td align="left">/plugins/clipman/settings/save-on-quit</td><td align="left">bool</td><td align="left">true</td><td align="left">true to restore the history at every new session</td></tr></tbody></table></div></div><br class="table-break"><p>
         To change a setting type the command-line:
       </p><code class="literal">xfconf-query -c xfce4-panel -p <property> -s <value></code></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="action"></a>Action</h2></div></div></div><p>
       An action has a human readable name that describes the pattern it is going to match. The matches are made against

Modified: xfce4-clipman-plugin/trunk/docs/manual/Makefile.am
===================================================================
--- xfce4-clipman-plugin/trunk/docs/manual/Makefile.am	2009-04-20 13:47:42 UTC (rev 7249)
+++ xfce4-clipman-plugin/trunk/docs/manual/Makefile.am	2009-04-20 13:56:16 UTC (rev 7250)
@@ -2,6 +2,7 @@
 
 SUBDIRS =								\
 	C								\
+	gl								\
 	$(NULL)
 
 EXTRA_DIST =								\

Added: xfce4-clipman-plugin/trunk/docs/manual/gl/Makefile.am
===================================================================
--- xfce4-clipman-plugin/trunk/docs/manual/gl/Makefile.am	                        (rev 0)
+++ xfce4-clipman-plugin/trunk/docs/manual/gl/Makefile.am	2009-04-20 13:56:16 UTC (rev 7250)
@@ -0,0 +1,61 @@
+## Makefile.am file for the Docbook to HTML generation
+##
+## Copyright (C) 2006 The Xfce development team.
+##
+## Written by Benedikt Meurer <benny at xfce.org>, 2006.
+
+NULL = 
+
+SUBDIRS =								\
+	images								\
+	$(NULL)
+
+TARGET_DIR = $(datadir)/xfce4/doc/C
+STYLESHEET = ../xfce-nochunk.xsl
+DOCUMENT = $(PACKAGE).xml
+
+DOC_STAMPS = html-build.stamp
+
+EXTRA_DIST = $(DOCUMENT)
+CLEANFILES = $(DOC_STAMPS)
+
+if ENABLE_XSLTPROC
+all-local: html-build.stamp
+
+html-build.stamp: $(srcdir)/$(DOCUMENT) $(srcdir)/$(STYLESHEET)
+	@echo "*** Building HTML ***"
+	@-chmod -R u+w $(srcdir)
+	$(XSLTPROC) --nonet -o $(srcdir) $(srcdir)/$(STYLESHEET) $(srcdir)/$(DOCUMENT)
+	touch html-build.stamp
+else
+all-local:
+endif
+
+install-data-local:
+	installfiles=`echo $(srcdir)/*.html`;				\
+	if test "$$installfiles" = '$(srcdir)/*.html'; then		\
+		echo "--- Nothing to install";				\
+	else								\
+		$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR);		\
+		for file in $$installfiles; do				\
+			echo "--- Installing "$$file;			\
+			$(INSTALL_DATA) $$file $(DESTDIR)$(TARGET_DIR);	\
+		done;							\
+	fi
+
+uninstall-local:
+	rm -rf $(DESTDIR)$(TARGET_DIR)/*
+
+if ENABLE_XSLTPROC
+dist-check-xsltproc: all
+else
+dist-check-xsltproc:
+	@echo "*** xsltproc must be installed and enabled in order to make dist"
+	@false
+endif
+
+dist-hook: dist-check-xsltproc dist-hook-local
+	-cp $(srcdir)/*.html $(distdir)
+
+.PHONY: dist-hook-local
+

Added: xfce4-clipman-plugin/trunk/docs/manual/gl/images/Makefile.am
===================================================================
--- xfce4-clipman-plugin/trunk/docs/manual/gl/images/Makefile.am	                        (rev 0)
+++ xfce4-clipman-plugin/trunk/docs/manual/gl/images/Makefile.am	2009-04-20 13:56:16 UTC (rev 7250)
@@ -0,0 +1,12 @@
+NULL = 
+
+imagesdir = $(datadir)/xfce4/doc/C/images
+images_DATA =								\
+	clipman-action-dialog.png					\
+	clipman-menu.png						\
+	clipman-settings-actions.png					\
+	clipman-settings-general.png					\
+	$(NULL)
+
+EXTRA_DIST = $(images_DATA)
+

Added: xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-action-dialog.png
===================================================================
(Binary files differ)


Property changes on: xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-action-dialog.png
___________________________________________________________________
Added: svn:mime-type
   + application/octet-stream

Added: xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-menu.png
===================================================================
(Binary files differ)


Property changes on: xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-menu.png
___________________________________________________________________
Added: svn:mime-type
   + application/octet-stream

Added: xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-settings-actions.png
===================================================================
(Binary files differ)


Property changes on: xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-settings-actions.png
___________________________________________________________________
Added: svn:mime-type
   + application/octet-stream

Added: xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-settings-general.png
===================================================================
(Binary files differ)


Property changes on: xfce4-clipman-plugin/trunk/docs/manual/gl/images/clipman-settings-general.png
___________________________________________________________________
Added: svn:mime-type
   + application/octet-stream

Added: xfce4-clipman-plugin/trunk/docs/manual/gl/xfce4-clipman-plugin.html
===================================================================
--- xfce4-clipman-plugin/trunk/docs/manual/gl/xfce4-clipman-plugin.html	                        (rev 0)
+++ xfce4-clipman-plugin/trunk/docs/manual/gl/xfce4-clipman-plugin.html	2009-04-20 13:56:16 UTC (rev 7250)
@@ -0,0 +1,109 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Manual de Clipman</title><link rel="stylesheet" href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#xfce4-clipman-plugin" title="Manual de Clipman"><link rel="next" href="#intro" title="Introdución"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="gl"><div class="titlepage"><div><div><h2 class="title"><a name="xfce4-clipman-plugin"></a>Manual de Clipman</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Mike</span> <span class="surname">Massonnet</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a class="email" href="mailto:mmassonnet at xfce.org">mmassonnet at xfce.org</a>></code></p></div></div></div></div></div><div><span xmlns="http://www.w3.org/TR/xhtml1/transit
 ional" class="releaseinfo">
+      This manual describes version 1.0.0 of Clipman.
+    <br></br></span></div><div><p class="copyright">Copyright © 2009 Mike Massonnet</p></div><div><p class="copyright">Copyright © 2009. Leandro Regueiro (leandro.regueiro at gmail.com)</p></div><div><p class="copyright">Copyright © podes atopar máis información en http://trasno.net Se desexas colaborar connosco</p></div><div><div class="legalnotice"><a name="legalnotice"></a><p>
+        Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free
+        Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no
+        Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. The complete license text is
+        available from the <a class="ulink" href="http://www.fsf.org/" target="_top">Free Software Foundation</a>.
+      </p></div></div><div><p class="pubdate">April 2009</p></div></div><hr></div><div class="toc"><p><b>Índice</b></p><dl><dt><span class="sect1"><a href="#intro">Introdución</a></span></dt><dd><dl><dt><span class="sect2"><a href="#anatomy-clipboard">Anatomy of a Clipboard</a></span></dt></dl></dd><dt><span class="sect1"><a href="#usage">Usage</a></span></dt><dt><span class="sect1"><a href="#settings">Settings</a></span></dt><dd><dl><dt><span class="sect2"><a href="#history">History</a></span></dt><dt><span class="sect2"><a href="#actions">Actions</a></span></dt><dt><span class="sect2"><a href="#xfconf">Xfconf</a></span></dt></dl></dd><dt><span class="sect1"><a href="#action">Action</a></span></dt><dd><dl><dt><span class="sect2"><a href="#regexes">Regular Expression</a></span></dt><dt><span class="sect2"><a href="#command">Command</a></span></dt></dl></dd><dt><span class="sect1"><a href="#support">Support</a></span></dt><dt><span class="sect1"><a href="#about">About Clipman
 </a></span></dt></dl></div><div class="sect1" lang="gl"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="intro"></a>Introdución</h2></div></div></div><p>
+      Clipman is a clipboard manager for Xfce. It keeps the clipboard contents around while it is usually lost
+      when you close an application. It is able to handle text and images, and has a feature to execute actions on
+      specific text selections by matching them against regular expressions.
+    </p><p>
+      There are two ways to run Clipman. You can select Clipman in the applications menu under the category
+      Utility or type <span class="command"><strong>xfce4-clipman-plugin</strong></span> on the command line, or you can add it into your panel. To
+      add a new item in the panel right click the panel and select “Add new item…”.
+    </p><div class="sect2" lang="gl"><div class="titlepage"><div><div><h3 class="title"><a name="anatomy-clipboard"></a>Anatomy of a Clipboard</h3></div></div></div><p>
+        In X11 (all Unix platforms) there are by default two clipboards to exchange any data between the windows. A
+        default clipboard which is modified by manual copies (for instance when you select a file and press the copy
+        button), and there is a primary clipboard which is modified by selections (for instance when you select text in
+        a field).
+      </p><p>
+        Clipman handles only the default clipboard, but optionnaly it can also notice the selections.  When it is
+        handling the selections, the default clipboard will always be synced with it and contain the same data.
+      </p></div></div><div class="sect1" lang="gl"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="usage"></a>Usage</h2></div></div></div><p>
+      Clipman is used to keep in history a list of clipboard contents and to restore them. The history is
+      displayed in a menu by clicking on the main icon. Within the menu it is possible to select an item to restore it,
+      to clear the history and to activate or deactivate the clipboard manager.
+    </p><div class="screenshot"><div class="mediaobject"><img src="images/clipman-menu.png" alt="Menu displaying the history"></div></div></div><div class="sect1" lang="gl"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="settings"></a>Settings</h2></div></div></div><p>
+      The settings dialog is available under the “Properties” item in the right click context menu on the main icon. It
+      allows to tweak the history and to edit actions.
+    </p><div class="sect2" lang="gl"><div class="titlepage"><div><div><h3 class="title"><a name="history"></a>History</h3></div></div></div><p>
+        The following table describes the available options for the history:
+      </p><div class="table"><a name="id2636412"></a><p class="title"><b>TáboaTáboa 1. History options in the Settings dialog</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="History options in the Settings dialog" border="1"><colgroup><col xmlns=""><col xmlns=""></colgroup><thead xmlns=""><tr><th align="left">Opcións</th><th align="left">Descrición</th></tr></thead><tbody xmlns=""><tr><td align="left">Gardar ao saír</td><td align="left">Keeps the history at every new session</td></tr><tr><td align="left">Add selections</td><td align="left">Adds the selections to the history</td></tr><tr><td align="left">Store an image</td><td align="left">Allows to store one image in the history</td></tr><tr><td align="left">Size of the history</td><td align="left">Sets the number of items to keep in history</td></tr></tbody></table></div></div><br class="table-break"><div class="screenshot"
 ><div class="mediaobject"><img src="images/clipman-settings-general.png" alt="Settings dialog with the General tab"></div></div></div><div class="sect2" lang="gl"><div class="titlepage"><div><div><h3 class="title"><a name="actions"></a>Actions</h3></div></div></div><p>
+        An action is a pair of an action name and a regular expression. Each action can have one or more commands. The
+        support of actions is optional and can be enabled or disabled through the “Enable actions” option.
+      </p><p>
+        To add an action click the Add icon, to edit an action select the action and click the Edit icon or double click
+        the action, and to remove an action select an action and click the Delete icon. By adding or editing an action a
+        new dialog is opened.
+      </p><p>
+        To learn more about actions go to <a class="xref" href="#action" title="Action">« Action »</a>.
+      </p><div class="screenshot"><div class="mediaobject"><img src="images/clipman-settings-actions.png" alt="Settings dialog with the Actions tab"></div></div></div><div class="sect2" lang="gl"><div class="titlepage"><div><div><h3 class="title"><a name="xfconf"></a>Xfconf</h3></div></div></div><p>
+        Clipman uses Xfconf to store its settings in the <code class="constant">xfce4-panel</code> channel. That allows you
+        to change the settings with the tool <span class="command"><strong>xfconf-query</strong></span>. The following table lists all the
+        properties with their possible values:
+      </p><div class="table"><a name="id2635989"></a><p class="title"><b>TáboaTáboa 2. Xfconf Properties</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Xfconf Properties" border="1"><colgroup><col xmlns=""><col xmlns=""><col xmlns=""><col xmlns=""></colgroup><thead xmlns=""><tr><th align="left">Propiedade</th><th align="left">Tipo</th><th align="left">Default</th><th align="left">Values</th></tr></thead><tbody xmlns=""><tr><td align="left">/plugins/clipman/settings/add-primary-clipboard</td><td align="left">bool</td><td align="left">false</td><td align="left">true to add selections</td></tr><tr><td align="left">/plugins/clipman/settings/enable-actions</td><td align="left">bool</td><td align="left">false</td><td align="left">true to enable actions</td></tr><tr><td align="left">/plugins/clipman/settings/max-images-in-history</td><td align="left">uint</td><td align="left">0</t
 d><td align="left">0-5 number of images in history</td></tr><tr><td align="left">/plugins/clipman/settings/max-texts-in-history</td><td align="left">uint</td><td align="left">10</td><td align="left">5-100 number of texts in history</td></tr><tr><td align="left">/plugins/clipman/settings/save-on-quit</td><td align="left">bool</td><td align="left">true</td><td align="left">true to restore the history at every new session</td></tr></tbody></table></div></div><br class="table-break"><p>
+        To change a setting type the command-line:
+      </p><code class="literal">xfconf-query -c xfce4-panel -p <property> -s <value></code></div></div><div class="sect1" lang="gl"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="action"></a>Action</h2></div></div></div><p>
+      An action has a human readable name that describes the pattern it is going to match. The matches are made against
+      text from the selections and the pattern is a regular expression. An action must have at least one command which
+      also has a human readable name. The matched text can be reused in the command.
+    </p><div class="screenshot"><div class="mediaobject"><img src="images/clipman-action-dialog.png" alt="Action edit dialog"></div></div><div class="sect2" lang="gl"><div class="titlepage"><div><div><h3 class="title"><a name="regexes"></a>Regular Expression</h3></div></div></div><p>
+        Basic special characters: "<span class="bold"><strong><code class="code">.?+*(|)[]\</code></strong></span>".
+      </p><div class="itemizedlist"><ul type="disc"><li>
+          ”<span class="bold"><strong><code class="code">.</code></strong></span>”: represents a single character.
+        </li><li>
+          ”<span class="bold"><strong><code class="code">?+*</code></strong></span>”: respectively means zero or one character, one or more
+          characters, and zero or more characters.
+        </li><li>
+          ”<span class="bold"><strong><code class="code">(|)</code></strong></span>”: used for grouping and substitution, the vertical bar is
+          used as an OR operation.
+        </li><li>
+          ”<span class="bold"><strong><code class="code">[^]</code></strong></span>”: used to match a character from a set of characters and
+          special characters, the circumflex is used at the start as a negation.
+        </li><li>
+          ”<span class="bold"><strong><code class="code">\</code></strong></span>”: escapes a special character.
+        </li></ul></div><p>
+        Basic alphanumeric character class: "<span class="bold"><strong><code class="code">A-Za-z0-9</code></strong></span>". Character classes
+        are used within square brackets to represent a set of characters.
+      </p><div class="sect3" lang="gl"><div class="titlepage"><div><div><h4 class="title"><a name="regexes-examples"></a>Exemplos</h4></div></div></div><div class="itemizedlist"><ul type="disc"><li>
+            "<span class="bold"><strong><code class="code">bug ?#?[0-9]+</code></strong></span>": text "<span class="emphasis"><em>bug </em></span>", zero or one
+            space, zero or one sharp character, and one or more numbers.
+          </li><li>
+            "<span class="bold"><strong><code class="code">(http|ftp).+\.(jpg|png|gif)</code></strong></span>": text
+            "<span class="emphasis"><em>http</em></span>" or "<span class="emphasis"><em>ftp</em></span>", one or more character, a point, and the text
+            "<span class="emphasis"><em>jpg</em></span>", "<span class="emphasis"><em>png</em></span>" or "<span class="emphasis"><em>gif</em></span>".
+          </li><li>
+            "<span class="bold"><strong><code class="code">http://.{120}[^ ]+</code></strong></span>": text "<span class="emphasis"><em>http://</em></span>", 120
+            characters, and one or more characters except a space.
+          </li></ul></div></div><div class="sect3" lang="gl"><div class="titlepage"><div><div><h4 class="title"><a name="regexes-external-ressource"></a>External Ressource</h4></div></div></div><p>
+          Have a look at the <a class="ulink" href="http://en.wikipedia.org/wiki/Regular_expression" target="_top">Wikipedia
+          article</a> about regular expressions.
+        </p></div></div><div class="sect2" lang="gl"><div class="titlepage"><div><div><h3 class="title"><a name="command"></a>Command</h3></div></div></div><p>
+        A command can reuse one or more substitutions from the regular expression. The substitutions are represented by
+        ”<span class="bold"><strong><code class="code">\<number></code></strong></span>” where <number> corresponds to the
+        sub-pattern within parentheses or 0 for the complete text.
+      </p><p>
+        For example, from the simple pattern ”<span class="bold"><strong><code class="code">bug #(123)</code></strong></span>” it is possible
+        to use ”<span class="bold"><strong><code class="code">\0</code></strong></span>” for the text “bug #123” and ”<span class="bold"><strong><code class="code">\1</code></strong></span>” for the text “123”.  For the command ”<code class="code">exo-open
+        http://host/\1</code>”, the real executed command would be ”<code class="code">exo-open http://host/123</code>”.
+      </p></div></div><div class="sect1" lang="gl"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="support"></a>Support</h2></div></div></div><p>
+      To report a bug or a feature request use the bug tracking system at <a class="ulink" href="http://bugzilla.xfce.org/" target="_top">http://bugzilla.xfce.org/</a>. If you have questions about the use of this software,
+      please ask on the <a class="ulink" href="http://foo-projects.org/mailman/listinfo/xfce" target="_top">Xfce mailing list</a>
+      or point your IRC client to <span class="bold"><strong>irc.freenode.net</strong></span>, join the channel <span class="bold"><strong>#xfce</strong></span> and ask for help.
+    </p></div><div class="sect1" lang="gl"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="about"></a>About Clipman</h2></div></div></div><p>
+      Clipman was written by Eduard Roccatello and then maintained by Nick Schermer. Nowadays it is written by
+      Mike Massonnet (<code class="email"><<a class="email" href="mailto:mmassonnet at xfce.org">mmassonnet at xfce.org</a>></code>). Visit the <a class="ulink" href="http://goodies.xfce.org/projects/panel-plugins/xfce4-clipman-plugin" target="_top">Clipman Web
+      site</a>.
+    </p><p>
+      This documentation was written by Mike Massonnet (<code class="email"><<a class="email" href="mailto:mmassonnet at xfce.org">mmassonnet at xfce.org</a>></code>). Please send all your comments and
+      suggestions regarding this manual to <code class="email"><<a class="email" href="mailto:mmassonnet at xfce.org">mmassonnet at xfce.org</a>></code>.
+      
+    </p><p>
+      This software is distributed under the terms of the <em class="citetitle">GNU General Public License</em> as published
+      by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
+    </p><p>
+      You should have received a copy of the <em class="citetitle">GNU General Public License</em> along with this program;
+      if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA.
+    </p></div></div></body></html>

Added: xfce4-clipman-plugin/trunk/docs/manual/gl/xfce4-clipman-plugin.xml.in
===================================================================
--- xfce4-clipman-plugin/trunk/docs/manual/gl/xfce4-clipman-plugin.xml.in	                        (rev 0)
+++ xfce4-clipman-plugin/trunk/docs/manual/gl/xfce4-clipman-plugin.xml.in	2009-04-20 13:56:16 UTC (rev 7250)
@@ -0,0 +1,395 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+<!ENTITY app-author "Mike Massonnet">
+<!ENTITY app-email "mmassonnet at xfce.org">
+<!ENTITY app-website "http://goodies.xfce.org/projects/panel-plugins/xfce4-clipman-plugin">
+<!ENTITY doc-author "Mike Massonnet">
+<!ENTITY doc-email "mmassonnet at xfce.org">
+<!ENTITY date "April 2009">
+<!ENTITY application "@PACKAGE_NAME@">
+<!ENTITY version "@PACKAGE_VERSION@">
+<!ENTITY bugtracker "@PACKAGE_BUGREPORT@">
+]>
+<article id="xfce4-clipman-plugin" lang="gl">
+
+  <!-- Header -->
+  <articleinfo>
+    <title>Manual de @PACKAGE_NAME@</title>
+
+    <pubdate>&date;</pubdate>
+
+    <copyright>
+      <year>2009</year>
+      <holder>&doc-author;</holder>
+    </copyright><copyright><year>2009.</year><holder>Leandro Regueiro (leandro.regueiro at gmail.com)</holder></copyright><copyright><year>podes atopar máis información en http://trasno.net</year><holder>Se desexas colaborar connosco</holder></copyright>
+
+    <legalnotice id="legalnotice">
+      <para>
+        Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free
+        Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no
+        Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. The complete license text is
+        available from the <ulink type="http" url="http://www.fsf.org/">Free Software Foundation</ulink>.
+      </para>
+    </legalnotice>
+
+    <authorgroup>
+      <author>
+        <firstname>Mike</firstname>
+        <surname>Massonnet</surname>
+        <affiliation>
+          <address><email>mmassonnet at xfce.org</email></address>
+        </affiliation>
+      </author>
+    </authorgroup>
+
+    <releaseinfo>
+      This manual describes version @PACKAGE_VERSION@ of @PACKAGE_NAME at .
+    </releaseinfo>
+  </articleinfo>
+
+
+  <sect1 id="intro">
+    <title>Introdución</title>
+
+    <para>
+      @PACKAGE_NAME@ is a clipboard manager for Xfce. It keeps the clipboard contents around while it is usually lost
+      when you close an application. It is able to handle text and images, and has a feature to execute actions on
+      specific text selections by matching them against regular expressions.
+    </para>
+
+    <para>
+      There are two ways to run @PACKAGE_NAME at . You can select @PACKAGE_NAME@ in the applications menu under the category
+      Utility or type <command>xfce4-clipman-plugin</command> on the command line, or you can add it into your panel. To
+      add a new item in the panel right click the panel and select “Add new item…”.
+    </para>
+
+    <sect2 id="anatomy-clipboard">
+      <title>Anatomy of a Clipboard</title>
+
+      <para>
+        In X11 (all Unix platforms) there are by default two clipboards to exchange any data between the windows. A
+        default clipboard which is modified by manual copies (for instance when you select a file and press the copy
+        button), and there is a primary clipboard which is modified by selections (for instance when you select text in
+        a field).
+      </para>
+
+      <para>
+        @PACKAGE_NAME@ handles only the default clipboard, but optionnaly it can also notice the selections.  When it is
+        handling the selections, the default clipboard will always be synced with it and contain the same data.
+      </para>
+    </sect2>
+  </sect1>
+
+
+  <sect1 id="usage">
+    <title>Usage</title>
+
+    <para>
+      @PACKAGE_NAME@ is used to keep in history a list of clipboard contents and to restore them. The history is
+      displayed in a menu by clicking on the main icon. Within the menu it is possible to select an item to restore it,
+      to clear the history and to activate or deactivate the clipboard manager.
+    </para>
+
+    <screenshot>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/clipman-menu.png" format="PNG"/>
+        </imageobject>
+        <textobject>
+          <phrase>Menu displaying the history</phrase>
+        </textobject>
+      </mediaobject>
+    </screenshot>
+
+  </sect1>
+
+
+  <sect1 id="settings">
+    <title>Settings</title>
+
+    <para>
+      The settings dialog is available under the “Properties” item in the right click context menu on the main icon. It
+      allows to tweak the history and to edit actions.
+    </para>
+
+    <sect2 id="history">
+      <title>History</title>
+
+      <para>
+        The following table describes the available options for the history:
+      </para>
+
+      <table frame="all"><title>History options in the Settings dialog</title>
+      <tgroup cols="2" align="left">
+      <thead>
+      <row>
+        <entry>Opcións</entry>
+        <entry>Descrición</entry>
+      </row>
+      </thead>
+      <tbody>
+      <row>
+        <entry>Gardar ao saír</entry>
+        <entry>Keeps the history at every new session</entry>
+      </row>
+      <row>
+        <entry>Add selections</entry>
+        <entry>Adds the selections to the history</entry>
+      </row>
+      <row>
+        <entry>Store an image</entry>
+        <entry>Allows to store one image in the history</entry>
+      </row>
+      <row>
+        <entry>Size of the history</entry>
+        <entry>Sets the number of items to keep in history</entry>
+      </row>
+      </tbody>
+      </tgroup>
+      </table>
+
+      <screenshot>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/clipman-settings-general.png" format="PNG"/>
+          </imageobject>
+          <textobject>
+            <phrase>Settings dialog with the General tab</phrase>
+          </textobject>
+        </mediaobject>
+      </screenshot>
+
+    </sect2>
+
+    <sect2 id="actions">
+      <title>Actions</title>
+
+      <para>
+        An action is a pair of an action name and a regular expression. Each action can have one or more commands. The
+        support of actions is optional and can be enabled or disabled through the “Enable actions” option.
+      </para>
+
+      <para>
+        To add an action click the Add icon, to edit an action select the action and click the Edit icon or double click
+        the action, and to remove an action select an action and click the Delete icon. By adding or editing an action a
+        new dialog is opened.
+      </para>
+
+      <para>
+        To learn more about actions go to <xref linkend="action"/>.
+      </para>
+
+      <screenshot>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/clipman-settings-actions.png" format="PNG"/>
+          </imageobject>
+          <textobject>
+            <phrase>Settings dialog with the Actions tab</phrase>
+          </textobject>
+        </mediaobject>
+      </screenshot>
+
+    </sect2>
+
+    <sect2 id="xfconf">
+      <title>Xfconf</title>
+
+      <para>
+        @PACKAGE_NAME@ uses Xfconf to store its settings in the <constant>xfce4-panel</constant> channel. That allows you
+        to change the settings with the tool <command>xfconf-query</command>. The following table lists all the
+        properties with their possible values:
+      </para>
+
+      <table frame="all"><title>Xfconf Properties</title>
+      <tgroup cols="4" align="left">
+      <thead>
+      <row>
+        <entry>Propiedade</entry>
+        <entry>Tipo</entry>
+        <entry>Default</entry>
+        <entry>Values</entry>
+      </row>
+      </thead>
+      <tbody>
+      <row>
+        <entry>/plugins/clipman/settings/add-primary-clipboard</entry>
+        <entry>bool</entry>
+        <entry>false</entry>
+        <entry>true to add selections</entry>
+      </row>
+      <row>
+        <entry>/plugins/clipman/settings/enable-actions</entry>
+        <entry>bool</entry>
+        <entry>false</entry>
+        <entry>true to enable actions</entry>
+      </row>
+      <row>
+        <entry>/plugins/clipman/settings/max-images-in-history</entry>
+        <entry>uint</entry>
+        <entry>0</entry>
+        <entry>0-5 number of images in history</entry>
+      </row>
+      <row>
+        <entry>/plugins/clipman/settings/max-texts-in-history</entry>
+        <entry>uint</entry>
+        <entry>10</entry>
+        <entry>5-100 number of texts in history</entry>
+      </row>
+      <row>
+        <entry>/plugins/clipman/settings/save-on-quit</entry>
+        <entry>bool</entry>
+        <entry>true</entry>
+        <entry>true to restore the history at every new session</entry>
+      </row>
+      </tbody>
+      </tgroup>
+      </table>
+
+      <para>
+        To change a setting type the command-line:
+      </para>
+
+      <literal><![CDATA[xfconf-query -c xfce4-panel -p <property> -s <value>]]></literal>
+    </sect2>
+  </sect1>
+
+  <sect1 id="action">
+    <title>Action</title>
+
+    <para>
+      An action has a human readable name that describes the pattern it is going to match. The matches are made against
+      text from the selections and the pattern is a regular expression. An action must have at least one command which
+      also has a human readable name. The matched text can be reused in the command.
+    </para>
+
+    <screenshot>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/clipman-action-dialog.png" format="PNG"/>
+        </imageobject>
+        <textobject>
+          <phrase>Action edit dialog</phrase>
+        </textobject>
+      </mediaobject>
+    </screenshot>
+
+    <sect2 id="regexes">
+      <title>Regular Expression</title>
+
+      <para>
+        Basic special characters: "<emphasis role="bold"><code>.?+*(|)[]\</code></emphasis>".
+      </para>
+
+      <itemizedlist>
+        <listitem>
+          ”<emphasis role="bold"><code>.</code></emphasis>”: represents a single character.
+        </listitem>
+        <listitem>
+          ”<emphasis role="bold"><code>?+*</code></emphasis>”: respectively means zero or one character, one or more
+          characters, and zero or more characters.
+        </listitem>
+        <listitem>
+          ”<emphasis role="bold"><code>(|)</code></emphasis>”: used for grouping and substitution, the vertical bar is
+          used as an OR operation.
+        </listitem>
+        <listitem>
+          ”<emphasis role="bold"><code>[^]</code></emphasis>”: used to match a character from a set of characters and
+          special characters, the circumflex is used at the start as a negation.
+        </listitem>
+        <listitem>
+          ”<emphasis role="bold"><code>\</code></emphasis>”: escapes a special character.
+        </listitem>
+      </itemizedlist>
+
+      <para>
+        Basic alphanumeric character class: "<emphasis role="bold"><code>A-Za-z0-9</code></emphasis>". Character classes
+        are used within square brackets to represent a set of characters.
+      </para>
+
+
+      <sect3 id="regexes-examples">
+        <title>Exemplos</title>
+
+        <itemizedlist>
+          <listitem>
+            "<emphasis role="bold"><code>bug ?#?[0-9]+</code></emphasis>": text "<emphasis>bug </emphasis>", zero or one
+            space, zero or one sharp character, and one or more numbers.
+          </listitem>
+          <listitem>
+            "<emphasis role="bold"><code>(http|ftp).+\.(jpg|png|gif)</code></emphasis>": text
+            "<emphasis>http</emphasis>" or "<emphasis>ftp</emphasis>", one or more character, a point, and the text
+            "<emphasis>jpg</emphasis>", "<emphasis>png</emphasis>" or "<emphasis>gif</emphasis>".
+          </listitem>
+          <listitem>
+            "<emphasis role="bold"><code>http://.{120}[^ ]+</code></emphasis>": text "<emphasis>http://</emphasis>", 120
+            characters, and one or more characters except a space.
+          </listitem>
+        </itemizedlist>
+      </sect3>
+
+      <sect3 id="regexes-external-ressource">
+        <title>External Ressource</title>
+
+        <para>
+          Have a look at the <ulink type="http" url="http://en.wikipedia.org/wiki/Regular_expression">Wikipedia
+          article</ulink> about regular expressions.
+        </para>
+      </sect3>
+    </sect2>
+
+    <sect2 id="command">
+      <title>Command</title>
+
+      <para>
+        A command can reuse one or more substitutions from the regular expression. The substitutions are represented by
+        ”<emphasis role="bold"><code>\<number></code></emphasis>” where <number> corresponds to the
+        sub-pattern within parentheses or 0 for the complete text.
+      </para>
+
+      <para>
+        For example, from the simple pattern ”<emphasis role="bold"><code>bug #(123)</code></emphasis>” it is possible
+        to use ”<emphasis role="bold"><code>\0</code></emphasis>” for the text “bug #123” and ”<emphasis role="bold"><code>\1</code></emphasis>” for the text “123”.  For the command ”<code>exo-open
+        http://host/\1</code>”, the real executed command would be ”<code>exo-open http://host/123</code>”.
+      </para>
+    </sect2>
+  </sect1>
+
+  <sect1 id="support">
+    <title>Support</title>
+
+    <para>
+      To report a bug or a feature request use the bug tracking system at <ulink type="http" url="@PACKAGE_BUGREPORT@">@PACKAGE_BUGREPORT@</ulink>. If you have questions about the use of this software,
+      please ask on the <ulink type="http" url="http://foo-projects.org/mailman/listinfo/xfce">Xfce mailing list</ulink>
+      or point your IRC client to <emphasis role="bold">irc.freenode.net</emphasis>, join the channel <emphasis role="bold">#xfce</emphasis> and ask for help.
+    </para>
+  </sect1>
+
+
+  <sect1 id="about">
+    <title>About @PACKAGE_NAME@</title>
+
+    <para>
+      @PACKAGE_NAME@ was written by Eduard Roccatello and then maintained by Nick Schermer. Nowadays it is written by
+      Mike Massonnet (<email>mmassonnet at xfce.org</email>). Visit the <ulink type="http" url="http://goodies.xfce.org/projects/panel-plugins/xfce4-clipman-plugin">@PACKAGE_NAME@ Web
+      site</ulink>.
+    </para>
+
+    <para>
+      This documentation was written by Mike Massonnet (<email>mmassonnet at xfce.org</email>). Please send all your comments and
+      suggestions regarding this manual to <email>mmassonnet at xfce.org</email>.
+      
+    </para>
+
+    <para>
+      This software is distributed under the terms of the <citetitle>GNU General Public License</citetitle> as published
+      by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
+    </para>
+
+    <para>
+      You should have received a copy of the <citetitle>GNU General Public License</citetitle> along with this program;
+      if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA.
+    </para>
+  </sect1>
+
+</article>

More information about the Goodies-commits mailing list