www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 1945] New: Inconsistent and confusing documentation


           Summary: Inconsistent and confusing documentation
           Product: D
           Version: 2.012
          Platform: PC
               URL: http://digitalmars.com/d/2.0/tuple.html
        OS/Version: Windows
            Status: NEW
          Severity: normal
          Priority: P2
         Component: www.digitalmars.com
        AssignedTo: bugzilla digitalmars.com
        ReportedBy: caron800 googlemail.com

The documentation at http://digitalmars.com/d/2.0/tuple.html is inconsistent
with the documentation at http://digitalmars.com/d/2.0/phobos/std_typecons.html

Both pages define "Tuple" differently, however only std.typecons.Tuple is
correct. std.typecons.Tuple is consistent with the usage of the word "Tuple" in
all other programming languages. Therefore, this page should stay as is.

The article "Tuples" at http://digitalmars.com/d/2.0/tuple.html, however, needs
to be rewritten. I would suggest that the entities described on this page be
described as "variadic templates" (not "Tuples"), as that more accurately
describes the concept being described.

Mar 26 2008