<!DOCTYPE article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
       
<!ENTITY version "1.4.0.1"> 
<!ENTITY date "6/16/2001"> 
]>

<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 1.0.4
  Template last modified April 20, 2001
-->


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

<article id="index" lang="en"> 


  <artheader>
    <title>GNOME Archive Generator Manual</title>
    <copyright>
      <year>2001</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 manual describes version &version; of GNOME Archive Generator. It was
       last updated on &date;.
    </releaseinfo>

  </artheader>

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

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

    <para>
      <application>GNOME Archive Generator</application> makes compressed tape
      archive record (<acronym>tar</acronym>) files. A <acronym>tar</acronym>
      file is a single bundled file that contains a directory or group of files.
    </para>
 
    <para>
      To run <application>GNOME Archive Generator</application>, select
      <menuchoice>
	<guisubmenu>Utilities</guisubmenu>
	<guimenuitem>Archive Generator</guimenuitem>
      </menuchoice>
      from the <guimenu>Main Menu</guimenu>, or type
      <command>meat-grinder</command> on the command line.
  </para>

    <para>
      <application>GNOME Archive Generator</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>GNOME Archive Generator</application>.
    </para>
  </sect1>


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

  <sect1 id="usage">
    <title>Basic usage</title>
    <para>
      Starting <application>GNOME Archive Generator</application> opens the
      <interface>Main window</interface>, shown in <xref
      linkend="mainwindow-fig">. The window is at first empty.

      <!-- ==== Figure ==== -->
      <figure id="mainwindow-fig">
	<title>GNOME Archive Generator Main Window</title>
	<screenshot>
	  <screeninfo>GNOME Archive Generator Main Window</screeninfo>
	  <graphic fileref="figures/meat-grinder-main" format="png"
		     srccredit="John Fleck">
	  </graphic>
	</screenshot>
      </figure>
    <!-- ==== End of Figure ==== -->
    </para> 
    <para>
      Drag and drop icons for the files or directories you would like to archive
      from your file manager to the <application>GNOME Archive
      Generator</application> main window. Icons representing them will appear
      in the main window.
 <figure id="mainwindow-fig-full">
	<title>GNOME Archive Generator Main Window</title>
	<screenshot>
	  <screeninfo>GNOME Archive Generator Main Window</screeninfo>
	  <graphic fileref="figures/meat-grinder-main-full" format="png"
		     srccredit="John Fleck">
	  </graphic>
	</screenshot>
      </figure>

      <note>
	<para><application>GNOME Archive Generator</application> works on copies
	of your files and directories. The originals will remain in their
	original location.</para>
      </note>
    </para>
    <para>
      To make the archive, chose <guimenuitem>Create archive</guimenuitem> from
      the <guimenu>File</guimenu> menu. A standard file selection dialogue will
      open. Use it to choose the location in which you would like to save the
      new archive file. Enter a name for the archive file and click
      <guibutton>OK</guibutton>. <application>GNOME Archive
	Generator</application> will create a <acronym>tar</acronym> file
      compressed with <application>gzip</application>.

      <note>
	<para><application>GNOME Archive Generator</application> places no
	restrictions on the file name you choose. Most applications expect
	  compressed names of compressed archive files to end in
	<filename>.tar.gz</filename>.</para>
      </note>
    </para>

    <!-- ========= Menus =========================== --> 

    <sect2 id="menubar">

       <!-- Describing the menubar ensures comprehensive feature
       coverage. Nest itemizedlists inside variablelists so that each
       menu is easily located by indexing software. Proper indentation
       makes it easier! -->

      <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:
	       <itemizedlist>
		<listitem>
		  <para>
	            <menuchoice>
		      <guimenuitem>Create archive</guimenuitem>
		     </menuchoice>
	             &mdash; Create an archive
	           </para>
		</listitem>
		<listitem>
		  <para>
	            <menuchoice>
		      <shortcut>
			<keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>
		      </shortcut>
		      <guimenuitem>Exit</guimenuitem>
		    </menuchoice>
	            &mdash; This quits the application.
	          </para>
		</listitem>
	      </itemizedlist>
	  </para>
	  </listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><guimenu>Edit</guimenu></term>
	  <listitem>
	    <para>
	   This menu contains:
	   <itemizedlist>
		<listitem>
		  <para>
	            <menuchoice>
		     
		      <guimenuitem>Remove</guimenuitem>
		    </menuchoice>
	            &mdash; This removes any highlight file or directory from the main
	            window. It does not remove the original file, only the copy
	            being used by <application>GNOME Archive Generator</application>.
	          </para>
		</listitem>
		<listitem>
		  <para>
	            <menuchoice>
		     
		      <guimenuitem>Clear</guimenuitem>
		    </menuchoice>
	            &mdash; This clears all files or directories from the main window.
	          </para>
		</listitem>
		<listitem>
		  <para>
	           <menuchoice>
		      
		      <guimenuitem>Select All</guimenuitem>
		    </menuchoice>
	            &mdash; This selects all files and directories in the main window.
	        </para>
		</listitem>
	      </itemizedlist>
	    </para>
	  </listitem>
	</varlistentry>
	

	
	<varlistentry>
	  <term><guimenu>Help</guimenu></term>
	  <listitem>
	    <para>
	      This menu contains:
	       <itemizedlist>
		<listitem>
		  <para>
	             <guimenuitem>Manual</guimenuitem> &mdash; This
    	              opens the designated <application>Help
    	              Browser</application> and displays this manual.
	          </para>
		</listitem>
		
		<listitem>
		  <para>
	            <guimenuitem>About</guimenuitem> &mdash; This
    	            opens the <interface>About</interface> dialog
    	            which shows basic information about
    	            <application>GNOME Archive Generator</application>, such as
    	            the author's name, the application version number.
    	           
	          </para>
		</listitem>
	      </itemizedlist>
            </para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </sect2>
  </sect1>



 
 <sect1 id="authors">
  <title>Authors</title>
  <para>
   <application>GNOME Archive Generator</application> was written by George Lebl
   (<email>jirka@5z.com</email>). This manual was written by John Fleck
   (<email>jfleck@inkstain.net</email>).
  </para>
  <para>
    If you have some comments or suggestions regarding this
   application, need help, or want to report a bug, please contact us!
   Instructions for doing so are given in <ulink type="help"
   url="gnome-help:gnome-feedback"><citetitle>Reporting GNOME bugs and other
   feedback</citetitle></ulink> document, which you can find in the
   <guilabel>Help</guilabel> tab of
   <application>Nautilus</application> file manager.
  </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 type="help" url="gnome-help:gpl">
    <citetitle>GNU General Public License</citetitle></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>
   A copy of the <citetitle>GNU General Public License</citetitle> is
   included as an appendix to the <citetitle>GNOME Users
   Guide</citetitle>.  You may also 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>









