id	summary	reporter	owner	description	type	status	priority	milestone	component	resolution	keywords	cc	branch	branch_author	launchpad_bug
3313	IHalfCloseableProtocol docstring is misleading	itamar	cary	"IHalfCloseableProtocol.readConnectionLost docs say:

{{{
""In addition, the protocol MUST make sure a reference to it still exists (i.e. by doing a callLater with one of its methods, etc.) as the reactor will only have a reference to it if it is writing.""
}}}

Really they should be explaining you need to keep a reference to the object, period, or you won't have any way to trigger writing (since there will be no more dataReceived events to rely on.) The reference to reactor is correct but misleading, it's symptom of our lack of references to file descriptors that are neither registered as writeable nor readable."	enhancement	new	normal		core		documentation	itamar jknight