questions on PhanTango 'merger' (was Merging Tangobos into Tango)- long-term vision
Kris
foo at bar.com
Wed Oct 10 22:35:51 PDT 2007
"BCS" <ao at pathlink.com> wrote in message
news:ce0a33432476f8c9d9a29608a586 at news.digitalmars.com...
> I'd say a bunch here but most of it would just echo Bill. A few points
> though:
>
> I have a project that uses only selective imports and has a filter in the
> build script to list the imported symbols. here is the list
>
> File
> FileMode
> MemoryStream
> ReadException
> SeekPos
> Stream
> pow
> toString
> toUTF16
> toUTF8
> writef
That's useful. Cheers!
>
> Just for reference...
>
> Another thing. as far as docs go. Tango could use some work. What I ant to
> see is, for each sub system, a overview of what it is, how it works (500
> ft overview of the whole sub-system) and how to use it. Ideally, this
> would all fit on one screen so two, maybe three paragraphs. As an example
> I'll use the IO stuff (the lack of this exact kind of docs for the IO
> subsystem is one of the *primary reasons* I don't use Tango [*HINT HINT
> HINT* flashing red 48pt font]):
Duly noted :)
> what I'd want would be a description of what the parts are, and how they
> fit together. Here is an example of the type of overview I would want:
>
> "a Foo is a source or sink for data like a file or network connection. A
> Baz is a pass though filter that does something to it like compression or
> encryption. A Bar is a near side end for interfacing with IO, it allows
> you to format data, wright raw data, read data, parse data, etc. If you
> want to do something like multiplex many data paths over one, you will
> need to implement the Baz interface."
>
> That would be a good start. Then go into a bit more detail about what each
> part is expected to do.
That's great. Succinct and to the point. You want a job? :p
Seriously though, you're absolutely right. Thanks
More information about the Digitalmars-d
mailing list