std.serialization: pre-voting review / discussion

[Jacob Carlborg]

On 2013-08-20 20:04, Walter Bright wrote:

> You can hide comments from ddoc by not starting them with /** but with /*

Yeah, I know that.

> Doesn't make sense to me. I would think the archive would be what is
> created, not the creator.

I guess it could be called "archiver", or do you have a better suggestion?

> What confuses me here is the conflation between the archiveR and the
> resulting archive, i.e. "an archiver creates an archive". Saying
> "archive creates the archive" is a bit of a disastrous conflation of the
> terms, as it makes the documentation a constant source of confusion.

Would calling it "archiver" or some other name be better?

> Some exposition of this is necessary, along with some comments along the
> line that the package provides a generic archiving interface, and a
> couple implementations X and Y of that interface, and that other
> implementations such as Z, the zip archiver, are possible.

I don't understand what's so confusing.

"This is the interface all archive implementations need to implement to 
be able to be used as an archive with the serializer".

-- 
/Jacob Carlborg