www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 8086] New: std.stdio is underdocumented

reply d-bugmail puremagic.com writes:
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



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: -------
May 11 2012
parent d-bugmail puremagic.com writes:
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



04:51:19 PDT ---

 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: -------
Jul 17 2013