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


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


<article id="index"> 

  <artheader> 
    <title>Gless 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 Gless manual.
     </releaseinfo>
  </artheader>

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

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

    <para>
      <application>Gless</application> is a program for viewing text
      files, similar to the GNU program <application>less</application>. It is 
      included in the package <filename>GNOME-Utils</filename>, which is a
      part of the GNOME desktop environment. This document describes
      version &version; of <application>Gless</application>.
    </para>

    <para><application>Gless</application> can be started by
      selecting <guimenuitem>Text File Viewer</guimenuitem> from
      <guisubmenu>Utilities</guisubmenu> submenu of the <guimenu>Main
	Menu</guimenu>, or by running the command
      <command>gless</command> on the command line.  
    </para>

     </sect1>


<!-- =============New section============================= --> 

  <sect1 id="usage"> 
    <title>Using Gless</title>
 

    <para><application>Gless</application> can be
    used to view, but not edit, text files. This section describes basic usage of
    <application>Gless</application>.
    </para>

      <!-- =========Subsection=========================== -->   
      <sect2 id="mainwin">
      <title>Basic usage</title>
      <para>
	When you first start <application>Gless</application>, you see
	the <interface>Main window</interface>, as shown in 
	<xref linkend="mainshot">.
<!-- ==============Figure=================================== -->
	<figure id="mainshot">
	  <title>Gless Main Window</title>
	  <screenshot>
	    <screeninfo>Gless Main Window</screeninfo>
	    <graphic fileref="figures/gless-main" format="png"
	    srccredit="John Fleck">
	    </graphic>
	  </screenshot>
	</figure>
<!-- ==============End of Figure=================================== -->
      </para>

  
    </sect2>
<!-- =========Subsection=========================== -->   
    <sect2 id="menubar">
      <title> Menus</title>
      <para>
         The menu bar, located at the top of the <interface>Main
         Window</interface>, provides the following commands:
      </para>
      <!-- =========List=========================== -->
      <variablelist>
	<varlistentry> <term><guimenu>File</guimenu></term>
          <listitem><para> This menu contains commands
              <menuchoice>
	        <shortcut><keysym>Alt-N</keysym>
		</shortcut>
		<guimenuitem>New Window</guimenuitem>
	      </menuchoice>, 

              <menuchoice>
	        <shortcut><keysym>Alt-O, F3</keysym>
		</shortcut>
		<guimenuitem>Open</guimenuitem>
	      </menuchoice>, 

	      <menuchoice>
	        <shortcut><keysym>Ctrl-A</keysym>
		</shortcut>
		<guimenuitem>Save As</guimenuitem>
	      </menuchoice>, 
              <menuchoice>
	        <shortcut><keysym>Alt-W</keysym>
		</shortcut>
		<guimenuitem>Close</guimenuitem>
	      </menuchoice> 
	      and
	      <menuchoice>
	        <shortcut><keysym>Alt-Q</keysym>
		</shortcut>
		<guimenuitem>Quit</guimenuitem>
	      </menuchoice>
	      all of which are self-explanatory.
	    </para>
	  </listitem> 
	</varlistentry> 

	<varlistentry> 
	  <term><guimenu>Edit</guimenu></term>
	  <listitem><para>
	      This menu contains
              <menuchoice>
	        <shortcut><keysym>Alt-F, F6</keysym>
		</shortcut>
		<guimenuitem>Find</guimenuitem>
	      </menuchoice>, which opens up a dialog box allowing you
	      to enter a word to be searched for, and
              <menuchoice>
	        <shortcut><keysym>Alt-A, Shift-F6</keysym>
		</shortcut>
		<guimenuitem>Find Again</guimenuitem>
	      </menuchoice>, which searches for the next occurrence of
	      the same word.</para>
	  </listitem>
	</varlistentry>

	<varlistentry> 
	  <term><guimenu>Settings</guimenu></term>
	  <listitem><para>
	      This menu contains only one command,
              <menuchoice>
		<shortcut>
		  <keysym>Ctl-F</keysym>
		</shortcut>
		<guimenuitem>Fixed Font</guimenuitem>
	      </menuchoice>, which toggles
		between a fixed font display and a proportional font display.
	     
	      </para>
	  </listitem>
	</varlistentry>


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

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

	      </para>
	  </listitem>
	</varlistentry>

	</variablelist>
      <!-- =========End of list=========================== -->
	</sect2>

  </sect1>   





<!-- =============New section============================= -->

  <sect1 id="authors">
    <title>Authors</title>
     <para>
      <application>Gless</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 command
      <command>bug-buddy</command> 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 the manual to the GNOME Documentation
      Project at <email>docs@gnome.org</email>. You can also add your
      comments online by using <ulink type="http"
      url="http://developer.gnome.org/projects/gdp/doctable/">GNOME Documentation
      Status Table</ulink>. 
      </para>
  
    <para>This program was written by Havoc Pennington and can be freely
      redistributed 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 GNU 
     General Public License for more details.</para>

    </sect1>

</article>
