[Issue 367] New: Bad ddoc comments in std.stream

[d-bugmail at puremagic.com]

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

           Summary: Bad ddoc comments in std.stream
           Product: D
           Version: unspecified
          Platform: PC
        OS/Version: Windows
            Status: NEW
          Keywords: ddoc, spec
          Severity: normal
          Priority: P2
         Component: Phobos
        AssignedTo: bugzilla at digitalmars.com
        ReportedBy: chris at dprogramming.com


std.stream line 389:

  protected bool readEOF = false; /// Indicates whether this stream is at eof
                                 /// after the last read attempt.

  protected bool prevCr = false; /// For a non-seekable stream indicates that
                                /// the last readLine or readLineW ended on a
                                /// '\r' character. 

  this() {}

Notice that the last readEOF comment actually goes with prevCr and the last 2
comments of prevCr end up going with the constructor. The resulting
documentation is pretty confusing and incorrect.


--