Re: [Boost-users] [Boost.Iostreams] Question about gzip codecanddual_use filter

From: Marc Viala Perso (marc.viala_at_[hidden])
Date: 2008-01-22 10:03:40

> bounces_at_[hidden]] De la part de Jonathan Turkanis
> 
> eg wrote:
> 
>  > I think a small section in the tutorial (with a simple example) on
>  > implementing symmetric_filters might be useful. I recall this has come
>  > up a few times on the list. It is hard for new users to tease out the
>  > nuances of the iostreams aspects of symmetric_filters by only looking
>  > at the supplied zlib and bzip2 filter implementations.
> 
> Michael Linck wrote:
> > I haven't posted to this list in a while, but I noticed this discussion
> > going on.  I actually made use of the boost::iostream stuff a few months
> > back and I can confirm that, while the documentation is plentiful, and
> > good for providing high level conceptual overview, it lacks some pretty
> > important details.  What I found most poignantly lacking was
> > documentation of exactly what interfaces filters, source and sinks
> > should implement to be used in the various streams.  This was spread out
> > throughout the docs, instead of being summarized in one place.  I
> > figured it out eventually, but it felt like a lot of guesswork, and
> > piecing things together from various chunks of documentation and header
> > files.  Honestly, it made me reconsider template programming altogether,
> > since it made me realize that the lack of an explicit interface can be
> > seriously frustrating and we don't have a standardized way of
> > documenting implicit interfaces yet.  Also, I noticed some interesting
> > behaviors.  Calling sync on a stream, didn't seem to call flush on my
> > filter, but the destructor did, causing some interesting side effects.
> >
> > - mike
> 
> Thanks, guys. I will try to improve the docs to address these concerns.

 [Marc Viala] This is a good new; just for giving a feedback about the
documentation, I'm sharing the same feeling that Micheal.

Marc