docs/137288: gjournal sync should follow umount

[Anthony Chavez]

>Number:         137288
>Category:       docs
>Synopsis:       gjournal sync should follow umount
>Confidential:   no
>Severity:       non-critical
>Priority:       high
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 31 06:10:01 UTC 2009
>Closed-Date:
>Last-Modified:
>Originator:     Anthony Chavez
>Release:        n/a
>Organization:
hexadecagram.org
>Environment:
n/a
>Description:
In a recent discussion with pjd@ (http://lists.freebsd.org/pipermail/freebsd-fs/2009-July/006533.html), it was revealed that, you guessed it, "'gjournal sync' should follow unmount, not the other way around."

>How-To-Repeat:
Read "Implementing UFS Journaling on a Desktop PC," section 5.3.
>Fix:
Apply the attached patch.

Patch attached with submission follows:

Index: article.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/gjournal-desktop/article.sgml,v
retrieving revision 1.4
diff -u -r1.4 article.sgml
--- article.sgml	30 Sep 2008 11:56:52 -0000	1.4
+++ article.sgml	31 Jul 2009 05:51:17 -0000
@@ -591,14 +591,14 @@
 	
 	  <screen>&prompt.root; <userinput>shutdown now</userinput></screen>
 
-	  <para>Synchronize the journals:</para>
-
-	  <screen>&prompt.root; <userinput>gjournal sync</userinput></screen>
-
 	  <para>Unmount the journaled partitions:</para>
 
 	  <screen>&prompt.root; <userinput>umount /usr /var</userinput></screen>
 
+	  <para>Synchronize the journals:</para>
+
+	  <screen>&prompt.root; <userinput>gjournal sync</userinput></screen>
+
 	  <para>Stop the journaling providers:</para>
 
 	  <screen>&prompt.root; <userinput>gjournal stop ad0s1d.journal</userinput>


>Release-Note:
>Audit-Trail:
>Unformatted: