home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / EFFO / pd6.lzh / DOC / tile.doc < prev   
Text File  |  1990-05-16  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4.                                                           TILE(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      tile - c based forth-83 standard programming environment
  10.  
  11. SYNOPSIS
  12.      forth [file ...] [-a argument ...]
  13.      forth [file ...] [-s start-symbol] [argument ...]
  14.  
  15. DESCRIPTION
  16.      forth uses a command syntax much like a compiler. The file
  17.      arguments are loaded before the interaction top loop is
  18.      started. A start-symbol may also be given as an argument
  19.      thus allowing forth to act as a `compile-and-go' compiler of
  20.      applications. An extra options or parameters passed to forth
  21.      may be accessed by the application. As extensions of the
  22.      Forth-83 Standard forth supports multi-tasking, exceptions,
  23.      vocabulary casting, private definitions, argument binding
  24.      and local variables. Written in C the kernel may be used as
  25.      a general purpose environment for interactive testing of C-
  26.      code.
  27.  
  28.      To provide an interactive programming environment for
  29.      developing programs forth may be run as a sub-process to GNU
  30.      Emacs in a specialized forth-mode. Source code may be edited
  31.      and directly tested by passing either a paragraph of code or
  32.      a whole buffer to forth from Emacs. The forth-mode also sup-
  33.      ports documentation retrieval and automatic indentation of
  34.      forth code, comments and definitions.
  35.  
  36.      An environment variable is used to specify file search paths
  37.      thus liberating and supporting management of libraries of
  38.      source code.  forth compiles faster than most compilers link
  39.      with approx. 50.000 lines per minute on a SUN-3/60, thus
  40.      code is only saved in source form.
  41.  
  42. OPTIONS
  43.      -a argument ...
  44.           Allows access of the rest of the arguments. The first
  45.           arguments is the string forth.
  46.  
  47.      -s start-symbol
  48.           Defines the symbol to be used instead of the normal
  49.           interaction top loop. The start-symbol becomes the
  50.           first argument and any further arguments may be
  51.           accessed by the application. The library contains some
  52.           examples of argument fetching functions.
  53.  
  54. LIBRARIES
  55.      The tile environment has currently three directories with
  56.      forth-83 source, test and example code and documentation.
  57.      The directory src contains Forth-83 source code library,
  58.      consisting of a number of data modelling, and debugging
  59.      tools, and high level multi-tasking constructs such as
  60.  
  61.  
  62.  
  63.                                                                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TILE(1)
  71.  
  72.  
  73.  
  74.      semaphores, channels and task types. Documentation of the
  75.      source code and the kernel are found in the directory doc.
  76.      Test programs for and example of usage of the source library
  77.      code may be found in the directory tst.
  78.  
  79. FILES
  80.      file.f83            Forth-83 source input file
  81.      file.doc            Forth-83 source documentation file
  82.      file.tst            Forth-83 source test file
  83.      kernel.c..h         multi-tasking c based Forth-83 kernel
  84.      error.c..h          error management package
  85.      io.c..h             multi-tasking input package
  86.      memory.c..h         memory management package
  87.      forth.c             this application
  88.      forth.doc           documentation of extensions
  89.      forth.el            GNU Emacs forth-mode source
  90.      tile.1              this manual
  91.      Makefile            puts the forth application together
  92.  
  93. ENVIRONMENT
  94.      TILEPATH            Search path for library source files. A
  95.                          normal setting is
  96.                          `.:~/tile/src:~/tile/tst' which will
  97.                          allow the file include function in forth
  98.                          to locate library source files in
  99.                          current directory, the standard library,
  100.                          and the test code library. forth also
  101.                          looks for files at the users home direc-
  102.                          tory.
  103.  
  104. GNU EMACS FORTH MODE
  105.      The GNU Emacs forth-mode supports interactive programming,
  106.      automatic indentation of source code, and documentation
  107.      search of the forth kernel and library within Emacs. To
  108.      allow automatic loading of mode your .emacs file should con-
  109.      tain the following definitions;
  110.  
  111.        (set-variable 'load-path
  112.                      (append load-path
  113.                              '(nil "~/tile")))
  114.        (setq forth-help-load-path '(nil "~/tile/doc"))
  115.        (setq auto-mode-alist
  116.              (append '(("\.tst$" . forth-mode)
  117.                               ("\.f83$" . forth-mode))
  118.                               auto-mode-alist))
  119.        (autoload 'forth-mode "forth")
  120.  
  121.      Further documentation about the forth-mode may be found by
  122.      giving the command `M-x describe-mode' in Emacs.
  123.  
  124. BUGS
  125.      Bugs should be reported to mip@ida.liu.se. Bugs tend
  126.  
  127.  
  128.  
  129. 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                                           TILE(1)
  137.  
  138.  
  139.  
  140.      actually to be fixed if they can be isolated, so it is in
  141.      your interest to report them in such a way that they can be
  142.      easily reproduced according to get newer version.
  143.  
  144. COPYING
  145.      Copyright (C) 1989 Mikael R.K. Patel
  146.      Permission is granted to make and distribute verbatim copies
  147.      of this manual provided the copyright notice and this per-
  148.      mission notice are preserved on all copies.
  149.      Permission is granted to copy and distribute modified ver-
  150.      sions of this manual under the conditions for verbatim copy-
  151.      ing, provided also that the section entitled "GNU General
  152.      Public License" is included exactly as in the original, and
  153.      provided that the entire resulting derived work is distri-
  154.      buted under the terms of a permission notice identical to
  155.      this one.
  156.      Permission is granted to copy and distribute translations of
  157.      this manual into another language, under the above condi-
  158.      tions for modified versions, except that the section enti-
  159.      tled "GNU General Public License" may be included in a
  160.      translation approved by the author instead of in the origi-
  161.      nal English.
  162.  
  163. AUTHORS
  164.      Mikael R.K. Patel
  165.      Computer Aided Design Laboratory (CADLAB)
  166.      Department of Computer and Information Science
  167.      Linkoping University
  168.      S-581 83 LINKOPING
  169.      SWEDEN
  170.      Email: mip@ida.liu.se
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                 3
  196.  
  197.  
  198.  
  199.