From owner-p4-projects@FreeBSD.ORG  Fri Jul 28 18:44:20 2006
Return-Path: <owner-p4-projects@FreeBSD.ORG>
X-Original-To: p4-projects@freebsd.org
Delivered-To: p4-projects@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 2F70716A4E2; Fri, 28 Jul 2006 18:44:20 +0000 (UTC)
X-Original-To: perforce@FreeBSD.org
Delivered-To: perforce@FreeBSD.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id EBC3C16A4DA
	for <perforce@FreeBSD.org>; Fri, 28 Jul 2006 18:44:19 +0000 (UTC)
	(envelope-from gabor@FreeBSD.org)
Received: from repoman.freebsd.org (repoman.freebsd.org [216.136.204.115])
	by mx1.FreeBSD.org (Postfix) with ESMTP id B49D843D49
	for <perforce@FreeBSD.org>; Fri, 28 Jul 2006 18:44:19 +0000 (GMT)
	(envelope-from gabor@FreeBSD.org)
Received: from repoman.freebsd.org (localhost [127.0.0.1])
	by repoman.freebsd.org (8.13.6/8.13.6) with ESMTP id k6SIiJMx073710
	for <perforce@FreeBSD.org>; Fri, 28 Jul 2006 18:44:19 GMT
	(envelope-from gabor@FreeBSD.org)
Received: (from perforce@localhost)
	by repoman.freebsd.org (8.13.6/8.13.4/Submit) id k6SIiJkj073707
	for perforce@freebsd.org; Fri, 28 Jul 2006 18:44:19 GMT
	(envelope-from gabor@FreeBSD.org)
Date: Fri, 28 Jul 2006 18:44:19 GMT
Message-Id: <200607281844.k6SIiJkj073707@repoman.freebsd.org>
X-Authentication-Warning: repoman.freebsd.org: perforce set sender to
	gabor@FreeBSD.org using -f
From: Gabor Kovesdan <gabor@FreeBSD.org>
To: Perforce Change Reviews <perforce@FreeBSD.org>
Cc: 
Subject: PERFORCE change 102675 for review
X-BeenThere: p4-projects@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: p4 projects tree changes <p4-projects.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/p4-projects>
List-Post: <mailto:p4-projects@freebsd.org>
List-Help: <mailto:p4-projects-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 28 Jul 2006 18:44:20 -0000

http://perforce.freebsd.org/chv.cgi?CH=102675

Change 102675 by gabor@gabor_spitfire on 2006/07/28 18:43:49

	Document the IS_JAILED macro and the changed OSVERSION behavior,
	I changed for the DESTDIR support.

Affected files ...

.. //depot/projects/soc2006/gabor_docs/porters-handbook/book.sgml#12 edit

Differences ...

==== //depot/projects/soc2006/gabor_docs/porters-handbook/book.sgml#12 (text+ko) ====

@@ -3941,6 +3941,25 @@
       <para>There are some more things you have to take into account when you
 	create a port.  This section explains the most common of those.</para>
 
+      <sect1 id="building-in-jails">
+        <title>Building in jails</title>
+
+	<para>There might be cases where you want to know if the build is
+	  running from a jailed environment or not.  There is the
+	  <makevar>IS_JAILED</makevar> variable for this case.  It is defined
+	  in <filename>bsd.port.mk</filename> when you are jailed.  For
+	  debugging purposes, you can manually define <makevar>IS_JAILED</makevar>
+	  to pretend that you are imprisoned.</para>
+
+	<para>Note, that the behavior of <makevar>OSVERSION</makevar> has been
+	  changed recently.  Now, it gets the <link
+	   linkend="freebsd-versions"><literal>__FreeBSD_version</literal></link>
+	  from the userland, since it makes more sense for the ports, than the
+	  kernel.  You can still override it, if you really have to get it from
+	  the kernel.</para>
+
+      </sect1>
+
       <sect1 id="porting-shlibs">
 	<title>Shared Libraries</title>