From nobody@FreeBSD.org  Tue Jun 28 11:38:28 2011
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 443DB106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 28 Jun 2011 11:38:28 +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 349178FC12
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 28 Jun 2011 11:38:28 +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 p5SBcS7J049332
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 28 Jun 2011 11:38:28 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p5SBcSj7049331;
	Tue, 28 Jun 2011 11:38:28 GMT
	(envelope-from nobody)
Message-Id: <201106281138.p5SBcSj7049331@red.freebsd.org>
Date: Tue, 28 Jun 2011 11:38:28 GMT
From: Greg Becker <greg@codeconcepts.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Incorrect documentation of LOCAL_SCRIPT in release(7) man page...
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         158388
>Category:       docs
>Synopsis:       Incorrect documentation of LOCAL_SCRIPT in release(7) man page...
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jun 28 11:40:06 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Greg Becker
>Release:        8.2
>Organization:
CodeConcepts
>Environment:
FreeBSD gromit.codeconcepts.com 8.2-STABLE FreeBSD 8.2-STABLE #0: Sun Jun  5 05:09:04 CDT 2011     root@gromit.codeconcepts.com:/build/obj/usr/src/sys/GROMIT  amd64

>Description:
The description of the LOCAL_SCRIPT variable in the release(7) man page says that the script is run in the chroot(8) environment.  I don't believe this is accurate.  What actually happens is that the make cd's to the top-level directory of the chroot tree and then runs LOCAL_SCRIPT.  A small, but important distinction for those trying to understand the release process.

From /usr/src/release/Makefile:

.if defined(LOCAL_SCRIPT)
    cd ${CHROOTDIR} && env CHROOTDIR=${CHROOTDIR} BUILDNAME=${BUILDNAME} \
        RELEASETAG=${RELEASETAG} ${LOCAL_SCRIPT}

>How-To-Repeat:

>Fix:


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