www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 511] New: Various problems in the documentation

reply d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511

           Summary: Various problems in the documentation
           Product: D
           Version: 0.174
          Platform: PC
        OS/Version: Windows
            Status: NEW
          Keywords: spec
          Severity: normal
          Priority: P4
         Component: www.digitalmars.com
        AssignedTo: bugzilla digitalmars.com
        ReportedBy: deewiant gmail.com
 BugsThisDependsOn: 508,509,510


With the upcoming release of D 1.0, I decided to take it upon myself to go
through the documentation and note any inconsistencies, typos, errors, etc.

I'll be posting a plaintext attachment for each page of the documentation as 
soon as I'm done with one, listing problems and possible solutions.

Where there's a complete contradiction with compiler behaviour and the spec,
it'll be separately filed in the Bugzilla. This bug is marked as depending on
those bugs.

I won't go through the formal parts of the spec (LinkageAttribute,
ScopeStatement... *head explodes*) and I'll try to avoid skimming too much,
instead attempting to actually read every sentence in order to ensure I catch
every single typo.

Large missing sections aren't mentioned here: this is only for lots of small
corrections. For instance, the fact that functions taking arrays can be called
as properties of arrays is (still) not mentioned anywhere in the spec, but it
won't be listed below. If the feature were used in an example but not
explained, then it would be listed. This is essentially just because I can't
remember every single feature of D and I'm just woefully unfamiliar with others
(mostly template-related stuff), so I don't notice that something is missing,
whereas it's easy to see that something is mentioned only partially or
incorrectly.

All nontrivial example code will be tested in the latest version of DMD (0.174
at time of writing, and hopefully also at time of completion), and corrections
will be noted to all of that, as well, below.

With thanks to the Doc Comments at the Wiki4D:
http://www.prowiki.org/wiki4d/wiki.cgi?DocComments - after processing a page
myself I'll check for anything I've missed there, and it's already proved
helpful, though I've only completed two pages so far.

- Matti "Deewiant" Niemenmaa, 2006-11-15

--

Format:

PROBLEMs are actual problems, e.g. non-compiling or incorrect example code, or
blatantly incorrect or outdated information in the text or comments.

MISSINGs are situations where something that should be mentioned for
clarification is not, leading to unclear documentation.

NITPICKs are minor, e.g. spelling mistakes in non-code sections or code
comments I see as confusing.

Suggested SOLUTIONs provided where it isn't completely obvious from the problem
description.


-- 
Nov 15 2006
next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #1 from deewiant gmail.com  2006-11-15 05:43 -------
Well, it seems that attaching doesn't work at this time - Bugzilla throws
internal errors in my face. I've emailed Brad about the issue. Until it's
fixed, this bug is unfortunately fairly useless, but after that, I'll add the
"patch" keyword and attach a bunch of files.


-- 
Nov 15 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #2 from deewiant gmail.com  2006-11-15 07:59 -------
Created an attachment (id=44)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=44&action=view)
Listing for http://www.digitalmars.com/d/abi.html


-- 
Nov 15 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #3 from deewiant gmail.com  2006-11-15 08:00 -------
Created an attachment (id=45)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=45&action=view)
Listing for http://www.digitalmars.com/d/arrays.html


-- 
Nov 15 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #4 from deewiant gmail.com  2006-11-15 08:00 -------
Created an attachment (id=46)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=46&action=view)
Listing for http://www.digitalmars.com/d/attribute.html


-- 
Nov 15 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #5 from deewiant gmail.com  2006-11-15 08:00 -------
Created an attachment (id=47)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=47&action=view)
Listing for http://www.digitalmars.com/d/class.html


-- 
Nov 15 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #6 from deewiant gmail.com  2006-11-15 08:02 -------
Created an attachment (id=49)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=49&action=view)
Patch for word count at http://www.digitalmars.com/d/arrays.html

This is all for now. I'll be back with more on the weekend.


-- 
Nov 15 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


smjg iname.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |smjg iname.com




------- Comment #7 from smjg iname.com  2006-11-16 19:23 -------
*** Bug 181 has been marked as a duplicate of this bug. ***


-- 
Nov 16 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
  Attachment #49 is|0                           |1
           obsolete|                            |




------- Comment #8 from deewiant gmail.com  2006-11-18 05:49 -------
Created an attachment (id=51)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=51&action=view)
Corrected patch for word count at http://www.digitalmars.com/d/arrays.html

Made a major screwup in the original patch, corrected that now.

