svn commit: r43694 - head/en_US.ISO8859-1/books/handbook/disks

Dru Lavigne dru at FreeBSD.org
Thu Jan 30 15:18:50 UTC 2014


Author: dru
Date: Thu Jan 30 15:18:49 2014
New Revision: 43694
URL: http://svnweb.freebsd.org/changeset/doc/43694

Log:
  Reduce floppy section to a procedure.
  Make note to remove this section in 06/15 when 8.4 is EOL'd (references PR155982)
  This section will not appear in the print edition.
  
  Sponsored by: iXsystems

Modified:
  head/en_US.ISO8859-1/books/handbook/disks/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/disks/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/disks/chapter.xml	Thu Jan 30 14:25:06 2014	(r43693)
+++ head/en_US.ISO8859-1/books/handbook/disks/chapter.xml	Thu Jan 30 15:18:49 2014	(r43694)
@@ -1407,9 +1407,9 @@ cd0: Attempt to query device size failed
   </sect1>
 
   <sect1 xml:id="floppies">
-    <info>
       <title>Creating and Using Floppy Disks</title>
 
+<!--
       <authorgroup>
 	<author>
 	  <personname>
@@ -1429,101 +1429,55 @@ cd0: Attempt to query device size failed
 	  <contrib>Rewritten by </contrib>
 	</author>
       </authorgroup>
-    </info>
+      -->
 
-    <para>Storing data on floppy disks is sometimes useful, for
-      example when one does not have any other removable storage media
-      or when one needs to transfer small amounts of data to another
-      computer.</para>
+    <para>This section explains how to format a 3.5 inch floppy disk 
+      in &os;.</para>
 
-    <para>This section explains how to use floppy disks in &os;.  It
-      covers formatting and usage of 3.5inch DOS floppies, but the
-      concepts are similar for other floppy disk formats.</para>
-
-    <sect2>
-      <title>Formatting Floppies</title>
-
-      <sect3>
-	<title>The Device</title>
-
-	<para>Floppy disks are accessed through entries in
-	  <filename>/dev</filename>, just like other
-	  devices.  To access the raw floppy disk, simply use
-	  <filename>/dev/fdN</filename>.</para>
-      </sect3>
-
-      <sect3>
-	<title>Formatting</title>
+    <procedure>
+      <title>Steps to Format a Floppy</title>
 
 	<para>A floppy disk needs to be low-level formatted before it
 	  can be used.  This is usually done by the vendor, but
-	  formatting is a good way to check media integrity.  Although
-	  it is possible to force other disk sizes, 1440kB is what
-	  most floppy disks are designed for.</para>
-
-	<para>To low-level format the floppy disk, use
-	  &man.fdformat.1;.  This utility expects the device name as
-	  an argument.</para>
-
-	<para>Make note of any error messages, as these can help
+	  formatting is a good way to check media integrity.  To 
+	  low-level format the floppy disk on &os;, use
+	  &man.fdformat.1;.  When using this utility, make note of any 
+	  error messages, as these can help
 	  determine if the disk is good or bad.</para>
-
-	<sect4>
-	  <title>Formatting Floppy Disks</title>
-
-	  <para>To format the floppy, insert a new 3.5inch floppy
+	
+	<step>
+	  <para>To format the floppy, insert a new 3.5 inch floppy
 	    disk into the first floppy drive and issue:</para>
 
 	  <screen>&prompt.root; <userinput>/usr/sbin/fdformat -f 1440 /dev/fd0</userinput></screen>
-	</sect4>
-      </sect3>
-    </sect2>
-
-    <sect2>
-      <title>The Disk Label</title>
+	</step>
 
-      <para>After low-level formatting the disk, a disk label needs to
-	placed  on it.  This disk label will be destroyed later, but
+	<step>
+      <para>After low-level formatting the disk, create a disk label as
 	it is needed by the system to determine the size of the disk
-	and its geometry.</para>
-
-      <para>The new disk label will take over the whole disk and will
-	contain all the proper information about the geometry of the
-	floppy.  The geometry values for the disk label are listed in
+	and its geometry.  The supported geometry values are listed in
 	<filename>/etc/disktab</filename>.</para>
 
       <para>To write the disk label, use &man.bsdlabel.8;:</para>
 
       <screen>&prompt.root; <userinput>/sbin/bsdlabel -B -w /dev/fd0 fd1440</userinput></screen>
-    </sect2>
-
-    <sect2>
-      <title>The File System</title>
-
-      <para>The floppy is now ready to be high-level formatted.  This
-	will place a new file system on it so that &os; can read and
-	write to the disk.  Since creating the new file system
-	destroys the disk label, the disk label needs to be recreated
-	whenever the disk is reformatted.</para>
+    </step>
 
-      <para>The floppy's file system can be either UFS or FAT.
+	<step>
+      <para>The floppy is now ready to be high-level formatted with a
+	file system.  The floppy's file system can be either UFS or FAT, where
 	FAT is generally a better choice for floppies.</para>
 
-      <para>To put a new file system on the floppy, issue:</para>
+	  <para>To format the floppy with FAT, issue:</para>
 
       <screen>&prompt.root; <userinput>/sbin/newfs_msdos /dev/fd0</userinput></screen>
+      </step>
+    </procedure>
 
-      <para>The disk is now ready for use.</para>
-    </sect2>
-
-    <sect2>
-      <title>Using the Floppy</title>
-
-      <para>To use the floppy, mount it with &man.mount.msdosfs.8;.
-	One can also use
+      <para>The disk is now ready for use.  To use the floppy, mount it with &man.mount.msdosfs.8;.
+	One can also install and use
 	<package>emulators/mtools</package> from the
 	Ports Collection.</para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="backups-tapebackups">


More information about the svn-doc-all mailing list