# Notes related to an OpenAFS 1.8 branch
-The current plan is to make a branch for 1.8 off of master in early July 2014.
+The current plan is to make a branch for 1.8 off of master on or about
+24 September 2014.
This will allow all of the improvements and cleanup that have accumulated
on master to be in a stable release series, while letting potentially
destabilizing changes such as rxgk and pthreaded bos land on master to
Things to be done pre-branching:
-* Make libtool export symbol lists generated by configure (maybe?)
+* [done] Make roken, hcrypto, and kopenafs use libtool to build
+* [done] Make sure libtool is used properly elsewhere, in particular to install
+ shared versions of libafsrpc and libafsauthent, which we ship in
+ 1.6 but do not currently install on master
+* [done] Relatedly, verify that the libraries we do ship do not depend on things
+ that we don't ship.
+* [done; unfeasible]
+ (Optional) Look at the feasibility of installing shared liboafs_foo,
+ and using dynamic linkage for the client utilities.
+* (rxosd is not going to make it unless someone steps up to do the work;
+ we can't block the branch indefinitely on it.)
+* Do install and run testing on various platforms; check for memory leaks
+ in servers, etc..
+* Relatedly, check that the kernel module is properly built and loadable
+ on a variety of linuxen.
+* [done] Draft Debian packaging (which will help with a lot of the libtool
+ validation).
+* [done] Whitespace cleanup.
+* Any other tree-wide cleanup that people want to get in.
+* [partially? done]
+ Adjust the default behavior of configure (pthreaded ubik? more?)
+* Beg and plead for documentation updates.
+* [done] Tie the installation of the pam module to --enable/disable-kauth
+* fix issues with HOST_TO_ZERO and tmay (see gerrit 11287/11290 and related)
+
+Things to be done before 1.8 release (but not necessarily before branching):
+
+* Go through outstanding changes against master and determine
+ which should get pulled in for 1.8
+* Documentation fixes needed before release but not necessarily
+ before branch: KeyFileExt, converting keys from 1.6 to 1.8 format, ...
+* Investigate volume header update issues; volume update time is not
+ changed by admin operations that alter metadata such as quota, which
+ could subsequently get lost.
+* Investigate whether vos release -stayup should be removed.
+* Investigate "lockless path through d_revalidate" for potential issues (?)
Things to be removed from 1.8 post-branch:
* `src/rxgk`; it is not going to be usable in 1.8
+* `src/mcas`; it is not going to be usable in 1.8
Things to be removed from master post-branch:
`tbudb` and/or `tbutc` are ready.
* push to empty out libutil as much as possible.
* rip out LWP support
-* it is tempting to remove kauth, but probably not possible.
+* it is tempting to remove kauth, but probably not possible due to agreements with IBM.
+* `make dest` support? Pretty-please?
+* upserver
+* non-DA fileserver and associated bitmap-later and fast-restart configure knobs