xref: /freebsd/contrib/atf/FREEBSD-upgrade (revision abe0c5587d95844b74bf3bdb7c988ddba6c052de)
1701791c7SMarcel Moolenaar$FreeBSD$
2701791c7SMarcel Moolenaar
373cdac78SJulio MerinoThis document contains a collection of notes specific to the import
473cdac78SJulio Merinoof atf into head.  These notes are built on the instructions in
573cdac78SJulio Merinothe FreeBSD Subversion Primer that detail how to deal with vendor
673cdac78SJulio Merinobranches and you are supposed to follow those:
7701791c7SMarcel Moolenaar
873cdac78SJulio Merino	http://www.freebsd.org/doc/en/articles/committers-guide/subversion-primer.html
973cdac78SJulio Merino
104c998508SCraig RodriguesThe ATF source code is hosted on GitHub:
11701791c7SMarcel Moolenaar
124c998508SCraig Rodrigues	https://github.com/jmmv/atf
13701791c7SMarcel Moolenaar
1473cdac78SJulio Merinoand is imported into the atf vendor branch (see base/vendor/atf/).
15701791c7SMarcel Moolenaar
1673cdac78SJulio MerinoTo merge the vendor branch into head do something like this:
17701791c7SMarcel Moolenaar
1873cdac78SJulio Merino	cd .../base/head/contrib/atf
1973cdac78SJulio Merino	svn merge --accept=postpone \
2073cdac78SJulio Merino	    svn+ssh://svn.freebsd.org/base/vendor/atf/dist .
2173cdac78SJulio Merino	svn remove --force $(cat FREEBSD-Xlist)
22701791c7SMarcel Moolenaar
2373cdac78SJulio Merinoand resolve any conflicts that may arise at this point.
24701791c7SMarcel Moolenaar
2573cdac78SJulio MerinoOnce this is done, you must regenerate bconfig.h.  The recommended way
2673cdac78SJulio Merinoof doing so is by using the release files already imported into the
2773cdac78SJulio Merinovendor branch (which is a good justification for importing the verbatim
2873cdac78SJulio Merinosources in the first place so that this step is reproducible).  You can
2973cdac78SJulio Merinouse a set of commands similar to the following:
30701791c7SMarcel Moolenaar
3173cdac78SJulio Merino	mkdir /tmp/atf
3273cdac78SJulio Merino	cd /tmp/atf
3373cdac78SJulio Merino	.../vendor/atf/dist/configure \
3473cdac78SJulio Merino	    --prefix=/ \
3573cdac78SJulio Merino	    --exec-prefix=/usr \
3673cdac78SJulio Merino	    --datarootdir=/usr/share
3773cdac78SJulio Merino	cp bconfig.h .../base/head/contrib/atf/
38701791c7SMarcel Moolenaar
3973cdac78SJulio MerinoPlease do NOT run './configure' straight from the 'dist' directory of
4073cdac78SJulio Merinothe vendor branch as you easily risk committing build products into the
4173cdac78SJulio Merinotree.
42701791c7SMarcel Moolenaar
4373cdac78SJulio MerinoLastly, with the list of old and new files in this import, make sure
44*abe0c558SEnji Cooperto update the reachover Makefiles accordingly.
45701791c7SMarcel Moolenaar
4673cdac78SJulio MerinoTest the build (keeping in mind the WITH_TESTS/WITHOUT_TESTS knobs) and,
4773cdac78SJulio Merinoif all looks good, you are ready to commit all the changes in one go.
48