<!DOCTYPE article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[

<!ENTITY version "1.4">
     
]>



<!-- =============Document Header ============================= -->

<article id="index">

 <artheader>
  <title>Gw Manual</title>
  <copyright>
   <year>2000</year>
   <holder>John Fleck</holder>
  </copyright>

  <!-- translators: uncomment this:

  <copyright>
   <year>2000</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->

 

    <legalnotice id="legalnotice">
      <para>Permission is granted to copy, distribute and/or modify this document
	under the terms of the <ulink type="help"
	url="gnome-help:fdl"><citetitle>GNU Free Documentation
	    License</citetitle></ulink>, 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.  A copy of the license
	can be found <ulink type="help" url="gnome-help:fdl">here</ulink>.
      </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 those trademarks are made aware to the members
	of the GNOME Documentation Project, the names have been printed in caps
	or initial caps.
      </para>
    </legalnotice>

  <releaseinfo>
  This is version 1.1 of Gw manual.
  </releaseinfo>

 </artheader>

 <!-- ============= Document Body ============================= -->

 <!-- ============= Introduction ============================== -->
 <sect1 id="intro">
  <title>Introduction</title>

  <para>
   <application>Gw</application> displays a listing of all the users
   currently logged onto your machine, along with information about
   what they're up to. It also gives you the ability to communicate
   with them.</para>

  <para>
   To run <application>Gw</application>, select
   <guimenuitem>User Listing</guimenuitem> from the
   <guisubmenu>System</guisubmenu> submenu of the <guimenu>Main
   Menu</guimenu>, or type <command>gw</command> on the
   command line. 
  </para>

  <para>
   <application>Gw</application> is included in the
   <filename>GNOME-utils</filename> package, which is part of the
   GNOME desktop environment. This document describes version
   &version; of <application>Gw</application>.
  </para>

 </sect1>


 <!-- ================ Usage ================================ -->

 <sect1 id="usage">
  <title>Using Gw</title>
  <para>
   <application>Gw</application> can be
   used to monitor users on your system, and to communicate with them.
  </para>

  <!-- ========= Basic Usage =========================== -->
  <sect2 id="mainwin">
   <title>Basic usage</title>
   <para>
    Starting <application>Gw</application> opens 
    the <interface>Main window</interface>, shown in <xref
    linkend="mainwindow-fig">.

    <!-- ==== Figure ==== -->
    <figure id="mainwindow-fig">
     <title>Gw Main Window</title>
     <screenshot>
      <screeninfo>Gw Main Window</screeninfo>
      <graphic fileref="figures/gw-main" format="png"
       srccredit="John Fleck">
      </graphic>
     </screenshot>
    </figure>
    <!-- ==== End of Figure ==== -->
   </para>

      <para>On launch, <application>Gw</application> displays a
      listing of all users.</para>

      <para>To update the data, click on the <guibutton>Update
      Information</guibutton> button.</para>

      <para>The data displayed includes:
        <itemizedlist>

	  <listitem>
	    <para><guilabel>USER</guilabel> &mdash; user's login
	    name.</para>
	  </listitem>

          <listitem>
	    <para><guilabel>TTY</guilabel> &mdash; the terminal the
	    user is connected through.</para>
	  </listitem>

          <listitem>
	    <para><guilabel>FROM</guilabel> &mdash; The remote host
	    from which the user logged in, or the X display terminal
	    if the user is local.</para>
	  </listitem>
          <listitem>
	    <para><guilabel>LOGIN@</guilabel> &mdash; The time the
	    user logged in.</para>
	  </listitem>

          <listitem>
	    <para><guilabel>IDLE</guilabel> &mdash; The amount of idle
	    CPU time associated with that login.</para>
	  </listitem>

          <listitem>
	    <para><guilabel>JCPU</guilabel> &mdash; The CPU time used by
	    all processes associated with the login.</para>
	  </listitem>
          <listitem>
	    <para><guilabel>PCPU</guilabel> &mdash; The CPU time
	    associated with the process listed in the
	    <guilabel>WHAT</guilabel> field.</para>
	  </listitem>

           <listitem>
	    <para><guilabel>WHAT</guilabel> &mdash; The command
	    currently being executed by the user.</para>
	  </listitem>

	</itemizedlist>

</para>

  
 
   <tip>
    <title>Update</title>
    <para>
     <application>Gw</application> does not update its statistics
     automatically. You must click on the <guibutton>Update
     Information</guibutton> to have the program display the latest
     information.
    </para>
   </tip>

  </sect2>


  

  <!-- ========= Menus =========================== -->
  <sect2 id="menubar">
   <title>Menus</title>
   <para>
    The menu bar, located at the top of the <interface>Main
    Window</interface>, contains the following menus:
   </para>

   <variablelist>
    <varlistentry>
     <term><guimenu>File</guimenu></term>
     <listitem>
      <para>
       This menu contains:
       <menuchoice>
        <shortcut>
         <keysym>Ctrl-Q</keysym>
        </shortcut>
        <guimenuitem>Quit</guimenuitem>
       </menuchoice>
       which exits the program.
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term><guimenu>Settings</guimenu></term>
     <listitem>
      <para>
       This menu contains:
     
