[fpc-pascal] OT a bit - Planet Object Pascal

[waldo kitty]

On 2/17/2013 14:35, Florian Klämpfl wrote:
> Am 17.02.2013 20:31, schrieb Frank Church:
>> One more thing lest I forget. The official FPC documentation is very
>> good, especially for documents created by volunteers and hobbyists.
>> That it is not accompanied by examples
>
> c:\fpc\docs>dir ex*.pp /s | grep -c ex
> 668
>
> What do I miss?

they are not /in/ the documentation to be read with the docs... think about it 
like a programming book you by at the store... you are reading a chapter about 
pointers and there's a simple working demo included in the chapter that is 
expanded on the further you read in the chapter...

that the sources for the demos are on the disk is a GoodThing<tm> because that 
saves the reader from having to type them in... however, that they are on the 
disk and not in the documentation also means that the reader cannot look at and 
contemplate them while reading the (printed) documentation while in the 
""library"" with their C0FFEE while taking their morning/daily 
"constitutional"... or at the breakfast table or on the bus or train or even 
just while reading in bed...