Moved from Mate-Extra repository

3 files changed, 441 insertions, 0 deletions

diff --git a/logview/help/C/figures/syslog_window.png b/logview/help/C/figures/syslog_window.png
new file mode 100644
index 00000000..6769063d
--- /dev/null
+++ b/logview/help/C/figures/syslog_window.png
diff --git a/logview/help/C/legal.xml b/logview/help/C/legal.xml
new file mode 100644
index 00000000..acb0b403
--- /dev/null
+++ b/logview/help/C/legal.xml
@@ -0,0 +1,76 @@
+  <legalnotice id="legalnotice">
+	<para>
+	  Permission is granted to copy, distribute and/or modify this
+	  document under the terms of the GNU Free Documentation
+	  License (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 type="help"
+	  url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
+	  distributed with this manual.
+         </para>
+         <para> This manual is part of a collection of MATE manuals
+          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 manual, 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/logview/help/C/mate-system-log.xml b/logview/help/C/mate-system-log.xml
new file mode 100644
index 00000000..11536ceb
--- /dev/null
+++ b/logview/help/C/mate-system-log.xml
@@ -0,0 +1,365 @@
+<?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 appversion "2.12">
+  <!ENTITY manrevision "2.4">
+  <!ENTITY date "October 2005">
+  <!ENTITY app "System Log Viewer">
+]>
+<!-- 
+      (Do not remove this comment block.)
+  Maintained by the MATE Documentation Project
+  http://developer.mate.org/projects/gdp
+  Template version: 2.0 beta
+  Template last modified Apr 11, 2002
+  
+-->
+<!-- =============Document Header ============================= -->
+<article id="index" lang="en">
+<!-- please do not change the id; for translations, change lang to -->
+<!-- appropriate code -->
+  <articleinfo> 
+    <title>&app; Manual</title>
+
+    <abstract role="description">
+      <para>System Log Viewer is a graphical user interface to view and monitor
+      system log files.</para>
+    </abstract>
+
+    <copyright> 
+      <year>2003</year> 
+      <holder>Sun Microsystems</holder> 
+    </copyright> 
+    <copyright> 
+      <year>2000</year> 
+      <holder>Judith Samson</holder> 
+    </copyright> 
+<!-- translators: uncomment this:
+
+  <copyright>
+   <year>2002</year>
+   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
+  </copyright>
+
+   -->
+    <publisher> 
+      <publishername> MATE Documentation Project </publishername> 
+    </publisher> 
+
+   &legal;
+
+   <authorgroup> 
+   <author> 
+		<firstname>Sun</firstname> 
+		<surname>MATE Documentation Team</surname> 
+		<affiliation> 
+	  	<orgname>Sun Microsystems</orgname> 
+	  	<address> <email>[email protected]</email> </address> 
+		</affiliation> 
+   </author> 
+
+   <author> 
+		<firstname>Judith</firstname> 
+		<surname>Samson</surname> 
+		<affiliation> 
+	  	<orgname>MATE Documentation Project</orgname> 
+	  	<address> <email>[email protected]</email> </address> 
+		</affiliation> 
+   </author> 
+   
+    <author> 
+		<firstname>Paul</firstname> 
+		<surname>Cutler</surname> 
+		<affiliation> 
+	  	<orgname>MATE Documentation Team</orgname> 
+	  	<address> <email>[email protected]</email> </address> 
+		</affiliation> 
+   </author> 
+
+   <author role="maintainer">
+   	<firstname>Vincent</firstname>
+	<surname>Noel</surname>
+	<affiliation>
+	  <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>Latin</firstname> 
+		<surname>Translator 1</surname> 
+		<affiliation> 
+	  	<orgname>Latin Translation Team</orgname> 
+	  	<address> <email>[email protected]</email> </address> 
+		</affiliation>
+		<contrib>Latin translation</contrib>
+   </othercredit>
+-->
+    </authorgroup>
+
+    <revhistory>
+            <revision> 
+		<revnumber>&app; Manual V2.5</revnumber> 
+		<date>October 2009</date> 
+		<revdescription> 
+	  		<para role="author">Paul Cutler
+	    		<email>[email protected]</email>
+	  		</para>
+	  		<para role="publisher">MATE Documentation Project</para>
+		</revdescription> 
+      </revision>
+      <revision> 
+		<revnumber>&app; Manual V2.4</revnumber> 
+		<date>October 2005</date> 
+		<revdescription> 
+	  		<para role="author">Vincent Noel
+	    		<email>[email protected]</email>
+	  		</para>
+	  		<para role="publisher">MATE Documentation Project</para>
+		</revdescription> 
+      </revision>
+      <revision> 
+		<revnumber>System Log Viewer Manual V2.3</revnumber> 
+		<date>October 2002</date> 
+		<revdescription> 
+	  		<para role="author">Sun MATE Documentation Team
+	    		<email>[email protected]</email>
+	  		</para>
+	  		<para role="publisher">MATE Documentation Project</para>
+		</revdescription> 
+      </revision>
+      <revision> 
+		<revnumber>System Log Viewer Manual V2.2</revnumber> 
+		<date>August 2002</date> 
+		<revdescription> 
+	  		<para role="author">Sun MATE Documentation Team
+	    		<email>[email protected]</email>
+	  		</para>
+	  		<para role="publisher">MATE Documentation Project</para>
+		</revdescription> 
+      </revision>
+      <revision> 
+		<revnumber>System Log Viewer Manual V2.1</revnumber> 
+		<date>July 2002</date> 
+		<revdescription> 
+	  		<para role="author">Sun MATE Documentation Team
+	    		<email>[email protected]</email>
+	  		</para>
+	  		<para role="publisher">MATE Documentation Project</para>
+		</revdescription> 
+      </revision>
+      <revision> 
+		<revnumber>System Log Viewer Manual V2.0</revnumber> 
+		<date>May 2002</date> 
+		<revdescription> 
+	  		<para role="author">Sun MATE Documentation Team
+	    		<email>[email protected]</email>
+	  		</para>
+	  		<para role="publisher">MATE Documentation Project</para>
+		</revdescription> 
+      </revision> 
+      <revision> 
+		<revnumber>Logview Manual</revnumber> 
+		<date>2000</date> 
+		<revdescription> 
+	  		<para role="author">Judith Samson
+	    		<email>[email protected]</email>
+	  		</para>
+	  		<para role="publisher">MATE Documentation Project</para>
+			</revdescription> 
+      </revision> 
+    </revhistory> 
+
+    <releaseinfo>This manual describes version &appversion; of &app;.
+    </releaseinfo> 
+    <legalnotice> 
+      <title>Feedback</title> 
+      <para>To report a bug or make a suggestion regarding the &app; application or
+	this manual, follow the directions in the 
+	<ulink url="ghelp:mate-feedback"
+	  type="help">MATE Feedback Page</ulink>. 
+      </para>
+<!-- Translators may also add here feedback address for translations -->
+    </legalnotice> 
+  </articleinfo> 
+
+  <indexterm> 
+    <primary>System Log Viewer</primary> 
+  </indexterm> 
+
+<!-- ============= Document Body ============================= -->
+<!-- ============= Introduction ============================== -->
+
+  <sect1 id="syslog-introduction"> 
+    <title>Introduction</title> 
+
+      <para>
+      <application>&app;</application> is a graphical, menu-driven
+      viewer that you can use to view and monitor your system
+      logs. <application>&app;</application> comes with a few functions that
+      can help you manage your logs, including a log monitor and log statistics
+      display.
+      </para>
+
+      <para>
+      <application>&app;</application> is useful if you are new to system
+      administration because it provides an easier, more user-friendly
+      display of your logs than a
+      text display of the log file. It is also useful for more
+      experienced administrators, as it contains a monitor to enable you
+      to continuously monitor crucial logs.
+      </para>
+
+      <warning><para><application>&app;</application> is useful only to those
+      who have access to the system log files, which generally requires root
+      access.</para></warning>
+
+  </sect1>
+
+  <sect1 id="syslog-getting-started">
+    <title>Getting Started</title> 
+
+    <para>You can start <application>&app;</application> in the following ways:
+    </para> 
+    <variablelist>
+    	<varlistentry>
+    		<term><guimenu>Applications</guimenu> menu</term>
+    		<listitem>
+    		<para>Choose <menuchoice><guisubmenu>System Tools</guisubmenu><guimenuitem>Log File Viewer</guimenuitem></menuchoice>.</para>
+    		</listitem>
+    	</varlistentry>
+    	<varlistentry>
+    		<term>Command line</term>
+    		<listitem>
+    		<para>Type <command>mate-system-log</command>, then press <keycap>Return</keycap>.</para>
+    		<para> 		 
+    		</para> 
+    		</listitem>
+    	</varlistentry>
+    </variablelist>
+
+    <para>When you start <application>&app;</application>, the following window is displayed.</para>
+
+    <!-- ==== Figure ==== -->
+      <figure id="syslog-fig"> 
+	<title>&app; Window</title> 
+	<screenshot> 
+	  <mediaobject> 
+	    <imageobject>
+	    <imagedata fileref="figures/syslog_window.png" format="PNG"/> 
+	    </imageobject>
+	    <textobject> 
+	      <phrase>Shows &app; main window. Contains menubar, display area, scrollbars, and statusbar. </phrase> 
+	    </textobject> 
+	  </mediaobject> 
+	</screenshot> 
+      </figure>
+    <!-- ==== End of Figure ==== -->
+    <para>The first time you start <application>&app;</application>, the application
+      displays several log files by default (such as
+      <filename>/var/log/messages</filename>).
+      Opened logs are listed on the left side of the 
+      application window. The log selected in this list is displayed in the
+      main area of the application window.
+      </para>
+
+      <para>By default, <application>&app;</application>
+        monitors every opened log, and any change appears automatically in the
+        main window. See <xref linkend="syslog-monitor"/> for more information.</para>
+
+  </sect1>
+
+<!-- ================ Usage ================================ -->
+
+  <sect1 id="syslog-usage"> 
+    <title>Usage</title>
+
+    <sect2 id="syslog-open">
+    	<title>To View a Log</title>
+    	<para>To view a log, choose <menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>. 
+    	In the <guilabel>Open Log</guilabel> dialog, select the 
+        log that you want to open, then click 
+    	<guibutton>Open</guibutton>. Use the scrollbars to scroll through the
+    	log.</para>
+
+        <para>You can open as many logs as you
+        want. <application>&app;</application> displays one log at a time in 
+    	the <guilabel>System Log Viewer</guilabel> window. Opened logs are listed on the left side of the
+        application window. The log selected in this list is displayed in the
+        main area of the application window. To display another log
+        already opened in <application>&app;</application>, select it in the
+        log list.</para>
+
+        <para>Note that <application>&app;</application> also lets you open
+    zipped logs (whole filenames end in ".gz").</para>
+    </sect2>
+
+    <sect2 id="syslog-selection">
+    <title>To Copy Log Lines to the Clipboard</title>
+    <para>To copy one or more log lines to the clipboard, just select the lines in
+    the main area and choose the 
+    <menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice>
+    menu option.
+    If you want to copy the entire log to the clipboard, select it entirely
+    using the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Select
+    All</guimenuitem></menuchoice> menu option, then choose
+    <menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice>.
+    </para>
+    </sect2>
+
+    <sect2 id="syslog-hide-sidebar">
+    <title>To Hide the Sidebar</title>
+    <para>To hide the left sidebar, which contains the log list and calendar,
+    just select the
+    <menuchoice><guimenu>View</guimenu><guimenuitem>Side pane</guimenuitem></menuchoice>
+    menu option.</para>
+    </sect2>
+    
+    <sect2 id="syslog-monitor">
+    	<title>To Monitor Logs</title>
+    	<para>You can use <application>&app;</application> to monitor
+    	logs. By default, all logs opened in <application>&app;</application>
+        are monitored for changes. If new lines are added to a log monitored
+        by <application>&app;</application>, the log name will appear in bold in
+        the log list. If the log is currently displayed in the main area, the
+        new lines will appear automatically at the end of the log and, after five
+    	seconds, the log name will turn back to normal in the list.</para>
+
+    </sect2>
+    
+    <sect2 id="syslog-stats">
+    	<title>To View Log Information</title>
+    	<para>Log information are generally displayed in the status bar,
+    	including :</para> 
+    	<itemizedlist>
+    		<listitem><para>Number of lines in the log.</para>
+    		</listitem>
+    		<listitem><para>Size of the log in bytes.</para>
+    		</listitem>
+    		<listitem><para>Date the log was last modified.</para>
+    		</listitem>
+    	</itemizedlist> 
+        <para>The status bar can be displayed or hidden using the
+          <menuchoice><guimenu>View</guimenu><guimenuitem>Statusbar</guimenuitem></menuchoice>
+          option.</para>
+    </sect2>
+    
+    <sect2 id="syslog-close">
+    	<title>To Close a Log</title>
+    	<para>To close a log, choose
+    	<menuchoice><guimenu>File</guimenu><guimenuitem>Close</guimenuitem></menuchoice>.
+    	</para>
+    </sect2>
+    
+    <sect2 id="syslog-exit">
+    	<title>To Exit &app;</title>
+    	<para>To exit <application>&app;</application>, choose
+    	<menuchoice><guimenu>File</guimenu><guimenuitem>Quit</guimenuitem></menuchoice>.
+    	</para>
+    </sect2>
+ 
+  </sect1>
+
+</article>