[Issue 16993] New: Documentation for toSimpleString and toString does not explain how they differ

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=16993

          Issue ID: 16993
           Summary: Documentation for toSimpleString and toString does not
                    explain how they differ
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: dlang.org
          Assignee: nobody at puremagic.com
          Reporter: bachmeil at yahoo.com

In the documentation for std.datetime.toString, the only thing there is

"Converts this DateTime to a string."

These two return the same output as far as I can tell:

writeln(DateTime(Date(2010, 7, 4), TimeOfDay(7, 6, 12)).toString);
writeln(DateTime(Date(2010, 7, 4), TimeOfDay(7, 6, 12)).toSimpleString);

There should be an explanation of how they differ so that the reader knows when
to use one or the other.

--