Add UPDATING note on /usr/dports
[dragonfly.git] / UPDATING
1 $DragonFly: src/UPDATING,v 1.3 2003/09/08 23:50:34 dillon Exp $
2
3 Updating Information for DragonFly users.
4
5 This file should warn you of any pitfalls which you might need to work around
6 when trying to update your DragonFly system.
7
8 If you discover any problem, please contact the bugs@lists.dragonflybsd.org
9 mailing list with the details.
10
11 ------------------------------------------------------------------------------
12
13 > Compiling DragonFly
14 ---------------------
15
16 Compiling DragonFly requires an ISO C90 or higher compliant compiler.
17 Compilers which support this are, amongst others: The GNU C Compiler, The
18 Intel C++ Compiler, and The TenDRA Compiler.
19
20 > Include files
21 ---------------
22
23 Due to the source tree reorganization header files have moved to different
24 locations.  The ufs/ufs directory, for example, now can be found at vfs/ufs.
25 ufs/ffs can be found in vfs/ufs as well.
26
27 Best thing to do would be to rm -rf /usr/include and from /usr/src do a 'make
28 includes'.  This should repopulate your entire tree.
29
30 > Linux emulation
31 -----------------
32
33 Right now there is a reported problem with the Linux emulation layer not
34 working properly.  This should be fixed soon.
35
36 > Kerberos IV
37 -------------
38
39 Kerberos IV (eBones) was removed from the tree, please consider moving to
40 Kerberos 5 (Heimdal).
41
42 > FreeBSD and DragonFly ports
43 -----------------------------
44
45 DragonFly will eventually have its own package management system but at the
46 moment we leverage off of the FreeBSD ports system.  You should maintain
47 /usr/ports from the FreeBSD cvs repository via cvsup just like you do now.
48
49 DragonFly has its own 'port overrides' hierarchy in /usr/dports.  You can
50 check this out of the DragonFly cvs repository using:
51
52 cd /usr
53 cvs -R -d /cvs checkout dports
54
55 You may wish to use a consolidated distfiles directory, in which case you
56 should make /usr/dports/distfiles a softlink to your existing distfiles
57 directory (typically /usr/ports/distfiles).
58
59 Be sure that you have installed 'relpath' from the DragonFly sources
60 (/usr/src/usr.bin/relpath) as well as the updated /usr/share/mk files from
61 /usr/src/share/mk.  As a test you can cd into /usr/ports/sysutils/cpdup and
62 build the port.  Dragonfly should contain an override and you should see a
63 warning message that the DragonFly override is being build instead when you
64 build it from the FreeBSD ports.
65