Thread overview
Bits (pardon the pun) of the documentation that are out of date
Mar 15, 2006
Stewart Gordon
Mar 15, 2006
Stewart Gordon
Mar 20, 2006
Stewart Gordon
March 15, 2006
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.
March 15, 2006
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.
March 20, 2006
Stewart Gordon wrote:
> 1. An oldie but a baddie - why are array operations still there?
<snip>

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.