I realised this when I found the original version of the code at
www.digitalmars.com/d/cppstrings.html.

Updated wc.patch attached. It applies to the original code at
www.digitalmars.com/d/arrays.html, not the version created after applying the
previous patch.

Changes in addition to those in the original:
        - foreach loop has an added "j" index, keeping the original "j"s as
"j"s instead of turning them into "i"s
        - the output loop at the end of the program uses the sorted keys array
to match the version at cppstrings.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #9 from deewiant gmail.com  2006-11-18 06:41 -------
Created an attachment (id=52)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=52&action=view)
Listing for www.digitalmars.com/d/cppstrings.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #10 from deewiant gmail.com  2006-11-18 06:41 -------
Created an attachment (id=53)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=53&action=view)
Listing for www.digitalmars.com/d/cpptod.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #11 from deewiant gmail.com  2006-11-18 06:41 -------
Created an attachment (id=54)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=54&action=view)
Listing for www.digitalmars.com/d/ctod.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #12 from deewiant gmail.com  2006-11-18 06:42 -------
Created an attachment (id=55)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=55&action=view)
Listing for www.digitalmars.com/d/dbc.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #13 from deewiant gmail.com  2006-11-18 06:42 -------
Created an attachment (id=56)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=56&action=view)
Listing for www.digitalmars.com/d/dcompiler.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #14 from deewiant gmail.com  2006-11-18 06:42 -------
Created an attachment (id=57)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=57&action=view)
Listing for www.digitalmars.com/d/ddoc.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #15 from deewiant gmail.com  2006-11-18 06:42 -------
Created an attachment (id=58)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=58&action=view)
Listing for www.digitalmars.com/d/declaration.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #16 from deewiant gmail.com  2006-11-18 06:43 -------
Created an attachment (id=59)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=59&action=view)
Listing for www.digitalmars.com/d/dlinks.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #17 from deewiant gmail.com  2006-11-18 06:43 -------
Created an attachment (id=60)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=60&action=view)
Listing for www.digitalmars.com/d/dll.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #18 from deewiant gmail.com  2006-11-18 06:43 -------
Created an attachment (id=61)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=61&action=view)
Listing for www.digitalmars.com/d/enum.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #19 from deewiant gmail.com  2006-11-18 06:44 -------
Created an attachment (id=62)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=62&action=view)
Listing for www.digitalmars.com/d/errors.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #20 from deewiant gmail.com  2006-11-18 06:44 -------
Created an attachment (id=63)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=63&action=view)
Listing for www.digitalmars.com/d/exception-safe.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #21 from smjg iname.com  2006-11-18 07:04 -------
(In reply to comment #11)
 Created an attachment (id=54)

 Listing for www.digitalmars.com/d/ctod.html

`PROBLEM: Under "Formatted printing", the D code uses "import stdio;" which hasn't compiled for a very long time: use "import std.stdio".` I don't think "import stdio;" has ever worked. The std package was established long before std.stdio was invented. Moreover, it should be pointed out that printf shouldn't be mentioned at all under "The D way". To repeat the C way before giving the real D solution is inconsistent with the format of the rest of the page and the other conversion pages. --
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #22 from deewiant gmail.com  2006-11-18 07:08 -------
Created an attachment (id=64)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=64&action=view)
Listing for www.digitalmars.com/d/expression.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #23 from smjg iname.com  2006-11-18 07:09 -------
(In reply to comment #12)
 Created an attachment (id=55)

 Listing for www.digitalmars.com/d/dbc.html

"SOLUTION: Replace long with float, double, or real, or use casts." Using casts won't help the out contract to succeed. However, what will help is to change it to out (result) { assert(result * result <= x); assert((result + 1) * (result + 1) > x); } --
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #24 from smjg iname.com  2006-11-18 07:12 -------
The http:// has disappeared from your attachment descriptions.  It is nice to
be able to get to the pages of the spec straight from the comments here.


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #52|Listing for                 |Listing for
        description|www.digitalmars.com/d/cppstr|http://www.digitalmars.com/d
                   |ings.html                   |/cppstrings.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #53|Listing for                 |Listing for
        description|www.digitalmars.com/d/cpptod|http://www.digitalmars.com/d
                   |.html                       |/cpptod.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #54|Listing for                 |Listing for
        description|www.digitalmars.com/d/ctod.h|http://www.digitalmars.com/d
                   |tml                         |/ctod.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #55|Listing for                 |Listing for
        description|www.digitalmars.com/d/dbc.ht|http://www.digitalmars.com/d
                   |ml                          |/dbc.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #56|Listing for                 |Listing for
        description|www.digitalmars.com/d/dcompi|http://www.digitalmars.com/d
                   |ler.html                    |/dcompiler.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #57|Listing for                 |Listing for
        description|www.digitalmars.com/d/ddoc.h|http://www.digitalmars.com/d
                   |tml                         |/ddoc.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #58|Listing for                 |Listing for
        description|www.digitalmars.com/d/declar|http://www.digitalmars.com/d
                   |ation.html                  |/declaration.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #59|Listing for                 |Listing for
        description|www.digitalmars.com/d/dlinks|http://www.digitalmars.com/d
                   |.html                       |/dlinks.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #60|Listing for                 |Listing for
        description|www.digitalmars.com/d/dll.ht|http://www.digitalmars.com/d
                   |ml                          |/dll.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #61|Listing for                 |Listing for
        description|www.digitalmars.com/d/enum.h|http://www.digitalmars.com/d
                   |tml                         |/enum.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #62|Listing for                 |Listing for
        description|www.digitalmars.com/d/errors|http://www.digitalmars.com/d
                   |.html                       |/errors.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #63|Listing for                 |Listing for
        description|www.digitalmars.com/d/except|http://www.digitalmars.com/d
                   |ion-safe.html               |/exception-safe.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #64|Listing for                 |Listing for
        description|www.digitalmars.com/d/expres|http://www.digitalmars.com/d
                   |sion.html                   |/expression.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #25 from deewiant gmail.com  2006-11-18 07:15 -------
(In reply to comment #23)
 Using casts won't help the out contract to succeed.

You're right, my mistake: of course casting the result to a floating point type won't magically bring back what was lost in truncating to a long.(In reply to comment #24) (In reply to comment #24)
 The http:// has disappeared from your attachment descriptions.  It is nice to
 be able to get to the pages of the spec straight from the comments here.
 

Fixed. That _was_ why I originally had it there, I just forgot about it today. --
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #26 from deewiant gmail.com  2006-11-18 07:37 -------
Created an attachment (id=65)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=65&action=view)
Listing for http://www.digitalmars.com/d/faq.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #27 from deewiant gmail.com  2006-11-18 09:11 -------
Created an attachment (id=66)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=66&action=view)
Listing for http://www.digitalmars.com/d/float.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #28 from deewiant gmail.com  2006-11-18 10:07 -------
Created an attachment (id=67)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=67&action=view)
Listing for http://www.digitalmars.com/d/function.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #29 from deewiant gmail.com  2006-11-18 10:12 -------
Created an attachment (id=68)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=68&action=view)
Listing for http://www.digitalmars.com/d/future.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #30 from deewiant gmail.com  2006-11-18 10:16 -------
Created an attachment (id=69)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=69&action=view)
Listing for www.digitalmars.com/d/garbage.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #31 from deewiant gmail.com  2006-11-18 10:30 -------
Created an attachment (id=70)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=70&action=view)
Listing for http://www.digitalmars.com/d/htomodule.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #32 from deewiant gmail.com  2006-11-18 10:45 -------
Created an attachment (id=71)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=71&action=view)
Listing for http://www.digitalmars.com/d/interfaceToC.html

