From 2c9d19ec6fc69356dc6c2cf65ba1e3ff662bf8be Mon Sep 17 00:00:00 2001
From: Doug Barton <dougb@FreeBSD.org>
Date: Sat, 12 Jul 2008 08:46:21 +0000
Subject: The vendor area is the proper home for these files now.

---
 FREEBSD-Upgrade | 120 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 FREEBSD-Xlist   |  67 +++++++++++++++++++++++++++++++
 2 files changed, 187 insertions(+)
 create mode 100644 FREEBSD-Upgrade
 create mode 100644 FREEBSD-Xlist

diff --git a/FREEBSD-Upgrade b/FREEBSD-Upgrade
new file mode 100644
index 000000000000..75efb09f1e62
--- /dev/null
+++ b/FREEBSD-Upgrade
@@ -0,0 +1,120 @@
+
+
+	    FreeBSD maintainer's guide to updating BIND 9
+	    =============================================
+
+1) Obtain the latest source distribution from the ISC's FTP server
+   (ftp://ftp.isc.org/isc/bind9/)
+
+2) Unpack the tarball in a suitable directory, and cd into the new
+   source directory.
+
+3) Remove unwanted files and directories:
+
+	$ while read pattern ; do rm -rf $pattern ; done \
+		</usr/src/contrib/bind9/FREEBSD-Xlist
+
+   Make sure that took care of everything, and if it didn't, make sure
+   to update FREEBSD-Xlist so you won't miss it the next time.  A good
+   way to do this is to run a test import and see if any new files
+   show up:
+
+	$ cvs -q -n import src/contrib/bind9 ISC x | grep \^N
+
+4) Import the sources:
+
+	$ cvs import -m "Vendor import of BIND 9.X.Y" \
+		src/contrib/bind9 ISC BIND_9_X_Y
+
+5) Resolve conflicts.
+
+   As of 2 June 2007, we have no local patches against BIND 9; thus
+   there are no conflicts to merge.  This may change at a later date.
+
+5a) Remove any files that are no longer in the tarball from the vendor branch.
+
+6) Remove any references to the {bin,lib}/tests and docutil
+   directories from the configure and Makefile templates:
+
+	$ sed -i.orig -e '/\/tests/d; /docutil/d; /\/xsl/d;' \
+		configure.in Makefile.in */Makefile.in
+
+   Please do not commit this change, as it would unnecessarily take
+   files off the vendor branch.  You only need this to generate
+   config.h.
+
+7) Generate and run configure:
+
+	$ aclocal
+	$ autoheader
+	$ autoconf
+	$ ./configure --prefix=/usr \
+		--infodir=/usr/share/info --mandir=/usr/share/man \
+		--enable-threads --enable-libbind --disable-ipv6 \
+		--enable-getifaddrs --disable-linux-caps \
+		--with-openssl=/usr --with-randomdev=/dev/random
+
+   Note that we intentionally disable IPv6 support on the configure
+   command line; src/lib/bind/config.mk will re-enable it at compile
+   time if WITHOUT_INET6 is not defined.
+
+8) Copy the following generated files to src/lib/bind and commit them:
+
+	Path in src/contrib/bind9		Path in src/lib/bind
+	------------------------------------------------------------
+	s=/usr/src/lib/bind
+	cp config.h				${s}/config.h
+	cp lib/bind/config.h			${s}/bind/config.h
+	cp lib/bind/port_after.h		${s}/bind/port_after.h
+	cp lib/bind/port_before.h		${s}/bind/port_before.h
+	cp lib/isc/include/isc/platform.h	${s}/isc/isc/platform.h
+	cp lib/lwres/include/lwres/netdb.h	${s}/lwres/lwres/netdb.h
+	cp lib/lwres/include/lwres/platform.h	${s}/lwres/lwres/platform.h
+
+   Do not commit any other file that was modified or created in
+   steps 6) or 7).
+
+9) cd src/lib/bind/dns && make -DMAINTAINER_MODE generate && rm gen
+   Commit the new versions of the files generated.
+
+   The following directories contain Makefiles for bits and pieces of
+   BIND 9:
+
+	FreeBSD directory		ISC directory
+	========================================================
+	src/lib/bind			bind9/lib
+	src/lib/bind/bind		bind9/lib/bind
+	src/lib/bind/bind9		bind9/lib/bind9
+	src/lib/bind/dns		bind9/lib/dns
+	src/lib/bind/isc		bind9/lib/isc
+	src/lib/bind/isccc		bind9/lib/isccc
+	src/lib/bind/isccfg		bind9/lib/isccfg
+	src/lib/bind/lwres		bind9/lib/lwres
+	src/share/doc/bind9		bind9/doc/{arm,misc}
+	src/usr.bin/dig			bind9/bin/dig
+	src/usr.bin/host		bind9/bin/dig
+	src/usr.bin/nslookup		bind9/bin/dig
+	src/usr.bin/nsupdate		bind9/bin/nsupdate
+	src/usr.sbin/dnssec-keygen	bind9/bin/dnssec
+	src/usr.sbin/dnssec-signzone	bind9/bin/dnssec
+	src/usr.sbin/named		bind9/bin/named
+	src/usr.sbin/named-checkconf	bind9/bin/check
+	src/usr.sbin/named-checkzone	bind9/bin/check
+	src/usr.sbin/rndc		bind9/bin/rndc
+	src/usr.sbin/rndc-confgen	bind9/bin/rndc
+
+   Make sure that the lists of sources, headers and man pages in each
+   FreeBSD Makefile accurately reflects those in the corresponding ISC
+   Makefile.  Please strive to keep those lists in the same order and
+   with line breaks in the same places to ease future comparisons.
+
+A) Build and test.
+
+B) Lather, rinse, repeat.
+
+C) Commit when everything builds cleanly and works properly.
+
+					-- des@FreeBSD.org
+					-- dougb@FreeBSD.org
+
+$FreeBSD$
diff --git a/FREEBSD-Xlist b/FREEBSD-Xlist
new file mode 100644
index 000000000000..f4239557b3ae
--- /dev/null
+++ b/FREEBSD-Xlist
@@ -0,0 +1,67 @@
+# $FreeBSD$
+
+# Misc. stuff
+.cvsignore
+aclocal.m4
+config.h.in
+configure
+contrib
+docutil
+
+# Tests
+bin/tests
+lib/tests
+
+# Doc stuff
+doc/arm/latex-fixup.pl
+doc/xsl
+
+# Windows directories
+bin/check/win32
+bin/dig/win32
+bin/dnssec/win32
+bin/named/win32
+bin/nsupdate/win32
+bin/rndc/win32
+bin/win32
+config.h.win32
+lib/bind9/win32
+lib/dns/gen-win32.h
+lib/dns/win32
+lib/isc/win32
+lib/isccc/win32
+lib/isccfg/win32
+lib/lwres/win32
+lib/win32
+win32utils
+
+# Various ports to other OSs
+lib/bind/port/aix*
+lib/bind/port/aux3
+lib/bind/port/bsdos
+lib/bind/port/bsdos2
+lib/bind/port/cygwin
+lib/bind/port/darwin
+lib/bind/port/decunix
+lib/bind/port/hpux
+lib/bind/port/hpux10
+lib/bind/port/hpux9
+lib/bind/port/irix
+lib/bind/port/linux
+lib/bind/port/lynxos
+lib/bind/port/mpe
+lib/bind/port/netbsd
+lib/bind/port/next
+lib/bind/port/openbsd
+lib/bind/port/prand_conf
+lib/bind/port/qnx
+lib/bind/port/rhapsody
+lib/bind/port/sco42
+lib/bind/port/sco50
+lib/bind/port/solaris
+lib/bind/port/sunos
+lib/bind/port/ultrix
+lib/bind/port/unixware20
+lib/bind/port/unixware212
+lib/bind/port/unixware7
+lib/bind/port/unknown
-- 
cgit v1.2.3