summaryrefslogtreecommitdiff
path: root/netspeed/help/C
diff options
context:
space:
mode:
authormonsta <[email protected]>2015-12-11 13:43:46 +0300
committermonsta <[email protected]>2015-12-14 16:41:47 +0300
commit8aabf4f0797f7cb4a56b194b66b7c41537fcbc69 (patch)
tree4a8ced2d14dbb2e39cca6e7af7d12d8ef9554406 /netspeed/help/C
parent33c414812425341777454444904cecf8a525c13a (diff)
downloadmate-applets-8aabf4f0797f7cb4a56b194b66b7c41537fcbc69.tar.bz2
mate-applets-8aabf4f0797f7cb4a56b194b66b7c41537fcbc69.tar.xz
merge netspeed applet from mate-netspeed repo
Diffstat (limited to 'netspeed/help/C')
-rw-r--r--netspeed/help/C/figures/details.pngbin0 -> 19507 bytes
-rw-r--r--netspeed/help/C/figures/eth_sum_48.pngbin0 -> 1391 bytes
-rw-r--r--netspeed/help/C/figures/ethernet.pngbin0 -> 716 bytes
-rw-r--r--netspeed/help/C/figures/loopback.pngbin0 -> 179 bytes
-rw-r--r--netspeed/help/C/figures/netspeed_applet.pngbin0 -> 2200 bytes
-rw-r--r--netspeed/help/C/figures/plip.pngbin0 -> 284 bytes
-rw-r--r--netspeed/help/C/figures/ppp.pngbin0 -> 589 bytes
-rw-r--r--netspeed/help/C/figures/settings.pngbin0 -> 20647 bytes
-rw-r--r--netspeed/help/C/figures/wavelan.pngbin0 -> 353 bytes
-rw-r--r--netspeed/help/C/index.docbook359
-rw-r--r--netspeed/help/C/legal.xml76
11 files changed, 435 insertions, 0 deletions
diff --git a/netspeed/help/C/figures/details.png b/netspeed/help/C/figures/details.png
new file mode 100644
index 00000000..b8f6b8be
--- /dev/null
+++ b/netspeed/help/C/figures/details.png
Binary files differ
diff --git a/netspeed/help/C/figures/eth_sum_48.png b/netspeed/help/C/figures/eth_sum_48.png
new file mode 100644
index 00000000..b92a1727
--- /dev/null
+++ b/netspeed/help/C/figures/eth_sum_48.png
Binary files differ
diff --git a/netspeed/help/C/figures/ethernet.png b/netspeed/help/C/figures/ethernet.png
new file mode 100644
index 00000000..7464d15a
--- /dev/null
+++ b/netspeed/help/C/figures/ethernet.png
Binary files differ
diff --git a/netspeed/help/C/figures/loopback.png b/netspeed/help/C/figures/loopback.png
new file mode 100644
index 00000000..c363490f
--- /dev/null
+++ b/netspeed/help/C/figures/loopback.png
Binary files differ
diff --git a/netspeed/help/C/figures/netspeed_applet.png b/netspeed/help/C/figures/netspeed_applet.png
new file mode 100644
index 00000000..1fcc1308
--- /dev/null
+++ b/netspeed/help/C/figures/netspeed_applet.png
Binary files differ
diff --git a/netspeed/help/C/figures/plip.png b/netspeed/help/C/figures/plip.png
new file mode 100644
index 00000000..44a74852
--- /dev/null
+++ b/netspeed/help/C/figures/plip.png
Binary files differ
diff --git a/netspeed/help/C/figures/ppp.png b/netspeed/help/C/figures/ppp.png
new file mode 100644
index 00000000..e819577a
--- /dev/null
+++ b/netspeed/help/C/figures/ppp.png
Binary files differ
diff --git a/netspeed/help/C/figures/settings.png b/netspeed/help/C/figures/settings.png
new file mode 100644
index 00000000..d29960de
--- /dev/null
+++ b/netspeed/help/C/figures/settings.png
Binary files differ
diff --git a/netspeed/help/C/figures/wavelan.png b/netspeed/help/C/figures/wavelan.png
new file mode 100644
index 00000000..9bbe4665
--- /dev/null
+++ b/netspeed/help/C/figures/wavelan.png
Binary files differ
diff --git a/netspeed/help/C/index.docbook b/netspeed/help/C/index.docbook
new file mode 100644
index 00000000..54ee8528
--- /dev/null
+++ b/netspeed/help/C/index.docbook
@@ -0,0 +1,359 @@
+<?xml version="1.0"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY legal SYSTEM "legal.xml">
+ <!ENTITY appletversion "1.10.1">
+ <!ENTITY manrevision "1.3">
+ <!ENTITY date "July 2015">
+ <!ENTITY applet "Netspeed Applet">
+]>
+
+<!--
+ (Do not remove this comment block.)
+ Maintained by the GNOME Documentation Project
+ http://wiki.mate-desktop.org/dev-doc:doc-team-guide
+ Template version: 2.0 beta
+ Template last modified Mar 12, 2002
+
+-->
+
+<article id="index" lang="en">
+<!-- please do not change the id; for translations, change lang to -->
+<!-- appropriate code -->
+ <articleinfo>
+ <title>&applet; Manual V&manrevision;</title>
+ <abstract role="description">
+ <para>&applet; is shows how much traffic occurs on a specified network device.</para>
+ </abstract>
+ <copyright>
+ <year>2015</year>
+ <holder>MATE Documentation Project</holder> </copyright>
+ <copyright>
+ <year>2002</year>
+ <holder>Jörgen Scheibengruber</holder>
+ </copyright>
+<!-- translators: uncomment this:
+
+ <copyright>
+ <year>2002</year>
+ <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
+ </copyright>
+
+-->
+ <publisher role="maintainer">
+ <publishername> MATE Documentation Project </publishername>
+ </publisher>
+ <publisher>
+ <publishername>GNOME Documentation Project</publishername>
+ </publisher>
+
+ &legal;
+
+ <authorgroup>
+ <author role="maintainer">
+ <firstname>MATE Documentation Project</firstname>
+ <surname></surname>
+ <affiliation>
+ <orgname>MATE Desktop</orgname>
+ </affiliation>
+ </author>
+ <author>
+ <firstname>Jörgen</firstname>
+ <surname>Scheibengruber</surname>
+ <affiliation>
+ <orgname>GNOME Project</orgname>
+ </affiliation>
+ <email>[email protected]</email>
+ </author>
+
+ <author>
+ <firstname>Pedro</firstname>
+ <surname>Villavicencio Garrido</surname>
+ <affiliation>
+ <orgname>GNOME Project</orgname>
+ </affiliation>
+ <email>[email protected]</email>
+ </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>1.3</revnumber>
+ <date>July 2015</date>
+ <author>
+ <firstname>MATE Documentation Project</firstname>
+ <surname></surname>
+ </author>
+ </revision>
+
+ <revision>
+ <revnumber>1.2</revnumber>
+ <date>2006</date>
+ <author>
+ <firstname>Jörgen</firstname>
+ <surname>Scheibengruber</surname>
+ <email>[email protected]</email>
+ </author>
+ </revision>
+
+ <revision>
+ <revnumber>1.1</revnumber>
+ <date>2005</date>
+ <author>
+ <firstname>Pedro</firstname>
+ <surname>Villavicencio Garrido</surname>
+ <email>[email protected]</email>
+ </author>
+ </revision>
+
+ <revision>
+ <revnumber>1.0</revnumber>
+ <date>2002</date>
+ <author>
+ <firstname>Jörgen</firstname>
+ <surname>Scheibengruber</surname>
+ <email>[email protected]</email>
+ </author>
+ </revision>
+
+ </revhistory>
+
+ <releaseinfo> This manual describes version &appletversion; of &applet;.
+ </releaseinfo>
+ <legalnotice>
+ <title>Feedback</title>
+ <para>
+ To report a bug or make a suggestion regarding the &applet; application or this manual, follow the directions in the <ulink url="help:mate-user-guide/feedback" type="help">MATE Feedback Page</ulink>.
+ </para>
+
+<!-- Translators may also add here feedback address for translations -->
+
+ </legalnotice>
+ </articleinfo>
+ <indexterm>
+ <primary>&applet;</primary>
+ </indexterm>
+
+<!-- ============= Document Body ============================= -->
+<sect1 id="netspeed_applet-about">
+<title>About &applet;</title>
+ <figure id="netspeed_applet-fig">
+ <title>Netspeed</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject><imagedata fileref="figures/netspeed_applet.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Netspeed.</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ <figure id="netspeed_applet-fig2">
+ <title>Netspeed showing the sum in a 48px panel.</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject><imagedata fileref="figures/eth_sum_48.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Netspeed showing the sum in a 48px panel.</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ <para>
+ <application>&applet;</application> displays the network traffic on a specified device
+ like eth0, ppp0, plip0, etc. More over it provides information about the configuration
+of the network device.
+ </para>
+ <sect2 id="netspeed-introduction-icons">
+ <title>Netspeed Icons on Panel</title>
+ <informaltable frame="all">
+ <tgroup cols="2" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="50*"/>
+ <colspec colname="COLSPEC1" colwidth="50*"/>
+ <thead>
+ <row valign="top">
+ <entry colname="COLSPEC0"><para>Icon</para></entry>
+ <entry colname="COLSPEC1"><para>Description</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry><para>
+ <inlinemediaobject><imageobject>
+ <imagedata fileref="figures/loopback.png" format="PNG"/>
+ </imageobject><textobject>
+ <phrase>Loopback</phrase>
+ </textobject></inlinemediaobject>
+ </para></entry>
+ <entry><para>
+ The Loopback interface.
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>
+ <inlinemediaobject><imageobject>
+ <imagedata fileref="figures/ethernet.png" format="PNG"/>
+ </imageobject><textobject>
+ <phrase>Ethernet</phrase>
+ </textobject></inlinemediaobject>
+ </para></entry>
+ <entry><para>
+ Ethernet connection.
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>
+ <inlinemediaobject><imageobject>
+ <imagedata fileref="figures/ppp.png" format="PNG"/>
+ </imageobject><textobject>
+ <phrase>PPP</phrase>
+ </textobject></inlinemediaobject>
+ </para></entry>
+ <entry><para>
+ Point to Point Protocol connection.
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>
+ <inlinemediaobject><imageobject>
+ <imagedata fileref="figures/wavelan.png" format="PNG"/>
+ </imageobject><textobject>
+ <phrase>Wireless</phrase>
+ </textobject></inlinemediaobject>
+ </para></entry>
+ <entry><para>
+ Wireless connection.
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>
+ <inlinemediaobject><imageobject>
+ <imagedata fileref="figures/plip.png" format="PNG"/>
+ </imageobject><textobject>
+ <phrase>PLIP</phrase>
+ </textobject></inlinemediaobject>
+ </para></entry>
+ <entry><para>
+ Parallel Line Internet Protocol connection.
+ </para></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </sect2>
+ <sect2>
+ <title>To Add Netspeed to a Panel</title>
+ <para>To add <application>&applet;</application> to a panel, right-click on the panel, then choose <menuchoice>
+ <guimenu>Add to Panel</guimenu>
+ <guisubmenu>Network</guisubmenu>
+ <guimenuitem>&applet;</guimenuitem>
+ </menuchoice>.</para>
+ </sect2>
+ </sect1>
+ <sect1 id="netspeed_applet-settings">
+ <title>Settings</title>
+ <figure id="netspeed_applet_settings-fig">
+ <title>&applet; Settings</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject><imagedata fileref="figures/settings.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&applet; Settings.</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ <para>
+ In this dialog you can change the settings of &applet;:
+ </para>
+ <itemizedlist mark="bullet">
+ <listitem><para>
+ <guilabel>Network device:</guilabel> Choose the network device that the applet should monitor from the
+ popdown list of the combobox. Usually all available devices are listed, however you can enter one yourself, too.
+ </para></listitem>
+ <listitem><para>
+ <guilabel>Update interval:</guilabel> Enter the time between two updates of the applet.
+ </para></listitem>
+ <listitem><para>
+ <guilabel>Label font size:</guilabel> Enter the size of the text displayed in the applet.
+ </para></listitem>
+ <listitem><para>
+ <guilabel>Show sum instead of in and out:</guilabel> If you check this box then the applet will show
+ the sum of the in and out rate. The applet will take only half of the space in the panel in this case.
+ </para></listitem>
+ <listitem><para>
+ <guilabel>Show bits/s (b/s) instead of bytes/s (B/s):</guilabel> Check this if you want the applet to
+ display bits per second instead of bytes/s.
+ </para></listitem>
+ <listitem><para>
+ <guilabel>Change icon according to the selected device:</guilabel> Usually the applet will show an icon
+ representing the type of network device you monitor. So it will show a phone for Point to Point connections
+ (ppp - modems, etc.), a network card for ethernet (eth), etc.
+ When this is unchecked, the applet will always show the network card icon, no matter which device you monitor.
+ </para></listitem>
+ <listitem><para>
+ <guilabel>Always monitor a connected device, if possible:</guilabel> When your connection is down, &applet; look for a running one for monitoring.
+ </para></listitem>
+ </itemizedlist>
+ </sect1>
+ <sect1 id="netspeed_applet-details">
+ <title>The details dialog</title>
+ <figure id="netspeed_applet_details-fig">
+ <title>The details dialog</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject><imagedata fileref="figures/details.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>The details dialog</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ <para>
+ This dialog shows you some useful information on the configuration of
+ your network device.
+ </para>
+ <itemizedlist mark="bullet">
+ <listitem><para>
+ <guilabel>Internet Address:</guilabel> The IP (Internet Protocol) address of the network device.
+ </para></listitem>
+ <listitem><para>
+ <guilabel>Netmask:</guilabel> The netmask which depends on the size of your LAN (Local Area Network).
+ A usual value is 255.255.255.0 (a class C network).
+ </para></listitem>
+ <listitem><para>
+ <guilabel>Hardware Address:</guilabel> Often also referred to as the physical or MAC (Media Access Control)
+ address. A worldwide unique identifier for your network card.
+ </para></listitem>
+ <listitem><para>
+ <guilabel>P-t-P Address:</guilabel> The internet address of the "other side" of your
+ PPP (Point to Point Protocol) connection.
+ </para></listitem>
+ <listitem><para>
+ <guilabel>Bytes in:</guilabel> The amount of bytes that the network device has received since
+ it has been connected to the network.
+ </para></listitem>
+ <listitem><para>
+ <guilabel>Bytes out:</guilabel> The amout of bytes that the network device has sent since
+ it has been connected to the network.
+ </para></listitem>
+ </itemizedlist>
+ </sect1>
+</article>
diff --git a/netspeed/help/C/legal.xml b/netspeed/help/C/legal.xml
new file mode 100644
index 00000000..899282c3
--- /dev/null
+++ b/netspeed/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="help:fdl">link</ulink> or in the file COPYING-DOCS
+ distributed with this manual.
+ </para>
+ <para> This manual is part of a collection of GNOME 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 GNOME documentation, and the members of
+ the GNOME 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>
+