I skipped http://www.digitalmars.com/d/iasm.html since I don't know enough
Assembly language to have any kind of reasonable opinion on the contents.


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


deewiant gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Attachment #69|Listing for                 |Listing for
        description|www.digitalmars.com/d/garbag|http://www.digitalmars.com/d
                   |e.html                      |/garbage.html




-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #33 from deewiant gmail.com  2006-11-18 13:19 -------
(In reply to comment #18)
 Created an attachment (id=61)

 Listing for www.digitalmars.com/d/enum.html
 

Having come across property.html, I think it would be best to just link to that and say that enums are integral types. That, or add .sizeof, .alignof, and .mangleof to the list as well. --
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #34 from deewiant gmail.com  2006-11-18 13:20 -------
Created an attachment (id=72)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=72&action=view)
Listing for http://www.digitalmars.com/d/memory.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #35 from deewiant gmail.com  2006-11-18 13:20 -------
Created an attachment (id=73)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=73&action=view)
Listing for http://www.digitalmars.com/d/operatoroverloading.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #36 from deewiant gmail.com  2006-11-18 13:20 -------
Created an attachment (id=74)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=74&action=view)
Listing for http://www.digitalmars.com/d/statement.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #37 from deewiant gmail.com  2006-11-18 13:21 -------
Created an attachment (id=75)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=75&action=view)
Listing for http://www.digitalmars.com/d/template.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #38 from deewiant gmail.com  2006-11-18 13:21 -------
Created an attachment (id=76)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=76&action=view)
Listing for http://www.digitalmars.com/d/templates-revisited.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #39 from deewiant gmail.com  2006-11-18 13:21 -------
Created an attachment (id=77)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=77&action=view)
Listing for http://www.digitalmars.com/d/type.html


