Greetings!

I would love to see more examples in the documentation.  It's lacking.  Some of us, lacking the English language, learn by examples.  I remember back in the day a book called, "C by example," or something like that.  That was a great book. D documentation lack examples.

Thanks for listening. :-)

josé

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

jicman schrieb am Thu, 7 Apr 2005 05:47:01 +0000 (UTC):
>
>
> Greetings!
>
> I would love to see more examples in the documentation.  It's lacking.  Some of us, lacking the English language, learn by examples.  I remember back in the day a book called, "C by example," or something like that.  That was a great book. D documentation lack examples.
>
> Thanks for listening. :-)

http://dsource.org/tutorials/

Thomas


-----BEGIN PGP SIGNATURE-----

iD8DBQFCVMqe3w+/yD4P9tIRAnXQAKCL1esUXiza3DU5qVUWllCCKmDtHACgt2lf
bOvcXKwEptbkm3+y+5QlBMg=
=Cu3/
-----END PGP SIGNATURE-----

Well, I do believe examples should be part of the documentation.

I can download the compiler and the documentation that comes with it once to
my hard drive,
 but I don't have a 24-hours open connection to the internet to browse
through dsource ...


"Thomas Kuehne" <thomas-dloop@kuehne.thisisspam.cn> wrote in message news:uduei2-uq5.ln1@lnews.kuehne.cn...
>
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> jicman schrieb am Thu, 7 Apr 2005 05:47:01 +0000 (UTC):
> >
> >
> > Greetings!
> >
> > I would love to see more examples in the documentation.  It's lacking.
Some of
> > us, lacking the English language, learn by examples.  I remember back in
the day
> > a book called, "C by example," or something like that.  That was a great
book.
> > D documentation lack examples.
> >
> > Thanks for listening. :-)
>
> http://dsource.org/tutorials/
>
> Thomas
>
>
> -----BEGIN PGP SIGNATURE-----
>
> iD8DBQFCVMqe3w+/yD4P9tIRAnXQAKCL1esUXiza3DU5qVUWllCCKmDtHACgt2lf
> bOvcXKwEptbkm3+y+5QlBMg=
> =Cu3/
> -----END PGP SIGNATURE-----

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Alligator schrieb am Thu, 7 Apr 2005 11:15:16 -0700:
> Well, I do believe examples should be part of the documentation.
>
> I can download the compiler and the documentation that comes with it once to
> my hard drive,
>  but I don't have a 24-hours open connection to the internet to browse
> through dsource ...

A slightly large page containing all samples: http://dsource.org/tutorials/index.php?all_examples

Thomas

-----BEGIN PGP SIGNATURE-----

iD8DBQFCVPQ13w+/yD4P9tIRAhaFAJ9nvZEwf3nuZDmA+EJUb5KdMuWUSQCdE2U5
BozAk9zkO464BCGPfu4bmGs=
=X6nc
-----END PGP SIGNATURE-----

Alligator schrieb:
> Well, I do believe examples should be part of the documentation.
> 
> I can download the compiler and the documentation that comes with it once to
> my hard drive,
>  but I don't have a 24-hours open connection to the internet to browse
> through dsource ...

This is what i had in mind for the D Doc wiki:
http://www.quit-clan.de/docwiki/

So you can download a chm with lots of examples. Currently it is still work-in-progress...

Alligator wrote:
> Well, I do believe examples should be part of the documentation.
> 
> I can download the compiler and the documentation that comes with it once to
> my hard drive,
>  but I don't have a 24-hours open connection to the internet to browse
> through dsource ...
> 

hum.. on linux or cygwin i'm pretty sure you can 'wget -r www.dsource.org/tutorials' and it will download all dsource.org tutorials to your hard drive.

> 
> "Thomas Kuehne" <thomas-dloop@kuehne.thisisspam.cn> wrote in message
> news:uduei2-uq5.ln1@lnews.kuehne.cn...
> 
>>-----BEGIN PGP SIGNED MESSAGE-----
>>Hash: SHA1
>>
>>jicman schrieb am Thu, 7 Apr 2005 05:47:01 +0000 (UTC):
>>
>>>
>>>Greetings!
>>>
>>>I would love to see more examples in the documentation.  It's lacking.
> 
> Some of
> 
>>>us, lacking the English language, learn by examples.  I remember back in
> 
> the day
> 
>>>a book called, "C by example," or something like that.  That was a great
> 
> book.
> 
>>>D documentation lack examples.
>>>
>>>Thanks for listening. :-)
>>
>>http://dsource.org/tutorials/
>>
>>Thomas
>>
>>
>>-----BEGIN PGP SIGNATURE-----
>>
>>iD8DBQFCVMqe3w+/yD4P9tIRAnXQAKCL1esUXiza3DU5qVUWllCCKmDtHACgt2lf
>>bOvcXKwEptbkm3+y+5QlBMg=
>>=Cu3/
>>-----END PGP SIGNATURE-----
> 
> 
> 