<link linkend="prefs">
       <menuchoice>
        <shortcut>
         <keysym>Ctrl-P</keysym>
        </shortcut>
          <guimenuitem>Preferences</guimenuitem>
	      </menuchoice></link>
           which opens a dialog box allowing you to set
           up a menu executing other commands, such as
           <application>talk</application>,  through
           <application>Gw's</application> interface to communicate
	      with others users on the machine. For more information on
	      <application>talk</application>, see the <ulink type="man"
	      url="man:talk">talk man page</ulink>.
         </para>
        </listitem>
       
    </varlistentry>

   

    <varlistentry>
     <term><guimenu>Help</guimenu></term>
     <listitem>
      <para>
       This menu contains:
       <itemizedlist>
        <listitem>
         <para>
          <guimenuitem>Help</guimenuitem> &mdash;
          shows this manual.
         </para>
        </listitem>

        <listitem>
         <para>
          <guimenuitem>About</guimenuitem> &mdash; shows
          basic information about
          <application>Gw</application>, such as
          the author's name and the application version number.
         </para>
        </listitem>
       </itemizedlist>

      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </sect2>
 </sect1>


 <!-- ============= Customization ============================= -->
 <sect1 id="prefs">
  <title>Customization</title>
    <para>By right-clicking on <application>Gw's</application> main
    window, you can bring up a pop-up menu of commands to be used for
    communicating with other users. But before you can do that, you
    need to configure the program's preferences settings to set up the
    menu.</para>

    <para>To do that, select
   <guimenuitem>Preferences&hellip;</guimenuitem> from the
   <guimenu>Settings</guimenu> menu. This opens the
   <interface>Menu items</interface> dialog, shown in <xref
   linkend="preferences-fig">.
  </para>

  <figure id="preferences-fig">
   <title>Preferences Dialog</title>
   <screenshot>
    <screeninfo>Preferences dialog</screeninfo>
    <graphic fileref="figures/gw-menuitems" format="png"
     srccredit="John Fleck">
    </graphic>
   </screenshot>
  </figure>

    <para>The main window pane of the <guilabel>Menu items</guilabel>
    window contains a listing the commands you'll see on the
    right-click menu. If the pane is empty, click on the
    <guibutton>Add some defaults </guibutton> button to fill in a list
    of basic commands useful in this situation.</para>

    <para>Each command has a <guilabel>Name</guilabel> field and a
    <guilabel>Command Line</guilabel> field. The
    <guilabel>Name</guilabel> is the word that will appear on the
    right-click menu in <application>GW's</application> main
    window. The <guilabel>Command Line</guilabel> field is the command
    that will be executed.</para>

    <para>For example, the predefined <command>talk</command> command,
    one of the defaults included when you click on <guibutton>Add some
    defaults</guibutton>, works this way: In
    <application>Gw's</application> main window, click on the name of
    the person you want to <application>talk</application> with, then
    right-click in <application>Gw's</application> main window and
    click on the <menuchoice>
	<guimenuitem>talk</guimenuitem>
      </menuchoice> menu item. <application>Gw</application> will
    execute the <command>talk</command> command,
    opening up an <application>xterm</application> and commencing a
    talk session with the user and terminal you had selected in the
    main window.
</para>

    <para>To add a command, click <guibutton>add</guibutton> and type
    in the command name and command in the text boxes at the top of
    the window. To delete a command, click on the command you want to
    delete, then the <guibutton>delete</guibutton> button.</para>

   
    <para>
    After you have made all the changes you want, click on
    <guibutton>Apply</guibutton> to apply the changes, or
    <guibutton>OK</guibutton> to apply the changes and close the
    <interface>Properties</interface> dialog. To cancel the changes
    and return to previous values, click the
    <guibutton>Close</guibutton> button.</para>

  </sect1>


<!-- ============= Authors ================================ -->

 <sect1 id="authors">
  <title>Authors</title>
  <para>
   <application>Gw</application> was written by Havoc Pennington
   (<email>hp@redhat.com</email>). Please send all comments,
   suggestions, and bug reports to the <ulink
   url="http://bugzilla.gnome.org" type="http">GNOME bug tracking
   database</ulink>. (Instructions for submitting bug reports can be
   found <ulink url="http://bugs.gnome.org/Reporting.html" type="http">
   on-line</ulink>.) If you are using
   GNOME 1.1 or later, you can also use <application>Bug Report
   Tool</application> (<command>bug-buddy</command>), available in the
   <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
   Menu</guimenu>, for submitting bug reports.
  </para>

  <para>
   This manual was written by John Fleck
   (<email>jfleck@inkstain.net</email>). Please send all comments and
   suggestions regarding this manual to the <ulink type="http"
   url="http://developer.gnome.org/projects/gdp">GNOME Documentation Project</ulink> 
   by sending an email to <email>docs@gnome.org</email>. You can also
   add your comments online by using the <ulink type="http"
   url="http://developer.gnome.org/projects/gdp/doctable/">GNOME Documentation Status
   Table</ulink>.
  </para>

 

 </sect1>


 <!-- ============= Application License ============================= -->

 <sect1 id="license">
  <title>License</title>
  <para>
   This program is free software; you can redistribute it and/or
   modify it under the terms of the <ulink url="gnome-help:gpl">
      GNU General Public License</ulink> as published by the Free Software Foundation;
   either version 2 of the License, or (at your option) any later
   version.
  </para>
  <para>
   This program is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   <citetitle>GNU General Public License</citetitle> for more details.
  </para>
  <para>
   You may obtain a copy of the
   <citetitle>GNU General Public License</citetitle> from the Free
   Software Foundation by visiting <ulink type="http"
   url="http://www.fsf.org">their Web site</ulink> or by writing to
   <address>
    Free Software Foundation, Inc.
    <street>59 Temple Place</street> - Suite 330
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
    <country>USA</country>
   </address>
  </para>
 </sect1>
</article>




