GPC documentation wish list
===========================

- "Extensions", "Extended Pascal", and "Borland Pascal" should be
  re-written.  I suggest the following structure:

  * Standard Pascal::	Remarks about GPC's implementation of Standard Pascal

    We consider Level 0 as stable.  Please report deviations as bugs.
    We have started to implement Level 1, i.e. conformant arrays; please
    send us your example programs which GPC does not understand.

    Tell Borland Pascal programmers about Standard Pascal features they
    do not know.

  * Extended Pascal::	Extended Pascal features in GNU Pascal

    Give a short introduction to Extended Pascal, tell how it differs from
    Standard Pascal and Borland Pascal, document each EP feature in GPC -
    and each EP feature missing in GPC.

  * UCSD Pascal::	UCSD Pascal features in GNU Pascal

    Give a short introduction to UCSD Pascal, tell how it differs from
    Standard Pascal and that many "Borland Pascal features" are indeed from
    UCSD Pascal.  Document each UCSD feature in GPC and each UCSD feature
    missing in GPC.

  * Borland Pascal::	Borland Pascal features in GNU Pascal

    Introduction to Borland Pascal, point to UCSD Pascal and tell the
    differences to Standard Pascal and UCSD Pascal.  Document each feature ...

  * Object Pascal::     \
  * Delphi::		 (Just dreaming.;)
  * Pascal-SC::         /

  * GNU Extensions::	GNU Extensions to the Pascal language

    Document all such extensions.  Some of them are extensions to a
    specific dialect - sort them by these dialects.

- Move "Keywords" and "Built-in" after the descriptions of the different
  Pascal dialects by replacing them with a real "reference manual" which
  explains each symbol and identifier understood by GPC.

- Adapt "Introduction" to correspond to the rest of the documentation.

- Write a "Hacker's guide to GPC" which tells how to hunt a GPC bug.


Done jobs:
==========

- At the beginning of "Invoking GPC", write some simple notes how to
  compile a program with GPC.  With examples.

