gcc/m2/gm2-libs-log/README.texi

   1 @c README.texi describes the additional PIM libraries.
   2 @c Copyright @copyright{} 2000-2023 Free Software Foundation, Inc.
   3 @c
   4 @c This is part of the GM2 manual.
   5 @c For copying conditions, see the file gcc/doc/include/fdl.texi.
   6
   7 These modules are provided to enable legacy Modula-2 applications to
   8 build with GNU Modula-2. It is advised that these module should not
   9 be used for new projects, maybe the ISO libraries or the native
  10 compiler PIM libraries (FIO) should be used instead.
  11
  12 Here is an outline of the module layering:
  13
  14 @example
  15
  16 InOut  RealInOut  LongIO CardinalIO
  17     \     |       |      /
  18            Terminal
  19 -----------------------------------
  20               |
  21            Termbase
  22            /      \
  23     Keyboard      Display
  24
  25 @end example
  26
  27 Above the line are user level PIM [234] and Logitech 3.0 compatible
  28 modules.  Below the line Logitech 3.0 advised that these modules
  29 should be considered part of the runtime system. The libraries do
  30 not provide all the features found in the Logitech libraries as
  31 a number of these features were MS-DOS related. Essentially the
  32 basic input/output, file system, string manipulation and conversion
  33 routines are provided. Access to DOSCALL, graphics, time and date
  34 are not as these were constrained by the limitations of MS-DOS.
  35
  36 The following libraries are contained within the base GNU Modula-2
  37 libraries and are also Logitech-3.0 compatible: @xref{gm2-libs/ASCII},
  38 @xref{gm2-libs/Storage} and @xref{gm2-libs/MathLib0}.  These libraries
  39 are always available for any dialect of the language (although their
  40 implementation and behaviour might differ, for example Storage ISO and
  41 PIM).
  42
  43 The following libraries are Logitech-3.0 compatible but fall outside
  44 the base GNU Modula-2 libraries.