Add a place to talk about 1.8 branching TODO items
[openafs-wiki.git] / OpenAFS18Notes.mdwn
1 # Notes related to an OpenAFS 1.8 branch
2
3 The current plan is to make a branch for 1.8 off of master in early July 2014.
4 This will allow all of the improvements and cleanup that have accumulated
5 on master to be in a stable release series, while letting potentially
6 destabilizing changes such as rxgk and pthreaded bos land on master to
7 settle.
8
9 A 1.8 release would also bring the possibility of using shared libraries, 
10 which are now available with the use of libtool.  Currently (on master),
11 all executable binaries are still linked mostly statically, and most of
12 the shared libraries that are produced during the build are not installed
13 to the destination tree.  Exceptions are libafshcrypto.so, libkopenafs.so,
14 and librokenafs.so.  We could consider installing more shared libraries,
15 and using dynamic linking for executables, either before or after the
16 branch point.  Doing so would involve deciding on what sorts of ABI
17 stability guarantees should be provided.
18
19 The remainder of this page has three separate lists, for things to be
20 done before branching, things to be removed from the 1.8 branch after
21 it is created, and things to be removed from master after the 1.8 branch
22 is created.
23
24 Things to be done pre-branching:
25 * Make libtool export symbol lists generated by configure (?)
26
27 Things to be removed from 1.8 post-branch:
28 * `src/rxgk`; it is not going to be usable in 1.8
29
30 Things to be removed from master post-branch:
31 * Several `tfoo` can probably be moved to just `foo`; things like
32   `tptserver`, `tvlserver`, `tvolser`, `tsalvaged`.  I'm not sure whether
33   `tbudb` and/or `tbutc` are ready.
34 * push to empty out libutil as much as possible.
35 * rip out LWP support
36 * it is tempting to remove kauth, but probably not possible.