Bug 165410

Summary: [handbook] installer documentation is not up to date
Product: Documentation Reporter: Fernando ApesteguĂ­a <fernape>
Component: Books & ArticlesAssignee: Benedict Reuschling <bcr>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
- none

Description Fernando ApesteguĂ­a freebsd_committer freebsd_triage 2012-02-23 07:30:10 UTC
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/

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/
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
Comment 1 crees 2012-03-11 16:11:50 UTC
-- 
This message has been scanned for viruses and
dangerous content by MailScanner, and is
believed to be clean.

Comment 2 Benedict Reuschling freebsd_committer freebsd_triage 2012-06-10 21:09:08 UTC
Responsible Changed
From-To: freebsd-doc->bcr

Grab this one.
Comment 3 dfilter service freebsd_committer freebsd_triage 2012-06-11 15:59:48 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"
Comment 4 Benedict Reuschling freebsd_committer freebsd_triage 2012-06-11 16:02:46 UTC
State Changed
From-To: open->closed

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!