From nobody@FreeBSD.org  Thu Feb 23 07:24:18 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 9519C1065670
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 23 Feb 2012 07:24:18 +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 807128FC1C
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 23 Feb 2012 07:24:18 +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 q1N7OIcT004518
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 23 Feb 2012 07:24:18 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id q1N7OIPe004485;
	Thu, 23 Feb 2012 07:24:18 GMT
	(envelope-from nobody)
Message-Id: <201202230724.q1N7OIPe004485@red.freebsd.org>
Date: Thu, 23 Feb 2012 07:24:18 GMT
From: Fernando <fernando.apesteguia@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Documentation is not up to date
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         165410
>Category:       docs
>Synopsis:       [handbook] installer documentation is not up to date
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    bcr
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Feb 23 07:30:10 UTC 2012
>Closed-Date:    Mon Jun 11 15:04:24 UTC 2012
>Last-Modified:  Mon Jun 11 15:04:24 UTC 2012
>Originator:     Fernando
>Release:        9.0-RELEASE
>Organization:
>Environment:
>Description:
In the handbook[1] the following paragraph can be read:

    Note: If the directory /usr/src/ does not exist on your system (or if it is empty), then the sources have not been installed. The easiest way to install the full source tree is to run sysinstall as root, and then choosing Configure, then Distributions, then src, and finally All. If it does not exist, you should also create a symlink to /usr/src/sys/:

    # ln -s /usr/src/sys /sys


However sysinstall can not be used for this task since 9.0. According to the ftp[2], the distributions sysinstall is trying to fetch don't exist anymore.


[1] http://www.freebsd.org/doc/en/books/handbook/kernelconfig-building.html
[2] ftp://ftp.freebsd.org/pub/FreeBSD/releases/i386/9.0-RELEASE/
>How-To-Repeat:
Follow instructions to install kernel sources at http://www.freebsd.org/doc/en/books/handbook/kernelconfig-building.html

sysinstall will show an error indicating it can not fetch any of the selected distributions
>Fix:
Update the handbook stating that for 9.0-RELEASE the source can be fetched either from the ftp[1] or using csup.

English is not my first language so a patch to the doc is not provided.

[1] ftp://ftp.freebsd.org/pub/FreeBSD/releases/i386/9.0-RELEASE/

>Release-Note:
>Audit-Trail:


From: Chris Rees <crees@pegasus.bayofrum.net>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/165410
Date: Sun, 11 Mar 2012 16:11:50 GMT

 The following is a multipart MIME message which was extracted
 from a uu-encoded message.
 
 ------------=_1331482315-51241-0
 Content-Type: text/plain; charset="ISO-8859-1"
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 --=20
 This message has been scanned for viruses and
 dangerous content by MailScanner, and is
 believed to be clean.
 
 
 
 ------------=_1331482315-51241-0
 Content-Type: application/octet-stream; name="-"; x-unix-mode="0644"
 Content-Disposition: inline; filename="-"
 Content-Transfer-Encoding: base64
 MIME-Version: 1.0
 X-Mailer: MIME-tools 5.502 (Entity 5.502)
 
 SW5kZXg6IGtlcm5lbGNvbmZpZy9jaGFwdGVyLnNnbWwKPT09PT09PT09PT09
 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09
 PT09PT09PT09PQpSQ1MgZmlsZTogL2hvbWUvZGN2cy9kb2MvZW5fVVMuSVNP
 ODg1OS0xL2Jvb2tzL2hhbmRib29rL2tlcm5lbGNvbmZpZy9jaGFwdGVyLnNn
 bWwsdgpyZXRyaWV2aW5nIHJldmlzaW9uIDEuMjA1CmRpZmYgLXUgLXIxLjIw
 NSBjaGFwdGVyLnNnbWwKLS0tIGtlcm5lbGNvbmZpZy9jaGFwdGVyLnNnbWwJ
 MTkgRmViIDIwMTIgMDI6NTk6MTggLTAwMDAJMS4yMDUKKysrIGtlcm5lbGNv
 bmZpZy9jaGFwdGVyLnNnbWwJMTEgTWFyIDIwMTIgMTY6MTE6NTAgLTAwMDAK
 QEAgLTI5OSwxNCArMjk5LDEwIEBACiAgICAgPG5vdGU+CiAgICAgICA8cGFy
 YT5JZiB0aGUgZGlyZWN0b3J5IDxmaWxlbmFtZT4vdXNyL3NyYy88L2ZpbGVu
 YW1lPiBkb2VzIG5vdAogCWV4aXN0IG9uIHlvdXIgc3lzdGVtIChvciBpZiBp
 dCBpcyBlbXB0eSksIHRoZW4gdGhlIHNvdXJjZXMgaGF2ZQotCW5vdCBiZWVu
 IGluc3RhbGxlZC4gIFRoZSBlYXNpZXN0IHdheSB0byBpbnN0YWxsIHRoZSBm
 dWxsIHNvdXJjZQotCXRyZWUgaXMgdG8gcnVuIDxjb21tYW5kPnN5c2luc3Rh
 bGw8L2NvbW1hbmQ+IGFzCi0JPHVzZXJuYW1lPnJvb3Q8L3VzZXJuYW1lPiwg
 YW5kIHRoZW4gY2hvb3NpbmcKLQk8Z3VpbWVudWl0ZW0+Q29uZmlndXJlPC9n
 dWltZW51aXRlbT4sIHRoZW4KLQk8Z3VpbWVudWl0ZW0+RGlzdHJpYnV0aW9u
 czwvZ3VpbWVudWl0ZW0+LCB0aGVuCi0JPGd1aW1lbnVpdGVtPnNyYzwvZ3Vp
 bWVudWl0ZW0+LCBhbmQgZmluYWxseQotCTxndWltZW51aXRlbT5BbGw8L2d1
 aW1lbnVpdGVtPi4gIElmIGl0IGRvZXMgbm90IGV4aXN0LCB5b3Ugc2hvdWxk
 Ci0JYWxzbyBjcmVhdGUgYSBzeW1saW5rIHRvIDxmaWxlbmFtZT4vdXNyL3Ny
 Yy9zeXMvPC9maWxlbmFtZT46PC9wYXJhPgorCW5vdCBiZWVuIGluc3RhbGxl
 ZC4gIFRoZSBlYXNpZXN0IHdheSB0byBpbnN0YWxsIHRoZSBmdWxsIHNvdXJj
 ZSBpcworCXRvIHVzZSAmbWFuLmNzdXAuMTsgYXMgZGVzY3JpYmVkIGluIDx4
 cmVmIGxpbmtlbmQ9InN5bmNoaW5nIj4uCisJWW91IHNob3VsZCBhbHNvIGNy
 ZWF0ZSBhIHN5bWxpbmsgdG8KKwk8ZmlsZW5hbWU+L3Vzci9zcmMvc3lzLzwv
 ZmlsZW5hbWU+OjwvcGFyYT4KIAogCTxzY3JlZW4+JnByb21wdC5yb290OyA8
 dXNlcmlucHV0PmxuIC1zIC91c3Ivc3JjL3N5cyAvc3lzPC91c2VyaW5wdXQ+
 PC9zY3JlZW4+CiAgICAgPC9ub3RlPgo=
 
 ------------=_1331482315-51241-0--

