boostorg / iostreams

Boost.org iostreams module
http://boost.org/libs/iostreams
Boost Software License 1.0
43 stars 116 forks source link

Object Lifetimes documentation missing. #159

Open roccomoretti opened 1 year ago

roccomoretti commented 1 year ago

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 :wink:.