-- 
Nov 18 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #40 from deewiant gmail.com  2006-11-18 13:24 -------
Created an attachment (id=78)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=78&action=view)
Listing for http://www.digitalmars.com/d/warnings.html

Phew! That's all folks.

I won't be going through the Phobos documentation, at least right now: it's
quite a bit more work since there are quite a bit more holes. To go through it
in any reasonable way would practically require writing a large part of it
again.


-- 
Nov 18 2006
prev sibling next sibling parent Walter Bright <newshound digitalmars.com> writes:
d-bugmail puremagic.com wrote:
 - Matti "Deewiant" Niemenmaa, 2006-11-15

You've put a lot of work into this. Thanks!
Nov 27 2006
prev sibling next sibling parent reply d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #41 from deewiant gmail.com  2006-12-03 05:16 -------
Most changes folded in for DMD 0.176. The following issues, mostly of type
NITPICK, remain (note that I didn't go through the pages thoroughly again, I
just checked the changes I had already marked and their immediate vicinity):

http://www.digitalmars.com/d/class.html
        Under "Constructors", there is a code snippet "this() { if (a) ?
this(1) : super(); }   // ok" which is syntactically invalid. Remove the "if".

http://www.digitalmars.com/d/ctod.html
        Under "Struct Initializations", there's an incorrect apostrophe in
"{}'s".
        Under "Declaring struct types and variables", there's an excessive
ampersand in the last sentence.

http://www.digitalmars.com/d/dbc.html
        Under "In, Out and Inheritance" only one of the "satisified" typos was
corrected to "satisfied".

http://www.digitalmars.com/d/expression.html
        The last code block under "IsExpression" refers to x in a comment,
while it should say v.

http://www.digitalmars.com/d/faq.html
        Under "Why are floating point values default initialized to NaN rather
than 0?" the word "NaN's", with an incorrect apostrophe, is used instead of
"NaNs".

http://www.digitalmars.com/d/operatoroverloading.html
        Under "Overloading == and !=" it is stated that that "if (a == null)"
is converted to "if (a.opCmp(null)) which will fail if opCmp() is a virtual
function". It should say opEquals instead of opCmp.

http://www.digitalmars.com/d/templates-revisited.html
        Under "SFINAE - Substitution Failure Is Not An Error" the last code
snippet asserts when run: to fix it, change "typedef" to "alias", matching the
change made to http://www.digitalmars.com/d/cpptod.html.


-- 
Dec 03 2006
parent Bruno Medeiros <brunodomedeiros+spam com.gmail> writes:
d-bugmail puremagic.com wrote:
 http://d.puremagic.com/issues/show_bug.cgi?id=511
 
 ------- Comment #41 from deewiant gmail.com  2006-12-03 05:16 -------
 Most changes folded in for DMD 0.176. The following issues, mostly of type
 NITPICK, remain (note that I didn't go through the pages thoroughly again, I
 just checked the changes I had already marked and their immediate vicinity):
 

Have you considered reviewing spec diffs between releases, so that it is practical to fully keep up with release changes? -- Bruno Medeiros - MSc in CS/E student http://www.prowiki.org/wiki4d/wiki.cgi?BrunoMedeiros#D
Dec 09 2006
prev sibling next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511





------- Comment #42 from brunodomedeiros+bugz gmail.com  2006-12-09 07:07
-------
A Problem in http://www.digitalmars.com/d/function.html ,
in Lazy Variadic Functions, the following code segment is wrong:
  int delegate[] dg;
  foo(1, 3+x, dg, cast(int delegate[])null);
Should be:
  int delegate() dg;
  foo(1, 3+x, dg, cast(int delegate())null);


-- 
Dec 09 2006
prev sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=511


bugzilla digitalmars.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|                            |FIXED




------- Comment #43 from bugzilla digitalmars.com  2006-12-09 21:09 -------
Fixed DMD 0.177


-- 
Dec 09 2006