home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 316.lha / EtaleFileReader / README < prev    next >
Encoding:
Text File  |  1989-11-30  |  4.8 KB  |  105 lines
  1.  
  2.  
  3.  
  4.                         The Etale File Reader
  5.  
  6.                         by William F. Hammond
  7.                         
  8.                           Copyright ‹ 1989
  9.  
  10. [This software is freely distributable.  It may not be included in a
  11. product that is sold without the permission of the author except in
  12. a package of freely distributable software for which a modest charge
  13. for material and handling is imposed.]
  14.  
  15.    This is yet another "more"-type file reader which differs from
  16. all others that I know of in that it supports superscripts and sub-
  17. scripts on the Amiga's screen at very low memory cost.  (The "Aztec C",
  18. v. 3.6, executable is of size 14,708.)  In fact, by my stopwatch, when
  19. running in "scroll mode", it puts text to its window faster than
  20. "type" will put it to a shell or CLI window under "fast-text".  
  21.  
  22.    Subscripts and superscripts are represented on the screen according
  23. to the appearance of the following (high) ASCII codes in a file:
  24.  
  25.                      87    start superscript
  26.                      86    stop superscript
  27.                      88    start subscript
  28.                      8A    stop subscript
  29.  
  30. In this version of the program codes 87 and 8A are handled the same
  31. way, and codes 86 and 88 are handled the same way.  The four codes
  32. are provided since some of these files may eventually get filtered
  33. through to a printer which wants four different codes.
  34.  
  35.    The Amiga screen font "etale.font" is a fixed-width 8x8 font that
  36. contains mathematical characters, including a complete Greek alphabet
  37. in the high codes.  This reader is designed for use in conjunction
  38. with the Etale font.  That font is supplied with the binary package.
  39.  
  40.    To facilitate the production of documents in the Etale font there
  41. is an Amiga keymap called "math" furnished with the binary package.
  42. Of course, one also needs an editor (no word processors, please) that
  43. fully respects the user's font and keymap.
  44.  
  45.    Although this program does not open an ARexx port (ARexx is a
  46. product of William S. Hawes, Maynard, Mass., USA), it does have a
  47. "programmed" mode of operation.  Thus, it can be opened from within
  48. an editor with a suitable ARexx facility on the page being edited.
  49.  
  50.    For more information on the Etale File Reader, see the file
  51. "efr.doc" in the binary package.
  52.  
  53.    Although this has been coded in an "Aztec C", v. 3.6, environment,
  54. it uses Amiga "types" consistently throughout except for variables
  55. that pick up returns from compiler library functions (like "strlen")
  56. that are supposed to return "int" and which, therefore, return 16 bits
  57. under Aztec and 32 bits possibly in other environments.  I have been
  58. assured by a friend that this code compiles and runs in the "Lattice"
  59. environment.
  60.  
  61.    The files in this package are:
  62.  
  63. bfgets.c                     443 ----rw-d 17-Sep-89 19:08:14
  64. efr.blink                    139 ----rw-d 17-Sep-89 19:09:43
  65. efr.c                       7230 ----rw-d 17-Sep-89 19:10:04
  66. efr.lt.hs                    345 -s--rwed 25-Sep-89 07:42:09
  67. efr.mx.hs                    529 -s--rwed 17-Sep-89 19:11:02
  68. getdirs.c                   1458 ----rw-d 17-Sep-89 17:21:02
  69. ltoa.c                       900 ----rw-d 17-Aug-89 11:26:51
  70. numget.c                    2200 ----rw-d 17-Sep-89 17:21:44
  71. parseline.c                 6866 ----rw-d 20-Sep-89 20:40:01
  72. tdm.h                       4148 ----rw-d 17-Sep-89 20:57:09
  73. tdm.i.c                      256 ----rw-d 17-Sep-89 17:34:40
  74. tnump.c                     1139 ----rw-d 17-Sep-89 17:24:32
  75. txttw.c                    11374 ----rw-d 20-Sep-89 21:11:52
  76. writeline.c                 1441 ----rw-d 15-Sep-89 16:03:38
  77.  
  78.    The file "tdm.h" is a common header that is included in every "*.c"
  79. except for "ltoa.c", "bfgets.c" (which are general purpose functions)
  80. and "tdm.i.c" (which is the source file for "pre-compiled includes").
  81.  
  82.    "efr.c" is the executive, and "txttw.c" is the screen-manager.
  83. Decision making is all in the hands of these two routines.
  84.  
  85.    The program looks at a file one line at a time, and, as appropriate,
  86. sends the line to the program's custom borderless and gadgetless
  87. full-screen window in "parts" (see the definition of "struct LinePart"
  88. in "tdm.h").  Each line is sent to parseline for division into parts
  89. and then to "writeline" for actual transmission to the window.
  90.  
  91.    The file "efr.mx.hs" is an AmigaDOS script for compiling and
  92. and linking in an Aztec C, v. 3.6, environment.  I am told that the
  93. script file "efr.lt.hs" and the "with" file "efr.blink" will be useful
  94. to those wishing to make an executable in the "Lattice" environment
  95. and that such an executable will be about 3K larger than the
  96. executable size reported above.
  97.  
  98.  
  99.    Please report bugs, problems, comments to:
  100.  
  101. William F. Hammond                 Dept. of Mathematics and Statistics
  102. Tel. (518) 442-4625                SUNYA
  103. Email: wfh58@leah.albany.edu       Albany, NY 12222 (USA)
  104.  
  105.