docs/90740: [PATCH] update to the FAQ regarding the "touch: not found" error during buildworld

[Niclas Zeising]

>Number:         90740
>Category:       docs
>Synopsis:       [PATCH] update to the FAQ regarding the "touch: not found" error during buildworld
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Wed Dec 21 12:30:11 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Niclas Zeising
>Release:        FreeBSD 7.0-CURRENT i386
>Organization:
>Environment:
System: FreeBSD aeris.daemonic.se 7.0-CURRENT FreeBSD 7.0-CURRENT #0: Mon Nov 21 12:25:01 CET 2005 root at aeris.daemonic.se:/usr/obj/usr/src/sys/AERIS i386


	
>Description:
	Hi!
	This is an attempt to update the FAQ with an entry regarding the "touch: not found" error. From time to time people are asking and wondering about this strange and non-informative error, so I think an addition to the FAQ is in order.
	
>How-To-Repeat:
	
>Fix:
	Apply the attatched patch which (tries to) document this error. Feel free to change the patch anyway you like.

	

--- faq.book.sgml.diff begins here ---
--- faq.book.sgml.orig	2005-12-02 16:32:45.000000000 +0100
+++ faq.book.sgml	2005-12-02 17:02:20.000000000 +0100
@@ -4036,6 +4036,23 @@
               to a complete system lockup.</para>
         </answer>
       </qandaentry>
+
+      <qandaentry>
+        <question id="touch-not-found">
+	  <para>Why does buildworld/installworld die with the message
+	    <errorname>touch: not found</errorname>?</para>
+        </question>
+
+	<answer>
+	  <para>This error does not mean that touch is missing. The
+	      error is instead propably due to the dates of the files
+	      being set sometime in the future. If your CMOS-clock is
+	      set to local time you need to run the command
+	      <command>adjkerntz -i</command> to adjust the kernel clock
+	      when booting into single user mode.
+	  </para>
+	</answer>
+      </qandaentry>
     </qandaset>
   </chapter>
 
--- faq.book.sgml.diff ends here ---


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