From owner-doc-jp@jp.freebsd.org  Sat Sep 11 21:54:50 1999
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id VAA03042;
	Sat, 11 Sep 1999 21:54:50 +0900 (JST)
	(envelope-from owner-doc-jp@jp.FreeBSD.org)
Received: from mail.kt.rim.or.jp (root@mail.kt.rim.or.jp [202.247.130.53])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id VAA03037
	for <doc-jp@jp.freebsd.org>; Sat, 11 Sep 1999 21:54:50 +0900 (JST)
	(envelope-from kuriyama@sky.rim.or.jp)
Received: from rhea.sky.rim.or.jp (ppp521.kt.rim.or.jp [202.247.140.171])
	by mail.kt.rim.or.jp (8.8.8/3.6W-RIMNET-98-06-09) with ESMTP id VAA06307
	for <doc-jp@jp.freebsd.org>; Sat, 11 Sep 1999 21:54:49 +0900 (JST)
Received: from localhost.sky.rim.or.jp (localhost [127.0.0.1])
	by rhea.sky.rim.or.jp (8.9.3/3.7W/rhea-1.1) with ESMTP id VAA28948
	for <doc-jp@jp.freebsd.org>; Sat, 11 Sep 1999 21:54:47 +0900 (JST)
Date: Sat, 11 Sep 1999 21:54:46 +0900
Message-ID: <14298.20758.348031.25346W@localhost.sky.rim.or.jp>
From: Jun Kuriyama <kuriyama@sky.rim.or.jp>
To: Japanese Documentation Project <doc-jp@jp.freebsd.org>
User-Agent: Wanderlust/1.0.3 (Notorious) SEMI/1.13.3 (Komaiko) FLIM/1.12.5 (Hirahata) MULE XEmacs/20.4 (Emerald) (i386--freebsd)
MIME-Version: 1.0 (generated by SEMI 1.13.3 - "Komaiko")
Content-Type: text/plain; charset=ISO-2022-JP
Reply-To: doc-jp@jp.freebsd.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+990727
X-Sequence: doc-jp 6653
Subject: [doc-jp 6653] <handbook> policies/chapter.sgml (1.8)
Errors-To: owner-doc-jp@jp.freebsd.org
Sender: owner-doc-jp@jp.freebsd.org
X-Originator: kuriyama@sky.rim.or.jp


$B!!$G$+$=$&$K8+$($k$1$I!"$=$s$J$KK]LuNL$O$J$$$+$b!#(B


Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO_8859-1/books/handbook/policies/chapter.sgml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- chapter.sgml	1999/03/08 22:04:45	1.7
+++ chapter.sgml	1999/07/07 00:00:18	1.8
@@ -217,6 +217,98 @@
 inclusion in the next vendor release.
 
 obrien@freebsd.org - 30 March 1997</programlisting>
+  </sect1>
+
+  <sect1 id="policies-encumbered">
+    <title>Encumbered files</title>
+
+    <para>It might occasionally be necessary to include an encumbered file in
+      the FreeBSD source tree.  For example, if a device requires a small
+      piece of binary code to be loaded to it before the device will operate,
+      and we do not have the source to that code, then the binary file is said 
+      to be encumbered.  The following policies apply to including encumbered
+      files in the FreeBSD source tree.</para>
+
+    <orderedlist>
+      <listitem>
+        <para>Any file which is interpreted or executed by the system CPU(s)
+	  and not in source format is encumbered.</para>
+      </listitem>
+
+      <listitem>
+        <para>Any file with a license more restrictive than BSD or GNU is
+	  encumbered.</para>
+      </listitem>
+
+      <listitem>
+        <para>A file which contains downloadable binary data for use by the
+	  hardware is not encumbered, unless (1) or (2) apply to it.  It must
+	  be stored in an architecture neutral ASCII format (file2c or
+	  uuencoding is recommended).</para>
+      </listitem>
+
+      <listitem>
+        <para>Any encumbered file requires specific approval from the <link
+	    linkend="staff-core">Core team</link> before it is added to the
+	  CVS repository.</para>
+      </listitem>
+
+      <listitem>
+        <para>Encumbered files go in <filename>src/contrib</filename> or
+	  <filename>src/sys/contrib</filename>.</para>
+      </listitem>
+
+      <listitem>
+        <para>The entire module should be kept together.  There is no point in 
+	  splitting it, unless there is code-sharing with non-encumbered
+	  code.</para>
+      </listitem>
+
+      <listitem>
+        <para>Object files are named
+	  <filename><replaceable>arch</replaceable>/<replaceable>filename</replaceable>.o.uu></filename>.</para>
+      </listitem>
+
+      <listitem>
+        <para>Kernel files;</para>
+
+        <orderedlist>
+          <listitem>
+            <para>Should always be referenced in
+              <filename>conf/files.*</filename> (for build simplicity).</para>
+	  </listitem>
+
+          <listitem>
+            <para>Should always be in <filename>LINT</filename>, but the <link 
+              linkend="staff-core">Core team</link> decides per case if it
+	      should be commented out or not.  The <link
+	      linkend="staff-core">Core team</link> can, of course, change
+	      their minds later on.</para>
+          </listitem>
+
+          <listitem>
+            <para>The <link linkend="staff-who">Release Engineer</link>
+              decides whether or not it goes in to the release.</para>
+          </listitem>
+        </orderedlist>
+      </listitem>
+
+      <listitem>
+        <para>User-land files;</para>
+
+        <orderedlist>
+          <listitem>
+            <para>The <link linkend="staff-core">Core team</link> decides if
+              the code should be part of <command>make world</command>.</para>
+          </listitem>
+         
+          <listitem>
+            <para>The <link linkend="staff-who">Release Engineer</link>
+              decides if it goes in to the release.</para>
+          </listitem>
+        </orderedlist>
+      </listitem>
+    </orderedlist>
   </sect1>
   
   <sect1 id="policies-shlib">


$B$/$j$d$^(B // kuriyama@sky.rim.or.jp
        // kuriyama@FreeBSD.ORG
