Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 27 Aug 2005 18:11:57 +0200 (CEST)
From:      Julien Gabel <jpeg@thilelli.net>
To:        FreeBSD-gnats-submit@FreeBSD.org
Subject:   docs/85353: Very little cosmetic/ponctuation changes for the GEOM (geom-striping) chapter of the Handbook.
Message-ID:  <20050827161157.0DA1D73027@titeuf.thilelli.net>
Resent-Message-ID: <200508271620.j7RGKGes086346@freefall.freebsd.org>

next in thread | raw e-mail | index | archive | help

>Number:         85353
>Category:       docs
>Synopsis:       Very little cosmetic/ponctuation changes for the GEOM (geom-striping) chapter of the Handbook.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Aug 27 16:20:16 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Julien Gabel
>Release:        FreeBSD 5.4-STABLE i386
>Organization:
>Environment:
System: FreeBSD titeuf.thilelli.net 5.4-STABLE FreeBSD 5.4-STABLE #0: Sun Aug 21 14:49:33 CEST 2005 root@titeuf.thilelli.net:/usr/obj/usr/src/sys/TITEUF i386

>Description:
When command(s) follow a sentence, i think the sentence may end with a ':', as found in other
part of the book (geom-mirror for example).

An other point is when a kernel module is loaded, the .ko extension may be forgotten.  We can
see this in other documentation and the kldload(8) manual page.

>How-To-Repeat:
Compare with the corresponding chapter:
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/geom-striping.html

>Fix:

Here is a little patch:

--- chapter.sgml.diff begins here ---
--- /usr/doc/en_US.ISO8859-1/books/handbook/geom/chapter.sgml	Sat Aug 13 03:11:37 2005
+++ /tmp/chapter.sgml	Sat Aug 27 17:53:32 2005
@@ -148,13 +148,13 @@
       <step><para>Load the <filename>geom_stripe</filename>
         module:</para>
 
-    <screen>&prompt.root; <userinput>kldload geom_stripe.ko</userinput></screen>
+    <screen>&prompt.root; <userinput>kldload geom_stripe</userinput></screen>
 	</step>
 
       <step><para>Ensure that a suitable mount point exists.  If this
         volume will become a root partition, then temporarily use
         another mount point such as <filename
-        role="directory">/mnt</filename>.</para>
+        role="directory">/mnt</filename>:</para>
 
         <screen>&prompt.root; <userinput>mkdir /mnt</userinput></screen>
       </step>
@@ -164,7 +164,7 @@
         the following command could be used to stripe two unused,
         unpartitioned <acronym>ATA</acronym> disks:
         <filename>/dev/ad2</filename> and
-        <filename>/dev/ad3</filename>.</para>
+        <filename>/dev/ad3</filename>:</para>
 
         <screen>&prompt.root; <userinput>gstripe label -v st0 /dev/ad2 /dev/ad3</userinput></screen>
 
@@ -201,12 +201,12 @@
 
       <para>Many numbers will glide across the screen, and after a few
         seconds, the process will be complete.  The volume has been
-        created and is ready to be mounted:</para>
+        created and is ready to be mounted.</para>
     </step>
   </procedure>
 
   <para>The following command can be used to manually mount a newly
-    created disk stripe.</para>
+    created disk stripe:</para>
 
   <screen>&prompt.root; <userinput>mount /dev/stripe/st0a /mnt</userinput></screen>
 
@@ -219,7 +219,7 @@
 
   <para>The geom module must also be automatically loaded during
     system initialization, by adding a line to
-    <filename>/boot/loader.conf</filename>.</para>
+    <filename>/boot/loader.conf</filename>:</para>
 
   <screen>&prompt.root; <userinput>echo 'geom_stripe_load="YES"' &gt;&gt; /boot/loader.conf</userinput></screen>
 
@@ -392,7 +392,7 @@
 	  system to a &man.loader.8; prompt.  Load the kernel module
 	  manually:</para>
 
-	<screen>OK? <userinput>load geom_mirror.ko</userinput>
+	<screen>OK? <userinput>load geom_mirror</userinput>
 OK? <userinput>boot</userinput></screen>
 
 	<para>If this works then for whatever reason the module was not
--- chapter.sgml.diff ends here ---
>Release-Note:
>Audit-Trail:
>Unformatted:



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20050827161157.0DA1D73027>