docs/172922: Handbook - 25.7 Rebuilding “world” - update w/r to /src.conf and make.conf

[jb]

>Number:         172922
>Category:       docs
>Synopsis:       Handbook - 25.7 Rebuilding “world” - update w/r to /src.conf and make.conf
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Oct 21 08:30:00 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     jb
>Release:        FreeBSD 9.1-RC2 #0
>Organization:
>Environment:
FreeBSD localhost.localdomain 9.1-RC2 FreeBSD 9.1-RC2 #0 r241133: Tue Oct  2 17:11:45 UTC 2012     root at obrian.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386

>Description:
This paragraph should reflect current/future use of
src.conf for base system.
The src.conf is not even mentioned here - it should be added as a new paragraph
like the one for /etc/make.conf there, clearly stating its purpose.
 
The old text mentions make.conf
- with option that was renamed and moved to rc.conf, like e.g. NO_PROFILE to
  WITHOUT_PROFILE
- or with option that is part of porter's handbook
  http://www.freebsd.org/doc/en/books/porters-handbook/install.html
which references that should be removed from that paragraph:

25.7.3 Check /etc/make.conf
..
A typical user will probably want to copy and uncomment the NO_PROFILE line found in /usr/share/examples/etc/make.conf to /etc/make.conf.

Examine the other definitions, like NOPORTDOCS, and decide if they are relevant to you.

I would even suggest to remove the paragraph "25.7.3 Check /etc/make.conf" as
it is out-of-date.
Ref:
http://lists.freebsd.org/pipermail/freebsd-questions/2009-November/208562.html

jb

>How-To-Repeat:
n/a
>Fix:
rewrite paragraph in question


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