These days, it's a good idea to go ahead and draft that up early. You'llv2 is sent with the proposed man page
be surprised what sort of details you notice once you have to start
writing documentation. ;)
You can post it as part of this set on the next posting and just mention
that it's a draft manpage patch. You should also include the linux-api
mailing list on the next posting so we get some feedback on the
interface itself.