[Issue 1919] New: StringWriter docs are completely unclear

[d-bugmail at puremagic.com]

http://d.puremagic.com/issues/show_bug.cgi?id=1919

           Summary: StringWriter docs are completely unclear
           Product: D
           Version: unspecified
          Platform: PC
               URL: http://www.digitalmars.com/d/2.0/phobos/std_format.html#
                    StringWriter
        OS/Version: Linux
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Phobos
        AssignedTo: bugzilla at digitalmars.com
        ReportedBy: jlquinn at optonline.net


The docs for StringWriter are as follows:

struct StringWriter(Char);
    Implements the static Writer interface for a string. Instantiate it with
the character type, e.g. StringWriter!(char), StringWriter!(wchar), or
StringWriter!(dchar). Regardless of instantiation, StringWriter supports all
character widths; it only is the most efficient at accepting the character type
it was instantiated with.

This explanation generates a bunch of naive questions:

* What's the Writer interface (and don't make me search to find it)?
* What do I do with this struct?
* How does it accept chars?
* What does it do with the chars?


--