boostorg/iostreams

Object Lifetimes documentation missing.

roccomoretti opened this issue · 0 comments

The User Guide section "3.7 Object Lifetimes" (https://github.com/boostorg/iostreams/blob/develop/doc/guide/lifetimes.html) has been labeled as [To be supplied in the next release] for approximately the past 18 years.

Some documentation on the lifetime assumptions about the sources/sinks/filters (e.g. do streams/steam_buffers do any lifetime management of the objects passed to them, or is it all up to the caller?) In particular, what happens when the devices are filesystem objects? (e.g. do the streams do any open/close/flush management?) This mailing list post indicates that it might be more complicated than one might first think -- though that post is ~18 years old, so things might be simplified with the next release 😉.