From nobody@FreeBSD.org  Fri Jun 29 08:50:05 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id AEAA91065672
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 29 Jun 2012 08:50:05 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 899118FC1F
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 29 Jun 2012 08:50:05 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q5T8o5XU048153
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 29 Jun 2012 08:50:05 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id q5T8o4qZ048144;
	Fri, 29 Jun 2012 08:50:04 GMT
	(envelope-from nobody)
Message-Id: <201206290850.q5T8o4qZ048144@red.freebsd.org>
Date: Fri, 29 Jun 2012 08:50:04 GMT
From: Markus Klaschka <mk@mkdev.eu>
To: freebsd-gnats-submit@FreeBSD.org
Subject: wrong update instructions in handbook
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         169538
>Category:       docs
>Synopsis:       wrong update instructions in handbook
>Confidential:   no
>Severity:       serious
>Priority:       low
>Responsible:    jkois
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jun 29 09:00:26 UTC 2012
>Closed-Date:    Fri Jun 29 11:49:40 UTC 2012
>Last-Modified:  Fri Jun 29 11:49:40 UTC 2012
>Originator:     Markus Klaschka
>Release:        9-STABLE
>Organization:
Markus Klaschka Development SL
>Environment:
not neccasary here
>Description:
http://www.freebsd.org/doc/de/books/handbook/makeworld.html
The update instructions below the first "blue box" on this page missing a real neccasary line:

make installworld

this here is the command-listing of that handbook-page:
# mount -u /
# mount -a -t ufs
# adjkerntz -i
# mergemaster -p
# cd /usr/src
# mergemaster
# reboot

please fix that ;)

On the other hand an explanaition of -i -U and -F parameters of mergemaster would be really nice, as they could safe a lot of time during the merging if used correctly...
>How-To-Repeat:

>Fix:
add line "make installworld" before mergemaster

>Release-Note:
>Audit-Trail:

From: Niclas Zeising <zeising@daemonic.se>
To: Markus Klaschka <mk@mkdev.eu>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/169538: wrong update instructions in handbook
Date: Fri, 29 Jun 2012 11:18:49 +0200

 This is a multi-part message in MIME format.
 --------------090506060908040905010107
 Content-Type: text/plain; charset=UTF-8; format=flowed
 Content-Transfer-Encoding: 7bit
 
 Here is a patch to add the missing installworld stage.
 Regards!
 -- 
 Niclas
 
 --------------090506060908040905010107
 Content-Type: text/x-patch;
  name="de_DE.handbook.cutting-edge.chapter.sgml.diff"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="de_DE.handbook.cutting-edge.chapter.sgml.diff"
 
 Index: head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
 ===================================================================
 --- head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	(revision 39149)
 +++ head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	(working copy)
 @@ -2212,6 +2212,7 @@
  &prompt.root; <userinput>adjkerntz -i</userinput>
  &prompt.root; <userinput>mergemaster -p</userinput>
  &prompt.root; <userinput>cd /usr/src</userinput>
 +&prompt.root; <userinput>make installworld</userinput>
  &prompt.root; <userinput>mergemaster</userinput>
  &prompt.root; <userinput>reboot</userinput></screen>
  
 
 --------------090506060908040905010107--
Responsible-Changed-From-To: freebsd-doc->jkois 
Responsible-Changed-By: jkois 
Responsible-Changed-When: Fri Jun 29 09:49:47 UTC 2012 
Responsible-Changed-Why:  
Take. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=169538 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/169538: commit references a PR
Date: Fri, 29 Jun 2012 10:57:50 +0000 (UTC)

 Author: jkois
 Date: Fri Jun 29 10:57:40 2012
 New Revision: 39152
 URL: http://svn.freebsd.org/changeset/doc/39152
 
 Log:
   PR:     docs/169538
   
   Fix the update instructions for "build the world".
   
   Noticed by:             Markus Klaschka (mk att mkdev dott eu)
   Patch provided by:      Niclas Zeising (zeising att daemonic dott se)
 
 Modified:
   head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
 
 Modified: head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
 ==============================================================================
 --- head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	Fri Jun 29 03:43:20 2012	(r39151)
 +++ head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	Fri Jun 29 10:57:40 2012	(r39152)
 @@ -3,8 +3,8 @@
       The FreeBSD German Documentation Project
  
       $FreeBSD$
 -     $FreeBSDde: de-docproj/books/handbook/cutting-edge/chapter.sgml,v 1.111 2012/03/25 15:29:19 bcr Exp $
 -     basiert auf: 1.258
 +     $FreeBSDde$
 +     basiert auf: r38826
  -->
  
  <chapter id="updating-upgrading">
 @@ -2212,6 +2212,7 @@ DOCSUPFILE?= /usr/share/examples/cvsup/d
  &prompt.root; <userinput>adjkerntz -i</userinput>
  &prompt.root; <userinput>mergemaster -p</userinput>
  &prompt.root; <userinput>cd /usr/src</userinput>
 +&prompt.root; <userinput>make installworld</userinput>
  &prompt.root; <userinput>mergemaster</userinput>
  &prompt.root; <userinput>reboot</userinput></screen>
  
 @@ -2307,7 +2308,7 @@ DOCSUPFILE?= /usr/share/examples/cvsup/d
  	pr&auml;-buildworld-Modus auf, der mit <option>-p</option> aktiviert
  	wird.  In diesem Modus werden nur Dateien verglichen, die f&uuml;r
  	den Erfolg von <maketarget>buildworld</maketarget> oder
 -	<maketarget>installworld</maketarget> essentiell sind.</para> 
 +	<maketarget>installworld</maketarget> essentiell sind.</para>
  
        <tip>
  	<para>Wenn Sie besonders paranoid sind, sollten Sie Ihr System nach
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: jkois 
State-Changed-When: Fri Jun 29 11:49:04 UTC 2012 
State-Changed-Why:  
Committed. Close this PR. 

And thanks for the contribution. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=169538 
>Unformatted:
