[fpc-pascal] Documentation and posts suggestions [LONG]

[Michael Van Canneyt]

On Sun, 15 Mar 2009, Tomas Hajny wrote:

> > > * In cases were some code needs a particular mode other than the default mode
> > > we can include which mode is needed.
> > 
> > There is no need for this: Classes and exception handling always need mode objfpc 
> > or Delphi. Regular functions do not need a mode at all. 
> > 
> > This is a simple rule, which can easily be remembered, no ?
> 
> Well, out of curiousity, I tried searching for the word "exceptions" 
> in the Programmer's Guide and Reference Guide and look at it with 
> eyes of a newcomer as suggested by Francisco. I don't think that the 
> places I found (including the dedicated chapter for exceptions in the 
> Reference Guide) make this rule very obvious, so there may be some 
> room for improvement, IMHO. Indeed, this rule is clear from the 
> description of the different compiler modes and various methods 
> allowing to change the mode, but the newcomer may not even know / 
> understand that he should be interested in changing the compiler mode 
> (i.e. visit that part of the document). If nothing else, I'd 
> certainly expect to find this information in the Reference Guide in 
> chapters describing the appropriate language elements.

A good point, and I will add some statements to the docs in the 
appropriate chapters/sections !

Michael.