home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / languages / progs / gopher / !Gofer / archives / Docs / Readme < prev    next >
Encoding:
Text File  |  1993-02-12  |  2.9 KB  |  73 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.     goferdoc.tex    Jeroen Fokker's LaTeX version of the main
  14.             Gofer user manual.
  15.  
  16. Some of the information in the earlier documentation is rather out
  17. of date.  You have been warned!!!
  18.  
  19. Given the number of pages involved, you will probably want to be
  20. selective about what you read and, in the interests of all of those
  21. poor trees, selective about what you print -- particularly bearing in
  22. mind the fact that this is only a draft and likely to change!  Another
  23. point worth mentioning is that the files are just plain ASCII text
  24. files -- they can be printed out without problem on a dot matrix
  25. printer ...
  26.  
  27. Those of you with fancy printers and document preparation software may
  28. be dissappointed that I haven't used anything more than ASCII text to
  29. produce these documents.  The simple reason for this is that ASCII is
  30. the only format that I can reasonably guarantee will be available on
  31. all of the machines on which Gofer is used.
  32.  
  33. Entries marked with a `+' in the list below are likely to be of most
  34. interest to those who are already familiar with Orwell.
  35.  
  36. These files may contain many errors; I would be grateful for any
  37. corrections or suggestions!
  38.  
  39.     ch00     Title and contents pages
  40.  
  41.     ch01     INTRODUCTION
  42.     ch02     BACKGROUND AND ACKNOWLEDGEMENTS
  43.   + ch03     STARTING GOFER
  44.     ch04     USING GOFER - A BASIC INTRODUCTION
  45.     ch05     STANDARD AND USER-DEFINED FUNCTIONS
  46.     ch06     FUNCTION NAMES - IDENTIFIERS AND OPERATORS
  47.     ch07     BUILT-IN TYPES
  48.     ch08     ERRORS
  49.     ch09     MORE ABOUT VALUE DECLARATIONS
  50.   + ch10     INCREASING YOUR POWER OF EXPRESSION
  51.     ch11     USER-DEFINED DATATYPES AND TYPE SYNONYMS
  52.   + ch12     DIALOGUES: INPUT AND OUTPUT
  53.     ch13     LAYOUT
  54.   + ch14     OVERLOADING IN GOFER
  55.  
  56.   + appx_a   SUMMARY OF GRAMMAR
  57.   + appx_b   CONTENTS OF STANDARD PRELUDE
  58.   + appx_c   RELATIONSHIP WITH HASKELL 1.1
  59.   + appx_d   USING GOFER WITH BIRD+WADLER
  60.     appx_e   PRIMITIVES
  61.   + appx_f   INTERPRETER COMMAND SUMMARY
  62.     appx_g   BIBLIOGRAPHY
  63.  
  64. Each file contains one or more pages of plain ASCII text.
  65. Each page is exactly 66 lines long.
  66.  
  67. If the format of these files is unsuitable for your printer, you may
  68. like to get hold of a copy of the source code and page formatter from
  69. which these documents were produced.  These should be available from
  70. the same place that you obtained the files in this directory.
  71.  
  72. ------------------------------------------------------------------------------
  73.