[fpc-pascal] Documentation and posts suggestions [LONG]
Michael Van Canneyt
michael at freepascal.org
Mon Mar 16 10:14:50 CET 2009
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 !
More information about the fpc-pascal