www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - with docs misleading..

reply Regan Heath <regan netwin.co.nz> writes:
http://www.digitalmars.com/d/statement.html#with

Shouldn't this:

"where Expression evaluates to a class instance or struct reference."

read:

"where Expression evaluates to a class reference or struct instance."

?

-- 
Using M2, Opera's revolutionary e-mail client: http://www.opera.com/m2/
Sep 01 2004
next sibling parent reply "Lynn Allan" <l_d_allan adelphia.net> writes:
Do you speak "wiki"?

As of today, all or almost all documentation pages have a link at the bottom 
for:
"Add feedback and comments regarding this page."

This link will take you to the associated wiki4d's page for that specific 
page of documentation related to statement#with:
http://www.prowiki.org/wiki4d/wiki.cgi?DocComments/Statement

On this page, you can directly communicate your suggestion to the 
author/maintainer of that page (probably "The WB" or jcc7?). There doesn't 
seem to be any registration required to author new pages, or revise existing 
pages. It is as simple as clicking on the "Edit" link (there are one each at 
the upper right and lower right, plus there is a link labelled "Edit text of 
this page" which does the same thing.

Try it! It's fun!

For wiki newbies, there is a "TestPage" for practicing. The key thing to 
realize is that you can make a small change, and then click on the "Preview" 
button. Look in the lower half of the webpage to see what happened, and 
revise the upper half of the webpage accordingly to have it come out right. 
At first, this might take a dozen or more iterations, but that doesn't 
matter. When it looks ok, click on the "Save" button.

If the page won't behave and you aren't sure how to undo something, just 
keep using the "Back" arrow so that the page isn't saved. Even if something 
flawed inadvertently gets saved, my impression is that a wiki admin can 
restore.

If it applies, here are some useful wiki links for newbies:
http://www.prowiki.org/wiki4d/wiki.cgi?WhatIsaWiki
http://www.prowiki.org/wiki4d/wiki.cgi?OneMinuteWiki
http://www.prowiki.org/wiki4d/wiki.cgi?WikiFaq
http://www.prowiki.org/wiki4d/wiki.cgi?WikiHelp/HowToEdit

Here is an existing wiki4d page I found helpful to use as a guide for 
submitting suggestions. It relates to the documentation for "Arrays", but is 
otherwise very similar to the comment you are making about the "with" token.
http://www.prowiki.org/wiki4d/wiki.cgi?DocComments/Arrays

HTH,
Lynn A.

"Regan Heath" <regan netwin.co.nz> wrote in message 
news:opsdohzbzv5a2sq9 digitalmars.com...
 http://www.digitalmars.com/d/statement.html#with

 Shouldn't this:

 "where Expression evaluates to a class instance or struct reference."

 read:

 "where Expression evaluates to a class reference or struct instance."

 ?

 -- 
 Using M2, Opera's revolutionary e-mail client: http://www.opera.com/m2/ 

Sep 01 2004
parent Regan Heath <regan netwin.co.nz> writes:
Thanks, I had forgotten I could do that.

On Wed, 1 Sep 2004 22:57:14 -0600, Lynn Allan <l_d_allan adelphia.net> 
wrote:

 Do you speak "wiki"?

 As of today, all or almost all documentation pages have a link at the 
 bottom
 for:
 "Add feedback and comments regarding this page."

 This link will take you to the associated wiki4d's page for that specific
 page of documentation related to statement#with:
 http://www.prowiki.org/wiki4d/wiki.cgi?DocComments/Statement

 On this page, you can directly communicate your suggestion to the
 author/maintainer of that page (probably "The WB" or jcc7?). There 
 doesn't
 seem to be any registration required to author new pages, or revise 
 existing
 pages. It is as simple as clicking on the "Edit" link (there are one 
 each at
 the upper right and lower right, plus there is a link labelled "Edit 
 text of
 this page" which does the same thing.

 Try it! It's fun!

 For wiki newbies, there is a "TestPage" for practicing. The key thing to
 realize is that you can make a small change, and then click on the 
 "Preview"
 button. Look in the lower half of the webpage to see what happened, and
 revise the upper half of the webpage accordingly to have it come out 
 right.
 At first, this might take a dozen or more iterations, but that doesn't
 matter. When it looks ok, click on the "Save" button.

 If the page won't behave and you aren't sure how to undo something, just
 keep using the "Back" arrow so that the page isn't saved. Even if 
 something
 flawed inadvertently gets saved, my impression is that a wiki admin can
 restore.

 If it applies, here are some useful wiki links for newbies:
 http://www.prowiki.org/wiki4d/wiki.cgi?WhatIsaWiki
 http://www.prowiki.org/wiki4d/wiki.cgi?OneMinuteWiki
 http://www.prowiki.org/wiki4d/wiki.cgi?WikiFaq
 http://www.prowiki.org/wiki4d/wiki.cgi?WikiHelp/HowToEdit

 Here is an existing wiki4d page I found helpful to use as a guide for
 submitting suggestions. It relates to the documentation for "Arrays", 
 but is
 otherwise very similar to the comment you are making about the "with" 
 token.
 http://www.prowiki.org/wiki4d/wiki.cgi?DocComments/Arrays

 HTH,
 Lynn A.

 "Regan Heath" <regan netwin.co.nz> wrote in message
 news:opsdohzbzv5a2sq9 digitalmars.com...
 http://www.digitalmars.com/d/statement.html#with

 Shouldn't this:

 "where Expression evaluates to a class instance or struct reference."

 read:

 "where Expression evaluates to a class reference or struct instance."

 ?

 --
 Using M2, Opera's revolutionary e-mail client: http://www.opera.com/m2/


-- Using M2, Opera's revolutionary e-mail client: http://www.opera.com/m2/
Sep 01 2004
prev sibling parent Stewart Gordon <smjg_1998 yahoo.com> writes:
Regan Heath wrote:

 http://www.digitalmars.com/d/statement.html#with
 
 Shouldn't this:
 
 "where Expression evaluates to a class instance or struct reference."
 
 read:
 
 "where Expression evaluates to a class reference or struct instance."

Surely it should be "object reference" not "class reference"? Stewart.
Oct 04 2004