<!DOCTYPE article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
        
<!ENTITY version "1.2">
       
]>


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



<article id="index">

  <artheader> 
    <title>Guname 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.0 of Guname manual.
  </releaseinfo>

 </artheader>

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

 <!-- ============= Introduction ============================== -->
 <sect1 id="intro">
  <title>Introduction</title>
    <para>
      <application>Guname</application> displays a variety of
      basic information about your system.
    </para>
 

  <para>
   To run <application>Guname</application>, select
   <guimenuitem>System info...</guimenuitem> from the
   <guisubmenu>System</guisubmenu> submenu of the <guimenu>Main
   Menu</guimenu>, or type <command>guname</command> on the
   command line. 
  </para>

  <para>
   <application>Guname</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>Guname</application>.
  </para>

 </sect1>


 <!-- ================ Usage ================================ -->
 <!-- This section should describe basic usage of the application. -->

 <sect1 id="usage">
  <title>Using Guname</title>
 
 <para><application>Guname</application> displays a variety of
    basic information about your system. This section describes basic usage of
    <application>Guname</application>.
    </para>
  <!-- ========= Basic Usage =========================== -->
  <sect2 id="mainwin">
   <title>Basic usage</title>
   <para>
    Starting <application>Guname</application> opens 
    the <interface>Main window</interface>, shown in <xref
    linkend="mainwindow-fig">.

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

    <para>
	In the main window, <application>Guname</application> shows
	the operating system distribution your computer uses, the
	operating system, the distribution version, the operating
	system version, the operating system release, the processor
	type, the host name, the name of the user who invoked
	<application>Guname</application>, the name of the X display
	and the status of the system: up time (the length of time
	since your computer was last booted), the current number of
	users and three numbers representing "load" - the average
	number of processes running on your computer over the last
	minute (the first load number), the last five minutes and the
	last fifteen minutes.
      </para>

  

      <para>The main window includes a text box that scrolls
      through a list of the many contributors to the GNOME
      project.</para>

      <para>The main window also includes three buttons that allow you
      to take further action:<link linkend="detailed-information">
 <guibutton>Detailed
      Information...</guibutton></link>, <link
      linkend="saveormail"><guibutton>Save Information to
      File...</guibutton></link>, and <link
      linkend="saveormail"><guibutton>Email
      Information</guibutton></link>.</para>
   

  </sect2>

    <sect2 id="detailed-information">
      <title>Detailed Information</title>
      <para>The <guilabel>Detailed Information window</guilabel>
      provides data on disk usage, memory and your CPU.</para>
      
      <sect3 id="diskinfo">
	<title>Disk Information</title>
	

	<figure id="diskinfo-fig">
	  <title>Disk Information</title>
	  <screenshot>
	    <screeninfo>Disk Information</screeninfo>
	    <graphic fileref="figures/guname-diskinfo" format="png"
		     srccredit="John Fleck">
    </graphic>
	  </screenshot>
	</figure>
	<para>In the <guilabel>Disk Information</guilabel> window,
	<application>Guname</application> provides an accounting of
	the amount of space on each of your filesystems and how it is
	allocated.</para>

	<para>You'll see a box for each of the mounted disk drives
      and/or disk partitions on your computer. The position of the
      display bar and the numbers above and to the left of it indicate
      the amount of space used and available on the disk, and who the
      space is allocated to.</para>

      <para>The label at the top of each box identifies the drive
      or partition it's measuring. <filename>/dev/hda1</filename>, for
      example, measures the first partition on the first hard drive
      (hda). <filename>/dev/fd0</filename> indicates it's the first
      floppy disk. Other identifiers can include
      <filename>/dev/sda</filename>, for the first
      <acronym>SCSI</acronym> hard drive, and
      <filename>/dev/sga</filename> for the first generic
      <acronym>SCSI</acronym> device.</para>
     
      </sect3>

      <sect3 id="memory-information">
	     <title>Memory Information</title>
	     <figure id="memoryinfo-fig">
	  <title>Memory Information</title>
	<screenshot>
	  <screeninfo>Memory  Information</screeninfo>
	  <graphic fileref="figures/guname-memoryinfo" format="png"
		   srccredit="John Fleck">
    </graphic>
	</screenshot>
      </figure>
	<para>The <guilabel>Memory Information</guilabel> window
	provides details on how much memory your computer has, and how
	it is allocated, including the amount currently in use.</para>

      </sect3>

      <sect3 id="CPU-information">
	     <title>CPU Information</title>
	     <figure id="cpuinfo-fig">
	  <title>CPU Information</title>
	<screenshot>
	  <screeninfo>CPU Information</screeninfo>
	  <graphic fileref="figures/guname-cpuinfo" format="png"
		   srccredit="John Fleck">
    </graphic>
	</screenshot>
      </figure>
	<para>The <guilabel>CPU Information</guilabel> window tells
	what kind of processor your computer has, who made it, how
	fast it goes and other details about its operation.</para>

      </sect3>

      <sect3 id="saveormail">
	<title>Saving or Mailing Information</title>
	<para><application>Guname's</application> main window gives
	you two ways to save information for later use.</para>
	
	<para>Clicking on the <guibutton>Save Information to
	File...</guibutton> button opens a standard save window,
	prompting you for the name and directory location in which to
	save the file. <application>Guname</application> then saves a
	text file with all the basic information contained in the
	application's main window.</para>

	<para>Guname also offers the option of emailing the system
	information. Clicking on the <guibutton>Email
	Information...</guibutton> button opens a dialog box prompting
	you for the email address to which you'd like the information
	sent.</para>

      </sect3>

</sect2>
</sect1>
 



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

 <sect1 id="authors">
  <title>Authors</title>
  <para>
   <application>Guname</application> was written by Havoc Pennington
   (<email>hp@redhat.com</email>). Please send all comments,
   suggestions, and bug reports to the <ulink
   url="http://bugs.gnome.org" type="http">GNOME bug tracking
   database</ulink>. Instructions for submitting bug reports can be
   found on-line at <ulink url="http://bugs.gnome.org/Reporting.html"
   type="http"> http://bugs.gnome.org/Reporting.html</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>

  <!-- For translations: uncomment this:

  <para>
   Latin translation was done by ME
   (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
   suggestions regarding this translation to SOMEWHERE.
  </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>




