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

           Summary: std.stdio is underdocumented
           Product: D
           Version: D2
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Phobos
        AssignedTo: nobody@puremagic.com
        ReportedBy: bugzilla@digitalmars.com


--- Comment #0 from Walter Bright <bugzilla@digitalmars.com> 2012-05-11 12:13:37 PDT ---
1. byLine is documented to return a LinesReader, but that is the only mention of LinesReader anywhere

2. stdin and stdout are mentioned in passing several times, but they need their own entries explaining what they are

3. LinesReader should say that it has an element type of dchar, decoding UTF8 as required

4. The canoncial program to read from stdin and write to stdout should be given as an example:

import std.stdio;
import std.algorithm;

void main() {
    stdin.byChunk(1024).copy(stdout.lockingTextWriter());
}

5. byChunk should document what its element type is

6. byDchar is undocumented

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------

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


Nick Treleaven <ntrel-public@yahoo.co.uk> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |ntrel-public@yahoo.co.uk


--- Comment #1 from Nick Treleaven <ntrel-public@yahoo.co.uk> 2013-07-17 04:51:19 PDT ---
(In reply to comment #0)
> 1. byLine is documented to return a LinesReader, but that is the only mention of LinesReader anywhere

Now fixed in git master.

...
> 3. LinesReader should say that it has an element type of dchar, decoding UTF8 as required

Assuming you meant ByLine, byLine now documents that the element type is Char[]. UTF8 decoding is not mentioned though.

...
> 6. byDchar is undocumented

Doesn't seem to exist now.

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------