home *** CD-ROM | disk | FTP | other *** search
/ Atari FTP / ATARI_FTP_0693.zip / ATARI_FTP_0693 / Tex / Tex31 / texsrc.lzh / README.SRC < prev    next >
Text File  |  1991-01-15  |  5KB  |  151 lines
  1. Tell GNU Emacs to go into -*- Mode: Text -*-
  2. Date: Tue Jan 15 19:35:30 1991
  3.  
  4.                TeX 3.1 and Metafont 2.7
  5.                    for the
  6.                   Atari ST.
  7.  
  8.  
  9.         This is the README for the C sources.
  10.  
  11.  
  12. This archive contains C sources, which were generated from the WEB and
  13. the WEB2C sources version 5.8a, which Karl Berry announced and
  14. released in a TeXhax digest, which appeared on my news site during
  15. November 1990. I make them available upon special request. I also only
  16. provide the sources for TeX and Metafont and NOT for the other utility
  17. programs.
  18.  
  19. The WEB sources were converted on my Un*x box at work with the
  20. constant MAXLINES in file src-5.8a/web2c/splitup.c set to 1000.
  21. This conversion process produced C source files with an average size
  22. of about 30 k.
  23.  
  24. The C sources compiled without any major problems with GNU-C v1.37.1
  25. and v1.38. Exceptions are listed below.
  26.  
  27. Before I continue, let me shortly decribe the configuration of my ST.
  28. The machine is equipped with 2.5 meg memory. I've installed a 192 k
  29. ramdisk and a 200 k disk cache plus some auto folder programs. It's
  30. fair to say, that about 1/2 meg is lost to these programs. All
  31. temporary file are created in the ram disk.
  32.  
  33. All TeX and Metafont C source files, except 3, could be compiled with
  34. this configuration. The following three files needed special
  35. attention, before they would compile.
  36.  
  37. * itex.c
  38.  
  39.   When compiled with '-DINITEX' my ram disk would overflow while
  40.   writing the temporary assembler file. Changing the 'TEMP'
  41.   environment variable to a partition with enough free blocks
  42.   circumvented this problem.
  43.  
  44. * tex6.c 
  45.  
  46.   To compile this file with the default 'CFLAGS' I had to strip my
  47.   auto folder to the bare minimum to get maximum memory. I also had to
  48.   compile the file by hand without the control of the 'make' utility.
  49.   The reason, that the compilation of this file takes so much memory
  50.   is the number of getc() functions calls (93). By default 'stdio.h'
  51.   is setup to include the getc() routine as inline code. You can
  52.   reduce the memory usage by compiling this file with the additional
  53.   option '-D__NO_INLINE__'. With this defined this file also compiled
  54.   with the default auto folder.
  55.  
  56. * mf9.c
  57.  
  58.   The same restrictions as mentioned with 'tex6.c' apply to this file,
  59.   except that you CAN'T reduce the memory requirements. The auto
  60.   folder MUST be stripped to the bare minimum. There is NO way do
  61.   decrease memory usage by giving some additional option. So, you are
  62.   out of luck, when have only 2 megs.
  63.  
  64. Also, if possible use a 'make' utility with a small memory usage. With
  65. GNU-Make v3.58 there is more than one file, which can't be compiled
  66. under the control of the makefile, because the compiler reports
  67. 'Virtual memory exhausted'.
  68.  
  69. It should be possible to generate new TeX or Metafont versions with
  70. different internal buffer sizes by changing the respective contants in
  71. 'texd.h' or 'mfd.h', but I didn't test this. I alway regenerated the C
  72. files from the WEB sources, when I changed a constant.
  73.  
  74. The general directory structure for the sources is as follows (the '/'
  75. in the first column marks a directory):
  76.  
  77.     defaults.h
  78.     site.h
  79.  /  common/common.h
  80.           /extra.c
  81.           /extra.h
  82.           /fileio.c
  83.           /fileio.h
  84.           /main.c
  85.           /makefile
  86.           /texmf.c
  87.           /texmf.h
  88.  /  mf/coerce.h
  89.       /fixcoerc.h
  90.       /imf.c
  91.       /makefile
  92.       /memory.h
  93.       /mf.poo
  94.       /mf0.c
  95.        ....
  96.       /mf18.c  
  97.       /mfd.h
  98.  /  mf/mfwindow/hp2627.c
  99.            /makefile
  100.            /sun.c
  101.            /tek.c
  102.            /uniterm.c
  103.            /x10.c
  104.            /x11-xlib.c
  105.            /x11-xt.c
  106.            /x11.c   
  107.  /  tex/coerce.h
  108.        /fixcoerc.h
  109.        /itex.c
  110.        /makefile
  111.        /memory.h
  112.        /tex.poo
  113.        /tex0.c
  114.         ....
  115.        /tex16.c
  116.        /texd.h
  117.  
  118. The archive for the TeX sources contains the following files:
  119.  
  120. - readme.src
  121. - site.h
  122. - defaults.h
  123. - texsrc.lzh    files to go into the tex directory
  124. - common.lzh      "      "        "  common directory
  125.  
  126. The archive for the Metafont sources contains the following files:
  127.  
  128. - readme.src
  129. - site.h
  130. - defaults.h
  131. - mfsrc.lzh    files to go into the tex directory
  132. - mfwindow.lzh    "      "        "  mf/mfwindow directory
  133. - common.lzh      "      "        "  common directory
  134.  
  135. The files readme.src, site.h, defaults.h and common.lzh are duplicated
  136. for convinience.
  137.  
  138. --
  139. Regards
  140. Frank Ridderbusch
  141.  
  142. Email:
  143. ridderbusch.kd@nixdorf.com    (Amerika (North & South))
  144. ridderbusch.kd@sni.de        (Rest of World)
  145.  
  146. Snail:
  147. Frank Ridderbusch
  148. Sander Str. 17
  149. W-4790 Paderborn
  150. Germany
  151.