-
Notifications
You must be signed in to change notification settings - Fork 6
Open
Labels
Description
As discussed in #28 , in an ideal world, peek_output_buffer() would be called output_buffer(), and output_buffer() would be called output_buffer_mut(). And the input_buffer() API would work similarly. But that's a breaking API change, so ideally it would be done gradually.
- First, publish a minor release that adds
input_buffer_mut()andoutput_buffer_mut()methods and throws a deprecation warning when callinginput_buffer()oroutput_buffer()(which are now aliases to these methods), with a warning that their semantics are going to change to read-only in the future. - Next, a few months to a year later, publish a major release which changes
input_buffer()andoutput_buffer()to read-only access, removes the deprecation warning, and deprecates thepeek_output_buffer()method. - Finally, a few months to a year later, publish another major release which removes the
peek_output_buffer()method.
crop2000 and PatrickKasting