www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - Bits (pardon the pun) of the documentation that are out of date

reply Stewart Gordon <smjg_1998 yahoo.com> writes:
1. An oldie but a baddie - why are array operations still there?

A whole year ago it was announced that this feature was going to be 
dropped for 1.0.  And it's also been pointed out that the current spec 
for them is too ill-defined to implement.  Either is sufficient reason 
that it should have been removed ages ago.  The feature also might as 
well be mentioned on future.html.  If you've changed your mind and we 
are going to have array operations for 1.0, then how about replacing it 
with a better-defined spec, such as mine

digitalmars.D/16647

and implementing it?


2. overview.html still states that "D compilers will not generate 
warnings for questionable code" even though DMD has since 0.116.


3. Speaking of which, warnings.html is still in the old look.  And it 
isn't linked to from any of the nav bars.


4. The Tech Tips section is also still in the old look.  We ought to 
decide what to do with it.  Since it's D-oriented, would it make sense 
to make it a regular part of the D section of www.digitalmars.com rather 
than a borderline case of being a separate subsite?  And 
/techtips/windows_utf.html certainly needs updating - just tell people 
to use std.windows.charset rather than giving them code to copy and paste.


5. A new one and the one that made me think to post this at this time: 
overview.html still states that the bit as a basic type exists:

----------
Bit type

The fundamental data type is the bit, and D has a bit data type. This is 
most useful in creating arrays of bits:

bit[] foo;
----------

While it's still valid code with bit being an alias for bool, the 
mention of "arrays of bits" is misleading.  We should get rid of the 
section.  And the sieve example at the bottom of the page ought to be 
rewritten to use bool, considering the misleadingness of the bit[] 
notation now.


6. Implicit function template instantiation is now here but still listed 
on future.html.  Or are there plans for taking it further that need to 
be noted?


All of these are also raised on the relevant pages of

http://www.prowiki.org/wiki4d/wiki.cgi?DocComments

Stewart.

-- 
-----BEGIN GEEK CODE BLOCK-----
Version: 3.1
GCS/M d- s:- C++  a->--- UB  P+ L E  W++  N+++ o K-  w++  O? M V? PS- 
PE- Y? PGP- t- 5? X? R b DI? D G e++>++++ h-- r-- !y
------END GEEK CODE BLOCK------

My e-mail is valid but not my primary mailbox.  Please keep replies on 
the 'group where everyone may benefit.
Mar 15 2006
next sibling parent Stewart Gordon <smjg_1998 yahoo.com> writes:
7. MatchExpression is still there even though you decided to get rid of it.

Stewart.

-- 
-----BEGIN GEEK CODE BLOCK-----
Version: 3.1
GCS/M d- s:- C++  a->--- UB  P+ L E  W++  N+++ o K-  w++  O? M V? PS- 
PE- Y? PGP- t- 5? X? R b DI? D G e++>++++ h-- r-- !y
------END GEEK CODE BLOCK------

My e-mail is valid but not my primary mailbox.  Please keep replies on 
the 'group where everyone may benefit.
Mar 15 2006
prev sibling parent Stewart Gordon <smjg_1998 yahoo.com> writes:
Stewart Gordon wrote:
 1. An oldie but a baddie - why are array operations still there?

Huh? It's mostly gone, but some bits have stayed there. "When more than one [] operator appears in an expression, the range represented by all must match. a[1..3] = b[] + 3; // error, 2 elements not same as 3 elements" True, it's an error, but that's because array arithmetic operations don't exist at the moment. The comment also makes no sense since the length of b isn't specified anywhere in that snippet. The only thing that's still relevant there is that the array lengths of lvalue and rvalue must match. But that's already mentioned under "Array Copying" - there's no point repeating it here. The "Examples" subsection is still relevant, but ought to be moved to a more appropriate heading. And this typo corrected: void dibb(int *array) to void dibb(int* array) But thanks for dealing with my points in a timely manner. Now all that remains of this list is to do something about the tech tips. Oh, and how could I have forgotten this oldie the first time? 8. http://www.digitalmars.com/d/faq.html "Why is [expletive deleted] printf in D?" "How do I get printf() to work with strings?" http://www.digitalmars.com/d/ctod.html "What can we say? printf() rules:" It's about time we encouraged people to use writef here rather than continuing to pretend it doesn't exist. Stewart. -- -----BEGIN GEEK CODE BLOCK----- Version: 3.1 GCS/M d- s:- C++ a->--- UB P+ L E W++ N+++ o K- w++ O? M V? PS- PE- Y? PGP- t- 5? X? R b DI? D G e++>++++ h-- r-- !y ------END GEEK CODE BLOCK------ My e-mail is valid but not my primary mailbox. Please keep replies on the 'group where everyone may benefit.
Mar 20 2006