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

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

<article id="index"> 

 <artheader>
  <title>GFloppy Manual</title>
  <copyright>
   <year>2000</year>
   <holder>Kenny Graunke</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.7 of the GFloppy manual.
  </releaseinfo>

 </artheader>

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

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

  <para>
   <application>GFloppy</application> is a simple floppy formatter for Linux.
   You may need to format your floppies when they are new.
  </para>

  <para>
   To run <application>GFloppy</application>, select
   <guimenuitem>gfloppy</guimenuitem> from the
   <guisubmenu>Utility</guisubmenu> submenu of the <guimenu>Main
   Menu</guimenu>, right click on the floppy icon on your desktop and
   select <guisubmenu>Format Floppy</guisubmenu>, or type
   <command>gfloppy</command> on the command line. 
  </para>

  <para>
   This document describes version &version; of
   <application>GFloppy</application>.
  </para>

 </sect1>


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

 <sect1 id="usage">
  <title>Using GFloppy</title>
   <para>
    Starting <application>GFloppy</application> opens the
    <interface>Main window</interface>, shown in <xref linkend="mainwindow"/>.

    <figure id="mainwindow">
     <title>GFloppy Main Window</title>
     <screenshot>
      <screeninfo>GFloppy Main Window</screeninfo>
      <graphic fileref="figures/main" format="png"
       srccredit="Kenny Graunke">
      </graphic>
     </screenshot>
    </figure>
   </para>

   <para>
    Don't forget to insert a non-write-protected floppy.
   </para>

   <warning>
    <title>WARNING</title>
    <para>
     GFloppy will destroy all files on your floppy! Do not format floppies
     which contain files you wish to keep.
    </para>
   </warning>

   <para>
    Select your file system type. If you need to use your floppy under
    DOS or Windows, choose <guibutton>DOS (FAT16)</guibutton>. Otherwise,
    choose <guibutton>Linux Native (ext2)</guibutton>, since it is technically
    superior, but cannot be read on most non-Linux machines.
   </para>

   <para>
    GFloppy needs to know your floppy's density (the amount of data
    it can hold). Nowadays, most are High Density, 1.44MB 3.5" floppies.
   </para>

   <para>
    Quick format does not check your floppy for bad "blocks", so it is
    considerably faster. However, if you have not formatted your floppy
    before, or suspect it might be bad, you are better off
    with a regular, slow format.
   </para>

   <para>
    Now, click <guibutton>Format</guibutton> to start formatting your
    floppy, as shown in the following figures.
   </para>

   <para>
    <figure id="formatting">
     <title>Formatting...</title>
     <screenshot>
      <screeninfo>Formatting your floppy</screeninfo>
      <graphic fileref="figures/formatting" format="png"
       srccredit="Kenny Graunke">
      </graphic>
     </screenshot>
    </figure>
   </para>

   <para>
    <figure id="verifying">
     <title>Verifying...</title>
     <screenshot>
      <screeninfo>Verifying</screeninfo>
      <graphic fileref="figures/verifying" format="png"
       srccredit="Kenny Graunke">
      </graphic>
     </screenshot>
    </figure>
   </para>

   <para>
    <figure id="makingfilesystem">
     <title>Making filesystem on disk...</title>
     <screenshot>
      <screeninfo>Making filesystem on disk</screeninfo>
      <graphic fileref="figures/makingfilesystem" format="png"
       srccredit="Kenny Graunke">
      </graphic>
     </screenshot>
    </figure>
   </para>

   <para>
    Unless you selected <guibutton>Quick Format</guibutton>, GFloppy will
    check for bad "blocks" on your floppy. If it finds any, your floppy is
    wearing out and should be replaced.

    <figure id="badblocks">
     <title>Checking for bad blocks...</title>
     <screenshot>
      <screeninfo>Checking for bad blocks</screeninfo>
      <graphic fileref="figures/badblocks" format="png"
       srccredit="Kenny Graunke">
      </graphic>
     </screenshot>
    </figure>
   </para>

   <para>
    If all went well, GFloppy will let you know it was successful
    (<xref linkend="successful"/>), and ask you if you want to format
    another. If you click <guibutton>Yes</guibutton>, GFloppy will place you
    back at the main screen, otherwise it will quit.

    <figure id="successful">
     <title>Success!</title>
     <screenshot>
      <screeninfo>Success!</screeninfo>
      <graphic fileref="figures/successful" format="png"
       srccredit="Kenny Graunke">
      </graphic>
     </screenshot>
    </figure>

    <figure id="another">
     <title>Format another?</title>
     <screenshot>
      <screeninfo>Format another floppy?</screeninfo>
      <graphic fileref="figures/another" format="png"
       srccredit="Kenny Graunke">
      </graphic>
     </screenshot>
    </figure>
   </para>
 </sect1>

 <sect1 id="troubleshooting">
  <title>Troubleshooting</title>
   <para>
    If you forget to insert a floppy for a slow format, GFloppy will show
    <xref linkend="nodisk"/>.
    <figure id="nodisk">
     <title>No floppy disk</title>
     <screenshot>
      <screeninfo>No floppy disk</screeninfo>
      <graphic fileref="figures/nodisk" format="png"
       srccredit="Kenny Graunke">
      </graphic>
     </screenshot>
    </figure>
   </para>

   <para>
    If GFloppy displays <xref linkend="writeprotected"/> under a slow format,
    your floppy is write protected. To un-write protect your floppy, eject it,
    and turn it over. Standard 3.5" floppies will have a small black tab in
    the upper-left corner - slide it down so it covers the hole. If your 3.5"
    floppy does not have a black tab, it is permanently write protected, and
    you should get another floppy.
    <figure id="writeprotected">
     <title>Write protected</title>
     <screenshot>
      <screeninfo>Write protected</screeninfo>
      <graphic fileref="figures/writeprotected" format="png"
       srccredit="Kenny Graunke">
      </graphic>
     </screenshot>
    </figure>
   </para>

   <para>
    When performing a quick format, GFloppy will show you <xref
    linkend="qferror"/> if you forgot to insert a floppy, or if it is write
    protected.
    <figure id="qferror">
     <title>Quick Format - no floppy or write protected</title>
     <screenshot>
      <screeninfo>Quick Format - no floppy or write protected</screeninfo>
      <graphic fileref="figures/qferror" format="png"
       srccredit="Kenny Graunke">
      </graphic>
     </screenshot>
    </figure>
   </para>

   <para>
    If you can't choose to format DOS floppies, as shown in <xref
    linkend="nodos"/>, you need to install <filename>mtools</filename>.
   </para>
   <tip>
    <title>Tip</title>
    <para>
     On an RPM based system, such as Red Hat, you can install <filename>
     mtools</filename> using <ulink
     url="gnome-help:gnorpm"><application>GnoRPM</application></ulink>, from the
     <guisubmenu>System</guisubmenu> of
     the <guimenu>Main Menu</guimenu>.
    </para>
   </tip>
   <para>
    <figure id="nodos">
     <title>Cannot format DOS floppies</title>
     <screenshot>
       <screeninfo>Cannot format DOS floppies</screeninfo>
       <graphic fileref="figures/nodos" format="png"
        srccredit="Kenny Graunke">
       </graphic>
     </screenshot>
    </figure>
   </para>
 </sect1>

 <sect1 id="bugs">
  <title>Known Bugs and Limitations</title>
  <para>
   GFloppy is Linux specific &mdash; it will not work on other systems.
  </para>
 </sect1>

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

 <sect1 id="authors">
  <title>Authors</title>
  <para>
   <application>GFloppy</application> was written by Jonathan Blandford
   (<email>jrb@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>. 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 Kenny Graunke
   (<email>kwg@teleport.com</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"><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 <ulink
   url="gnome-help:gpl"><citetitle>GNU General Public
   License</citetitle></ulink> 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>

