initial

3 files changed, 253 insertions, 0 deletions

diff --git a/trashapplet/docs/C/figures/trash-applet.png b/trashapplet/docs/C/figures/trash-applet.png
new file mode 100644
index 00000000..a53525d5
--- /dev/null
+++ b/trashapplet/docs/C/figures/trash-applet.png
diff --git a/trashapplet/docs/C/legal.xml b/trashapplet/docs/C/legal.xml
new file mode 100644
index 00000000..16b471c2
--- /dev/null
+++ b/trashapplet/docs/C/legal.xml
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="utf-8"?>
+<legalnotice id="legalnotice">
+<para>
+Permission is granted to copy, distribute and/or modify this document under the 
+terms of the GNU Free DocumentationLicense (GFDL), Version 1.1 or any later 
+version published by the Free Software Foundation with no Invariant Sections, 	  no Front-Cover Texts, and
+no Back-Cover Texts. You can find a copy of the GFDL at this 
+
+		<ulink url="ghelp:fdl" type="help">link</ulink> 
+
+or in the file COPYING-DOCS distributed with this manual.</para>
+<para> 
+This manual is part of a collection of MATE documents distributed under the 
+GFDL. If you want to distribute this manual separately from the collection, 
+you can do so by adding a copy of the license to the document, as described in 
+section 6 of the license. 	
+</para>
+<para>
+Many of the names used by companies to distinguish their products
+and services are claimed as trademarks. Where those names appear in any
+MATE documentation, and the members of the MATE Documentation Project
+are made aware of those trademarks, then the names are in capital letters
+or initial capital letters. 
+</para>
+<para>
+DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF 
+THE GNU FREE DOCUMENTATION LICENSE WITH THE FURTHER UNDERSTANDING THAT:  	  
+<orderedlist><listitem>
+<para>
+DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER 
+EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE 
+DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE,
+FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE 
+QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE 
+DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,                     YOU (NOT THE INITIAL
+WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF
+ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
+OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS    
+LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED              
+VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER                    
+EXCEPT UNDER THIS DISCLAIMER; AND
+</para>
+</listitem>
+<listitem>
+<para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER
+IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE,
+SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR,
+OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
+ OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH   
+PARTIES, BE LIABLE TO ANY PERSON FOR ANY             
+DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR         
+CONSEQUENTIAL DAMAGES OF ANY CHARACTER                     
+  INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF
+GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION,
+OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT
+OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED
+VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL
+HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.
+</para>
+</listitem>
+</orderedlist> 	
+</para>
+</legalnotice>
+
diff --git a/trashapplet/docs/C/mate-trashapplet.xml b/trashapplet/docs/C/mate-trashapplet.xml
new file mode 100644
index 00000000..4a7505d4
--- /dev/null
+++ b/trashapplet/docs/C/mate-trashapplet.xml
@@ -0,0 +1,189 @@
+<?xml version="1.0"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
+"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+  <!ENTITY legal SYSTEM "legal.xml">
+  <!ENTITY appletversion "2.14">
+  <!ENTITY manrevision "2.11">
+  <!ENTITY date "August 2006">
+  <!ENTITY applet "Panel Trash">
+]>
+
+<article id="index" lang="en">
+<!-- please do not change the id; for translations, change lang to -->
+<!-- appropriate code -->
+  <articleinfo> 
+	 <title>&applet; Manual</title> 
+	 <abstract role="description">
+	   <para>&applet; lets you manage your trash from the panel. </para>
+	 </abstract>
+	 <copyright>
+	   <year>2006</year>
+	   <holder>MATE Documentation Project</holder>
+	 </copyright>	 
+	 <copyright>
+	   <year>2005</year>
+	   <holder>Davyd Madeley</holder>
+	 </copyright>
+	 <copyright> 
+		<year>2004</year>
+		<holder>Michiel Sikkes</holder> 
+	 </copyright> 
+<!-- translators: uncomment this:
+
+  <copyright>
+   <year>2002</year>
+   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
+  </copyright>
+
+   -->
+<!-- An address can be added to the publisher information.  If a role is 
+     not specified, the publisher/author is the same for all versions of the 
+     document.  -->
+	 <publisher role="maintainer"> 
+		<publishername> MATE Documentation Project </publishername> 
+	 </publisher> 
+
+&legal;
+<!-- This file  contains link to license for the documentation (GNU FDL), and 
+     other legal stuff such as "NO WARRANTY" statement. Please do not change 
+     any of this. -->
+
+	 <authorgroup> 
+		<author> 
+		  <firstname>Michiel</firstname> 
+		  <surname>Sikkes</surname> 
+		  <affiliation> 
+			 <orgname>MATE Documentation Project</orgname> 
+			 <address> <email>[email protected]</email> </address> 
+		  </affiliation> 
+		</author> 
+		<author>
+		  <firstname>Davyd</firstname><surname>Madeley</surname>
+		  <affiliation>
+		    <orgname>MATE Project</orgname>
+		    <address><email>[email protected]</email></address>
+		  </affiliation>
+		</author>
+      <!-- This is appropriate place for other contributors: translators,
+           maintainers,  etc. Commented out by default.
+           <othercredit role="translator">
+	     <firstname>Michiel</firstname> 
+	     <surname>Sikkes</surname> 
+	     <affiliation> 
+	       <orgname>Latin Translation Team</orgname> 
+	       <address> <email>[email protected]</email> </address> 
+	     </affiliation>
+	     <contrib>Latin translation</contrib>
+           </othercredit>
+-->
+	 </authorgroup>
+	 
+	 <releaseinfo revision="2.26" role="review"/>
+	 
+	 <revhistory>
+	   <revision>
+	     <revnumber>Version 2.10</revnumber>
+	     <date>March 2005</date>
+	     <revdescription>
+	       <para role="author">Davyd Madeley</para>
+         <para role="publisher">MATE Documentation Project</para> 	       
+	     </revdescription>
+	   </revision>
+		<revision> 
+		  <revnumber>2.8 Applet Manual V&manrevision;</revnumber> 
+		  <date>July 2004</date> 
+		  <revdescription> 
+			 <para role="author">Michiel Sikkes</para> 
+			 <para role="publisher">MATE Documentation Project</para> 
+		  </revdescription> 
+		</revision>
+	  </revhistory>
+	 <releaseinfo> This manual describes version &appletversion; of the &applet; applet.
+		</releaseinfo>
+	 <legalnotice> 
+		<title>Feedback</title> 
+		<para> To report a bug or make a suggestion regarding the &applet; applet or this manual, follow the directions in the <ulink url="ghelp:user-guide?feedback" type="help">MATE Feedback Page</ulink>. </para>
+		
+	 </legalnotice> 
+  </articleinfo>
+  <indexterm> 
+	 <primary>Trash</primary> 
+  </indexterm>
+
+  <sect1 id="trash-introduction"> 
+	 <title>Introduction</title> 
+<para>
+The <application>&applet;</application> applet lets you manage your Trash from the panel.
+</para>
+<para>
+ The trash on your panel acts identically to the trash on your desktop, however it is useful because your panels are always visible.
+</para>
+
+<sect2 id="trash-introduction-add">
+<title>Adding &applet; to a Panel</title> 
+  <para>To add the <application>&applet;</application> applet to a panel, perform the following steps:</para>
+    <orderedlist>
+      <listitem>
+        <para>
+          Right-click on the panel at the place you want to add the applet.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Choose <guimenuitem>Add to Panel</guimenuitem>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Scroll down the list of items in the <guilabel>Add to Panel</guilabel> dialog, then select <guilabel>Trash</guilabel>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Click <guibutton>Add</guibutton>.
+        </para>
+      </listitem>
+    </orderedlist>
+  <para>For more information on working with the panel, see the <ulink type="help" url="ghelp:user-guide?panels">Desktop User Guide</ulink>.</para>
+
+</sect2>
+</sect1>
+
+<sect1 id="trash-usage">
+	<title>Usage</title>
+         <figure id="cpufreq-applet-figure">
+            <title>&applet;</title>
+                <screenshot>
+                  <mediaobject>
+                     <imageobject>
+                        <imagedata fileref="figures/trash-applet.png"
+                                   format="PNG"/>
+                     </imageobject>
+                  </mediaobject>
+               </screenshot>
+         </figure>
+
+	<sect2 id="trash-usage-moving">
+	<title>Moving Items to Trash</title>
+	<para>To move items to the Trash, drag them from the file manager to the <application>&applet;</application> applet.</para>
+	</sect2>
+
+	<sect2 id="trash-usage-emptying">
+	<title>Emptying Trash</title>
+	<para>To permanently delete all the items in the Trash, right-click on the applet, then choose
+		<menuchoice>
+		  <guimenuitem>Empty Trash</guimenuitem>
+		</menuchoice>.
+	</para>
+	</sect2>
+
+	<sect2 id="trash-usage-opening">
+	<title>Opening Trash</title>
+	<para>To open Trash, right-click on the applet, then choose
+		<menuchoice>
+		  <guimenuitem>Open</guimenuitem>
+		</menuchoice>. The Trash window opens in <application>Caja</application> file manager.
+	</para>
+	</sect2>
+</sect1>
+</article>