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

[Stewart Gordon]

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.