add some future-facing TODOs to the API interface
add some future-facing TODOs to the API interface

These amount to more than I planned on doing before R1... but I guess
nothing is stopping me from making an in between "-+R1" version. (I know
it sounds stupid, idc.)
rohlem/notelib,rohlem/notelib