home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / gofer230.zip / Progs / Gofer / Docs / Readme < prev    next >
Text File  |  1994-06-23  |  3KB  |  82 lines
  1. ------------------------------------------------------------------------------
  2.  
  3. This directory contains a draft of the user documentation for Gofer.
  4. More precisely, the files in this directory are as follows:
  5.  
  6.     Readme        this file
  7.     hype        a summary of the main features of Gofer
  8.     ch*, appx_*    individual chapters and appendices for the
  9.             main Gofer user manual (Gofer version 2.20)
  10.             (126 pages)
  11.     release.221    release notes for Gofer 2.21  (21 pages)
  12.     release.228    release notes for Gofer 2.28  (49 pages)
  13.         release.230     release notes for Gofer 2.30a (11 pages)
  14.     goferdoc.tex    Jeroen Fokker's LaTeX version of the main
  15.             Gofer user manual.
  16.  
  17. Several people have contributed man pages for Gofer:
  18.  
  19.     gofer.1        by Gary Leavens
  20.     bowen.1        by Jonathan Bowen
  21.     jeroen.1    by Jeroen Fokker
  22.  
  23. Feel free to use which ever one you prefer!
  24.  
  25. Some of the information in the earlier documentation is rather out
  26. of date.  You have been warned!!!
  27.  
  28. Given the number of pages involved, you will probably want to be
  29. selective about what you read and, in the interests of all of those
  30. poor trees, selective about what you print -- particularly bearing in
  31. mind the fact that this is only a draft and likely to change!  Another
  32. point worth mentioning is that the files are just plain ASCII text
  33. files -- they can be printed out without problem on a dot matrix
  34. printer ...
  35.  
  36. Those of you with fancy printers and document preparation software may
  37. be dissappointed that I haven't used anything more than ASCII text to
  38. produce these documents.  The simple reason for this is that ASCII is
  39. the only format that I can reasonably guarantee will be available on
  40. all of the machines on which Gofer is used.
  41.  
  42. Entries marked with a `+' in the list below are likely to be of most
  43. interest to those who are already familiar with Orwell.
  44.  
  45. These files may contain many errors; I would be grateful for any
  46. corrections or suggestions!
  47.  
  48.     ch00     Title and contents pages
  49.  
  50.     ch01     INTRODUCTION
  51.     ch02     BACKGROUND AND ACKNOWLEDGEMENTS
  52.   + ch03     STARTING GOFER
  53.     ch04     USING GOFER - A BASIC INTRODUCTION
  54.     ch05     STANDARD AND USER-DEFINED FUNCTIONS
  55.     ch06     FUNCTION NAMES - IDENTIFIERS AND OPERATORS
  56.     ch07     BUILT-IN TYPES
  57.     ch08     ERRORS
  58.     ch09     MORE ABOUT VALUE DECLARATIONS
  59.   + ch10     INCREASING YOUR POWER OF EXPRESSION
  60.     ch11     USER-DEFINED DATATYPES AND TYPE SYNONYMS
  61.   + ch12     DIALOGUES: INPUT AND OUTPUT
  62.     ch13     LAYOUT
  63.   + ch14     OVERLOADING IN GOFER
  64.  
  65.   + appx_a   SUMMARY OF GRAMMAR
  66.   + appx_b   CONTENTS OF STANDARD PRELUDE
  67.   + appx_c   RELATIONSHIP WITH HASKELL 1.1
  68.   + appx_d   USING GOFER WITH BIRD+WADLER
  69.     appx_e   PRIMITIVES
  70.   + appx_f   INTERPRETER COMMAND SUMMARY
  71.     appx_g   BIBLIOGRAPHY
  72.  
  73. Each file contains one or more pages of plain ASCII text.
  74. Each page is exactly 66 lines long.
  75.  
  76. If the format of these files is unsuitable for your printer, you may
  77. like to get hold of a copy of the source code and page formatter from
  78. which these documents were produced.  These should be available from
  79. the same place that you obtained the files in this directory.
  80.  
  81. ------------------------------------------------------------------------------
  82.