[Issue 1945] New: Inconsistent and confusing documentation

d-bugmail at puremagic.com d-bugmail at puremagic.com
Wed Mar 26 02:19:14 PDT 2008


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

           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 at digitalmars.com
        ReportedBy: caron800 at 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.


-- 



More information about the Digitalmars-d-bugs mailing list