Bits (pardon the pun) of the documentation that are out of date

[Stewart Gordon]

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

http://www.digitalmars.com/drn-bin/wwwnews?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.