So, Thomas, are you saying that the documentation of the best programming language ever should not have example?  Wrong!  Very wrong.  I have been there and done that, but sometimes, I don't want to be on the internet and I would just love to hit my

C:\dmd\html\d\index.html

page and read and follow some nice explanations and examples, when I am lost. Again, that is just me, a very weird person. ;-)

no problem.  It was just a thought...

thanks.

jic

Thomas Kuehne says...
>
>
>-----BEGIN PGP SIGNED MESSAGE-----
>Hash: SHA1
>
>Alligator schrieb am Thu, 7 Apr 2005 11:15:16 -0700:
>> Well, I do believe examples should be part of the documentation.
>>
>> I can download the compiler and the documentation that comes with it once to
>> my hard drive,
>>  but I don't have a 24-hours open connection to the internet to browse
>> through dsource ...
>
>A slightly large page containing all samples: http://dsource.org/tutorials/index.php?all_examples
>
>Thomas
>
>-----BEGIN PGP SIGNATURE-----
>
>iD8DBQFCVPQ13w+/yD4P9tIRAhaFAJ9nvZEwf3nuZDmA+EJUb5KdMuWUSQCdE2U5
>BozAk9zkO464BCGPfu4bmGs=
>=X6nc
>-----END PGP SIGNATURE-----

Goodness gratious, great balls of fire, this is great!  Didn't even know it existed!  Holie molie!

thanks.


Markus Dangl says...
>
>Alligator schrieb:
>> Well, I do believe examples should be part of the documentation.
>> 
>> I can download the compiler and the documentation that comes with it once to
>> my hard drive,
>>  but I don't have a 24-hours open connection to the internet to browse
>> through dsource ...
>
>This is what i had in mind for the D Doc wiki: http://www.quit-clan.de/docwiki/
>
>So you can download a chm with lots of examples. Currently it is still work-in-progress...

randomnewbie says...
>
>Alligator wrote:
>> Well, I do believe examples should be part of the documentation.
>> 
>> I can download the compiler and the documentation that comes with it once to
>> my hard drive,
>>  but I don't have a 24-hours open connection to the internet to browse
>> through dsource ...
>> 
>
>hum.. on linux or cygwin i'm pretty sure you can 'wget -r www.dsource.org/tutorials' and it will download all dsource.org tutorials to your hard drive.

Didn't know this either.  NICE!  Downloading them as I type... ;-)

thanks.



>
>> 
>> "Thomas Kuehne" <thomas-dloop@kuehne.thisisspam.cn> wrote in message news:uduei2-uq5.ln1@lnews.kuehne.cn...
>> 
>>>-----BEGIN PGP SIGNED MESSAGE-----
>>>Hash: SHA1
>>>
>>>jicman schrieb am Thu, 7 Apr 2005 05:47:01 +0000 (UTC):
>>>
>>>>
>>>>Greetings!
>>>>
>>>>I would love to see more examples in the documentation.  It's lacking.
>> 
>> Some of
>> 
>>>>us, lacking the English language, learn by examples.  I remember back in
>> 
>> the day
>> 
>>>>a book called, "C by example," or something like that.  That was a great
>> 
>> book.
>> 
>>>>D documentation lack examples.
>>>>
>>>>Thanks for listening. :-)
>>>
>>>http://dsource.org/tutorials/
>>>
>>>Thomas
>>>
>>>
>>>-----BEGIN PGP SIGNATURE-----
>>>
>>>iD8DBQFCVMqe3w+/yD4P9tIRAnXQAKCL1esUXiza3DU5qVUWllCCKmDtHACgt2lf
>>>bOvcXKwEptbkm3+y+5QlBMg=
>>>=Cu3/
>>>-----END PGP SIGNATURE-----
>> 
>> 
>> 

jicman wrote:
> So, Thomas, are you saying that the documentation of the best programming
> language ever should not have example?  Wrong!  Very wrong.  I have been there

No one is asserting that there should be no examples included with the D compiler, but the "Specification" may not be the right place. Specifying just isn't a synonym for exemplifying.

By the way, the compiler does come with some examples: \dmd\samples\d

> and done that, but sometimes, I don't want to be on the internet and I would
> just love to hit my
> 
> C:\dmd\html\d\index.html

Whine, whine, whine. ;)

> 
> page and read and follow some nice explanations and examples, when I am lost.
> Again, that is just me, a very weird person. ;-)

No, you're not weird, and neither are you the first person to complain about this either. But complaining doesn't necessarily fix anything either.

Have you seen this?
http://www.prowiki.org/wiki4d/wiki.cgi?D__Tutorial

If you see that anyone that is on what you consider to be the right track, you can beg for more. If you don't like any of the existing projects, you tell ask for improvements. Or you can just scream at the top of your lungs, "WHERE ARE THE EXAMPLES THAT I NEED!"

-- 
jcc7
http://jcc_7.tripod.com/d/