Responsible-Changed-From-To: freebsd-doc->bcr  
Responsible-Changed-By: bcr 
Responsible-Changed-When: Sun Jun 10 20:09:08 UTC 2012 
Responsible-Changed-Why:  
Grab this one. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/165410: commit references a PR
Date: Mon, 11 Jun 2012 14:59:48 +0000 (UTC)

 Author: bcr
 Date: Mon Jun 11 14:59:39 2012
 New Revision: 39025
 URL: http://svn.freebsd.org/changeset/doc/39025
 
 Log:
   The description about installing the system sources are no longer
   accurate in newer FreeBSD versions, since sysinstall is not there
   anymore. Therefore, provide a more general way that fits both
   cases by refering to the section in the handbook about synching
   the system sources.
   
   PR:		docs/165410
   Submitted by:	Fernando (fernando dot apesteguia at gmail dot com)
   Patch by:	crees (slightly modified by me)
 
 Modified:
   head/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml
 
 Modified: head/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml	Mon Jun 11 08:17:03 2012	(r39024)
 +++ head/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml	Mon Jun 11 14:59:39 2012	(r39025)
 @@ -300,13 +300,9 @@ following line in &man.loader.conf.5;:
        <para>If the directory <filename>/usr/src/</filename> does not
  	exist on your system (or if it is empty), then the sources have
  	not been installed.  The easiest way to install the full source
 -	tree is to run <command>sysinstall</command> as
 -	<username>root</username>, and then choosing
 -	<guimenuitem>Configure</guimenuitem>, then
 -	<guimenuitem>Distributions</guimenuitem>, then
 -	<guimenuitem>src</guimenuitem>, and finally
 -	<guimenuitem>All</guimenuitem>.  If it does not exist, you should
 -	also create a symlink to <filename>/usr/src/sys/</filename>:</para>
 +	is to use &man.csup.1; as described in <xref
 +	linkend="synching">.  You should also create a symlink to
 +	<filename class="directory">/usr/src/sys/</filename>:</para>
  
  	<screen>&prompt.root; <userinput>ln -s /usr/src/sys /sys</userinput></screen>
      </note>
 _______________________________________________
 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: bcr 
State-Changed-When: Mon Jun 11 15:02:46 UTC 2012 
State-Changed-Why:  
An update was committed to the doc tree, based on the patch that crees came up 
with. Thanks to both the submitter and crees. PR closed! 

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