home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c025 / 1.ddi / READ.ME < prev    next >
Encoding:
Text File  |  1985-02-22  |  11.4 KB  |  320 lines
  1. RELEASE NOTES FOR RUN/C 1.1, (c) 1984, 1985 by Age of Reason Co.
  2.  
  3. February 20, 1985                                         9B 2A 
  4.  
  5. IMPORTANT::::>>>>     IF  YOU HAVE NOT MADE BACK-UP SAFETY COPIES 
  6. OF  THE  DISTRIBUTION DISK ...
  7.  
  8.      STOP ... DO NOT PASS GO
  9.  
  10.            GO DIRECTLY TO THE RUN/C MANUAL OR DOS MANUAL 
  11.                GET INFORMATION ON THE COPYING PROCESS
  12.  
  13.                     MAKE SEVERAL SAFETY BACK UP COPIES OF THE 
  14.                      DISTRIBUTION DISK. 
  15.  
  16.                          PUT THE DISTRIBUTION DISK SAFELY AWAY.
  17.  
  18. Now you may continue reading ...
  19.  
  20. In READ.ME you will find:
  21.  
  22.     1) new bug reports -- at the end of this file
  23.     2) information on the program on the disk
  24.     3) a technique described how to make certain that the copy
  25.            of RUN/C you received was properly copied to your disk.
  26.     4) a list of the files on the disk.
  27.     5) a copy of SDIR.COM, a sorted directory program.
  28.  
  29. INFORMATION ON RC.EXE
  30.  
  31. The RUN/C executable program is called:
  32.  
  33.     RC.EXE
  34.  
  35. and is invoked with the command:
  36.  
  37.     A>RC<enter>  -- <enter> being the return key
  38.  
  39. In order for RUN/C to work properly you need:
  40.  
  41.     1. Either a PC DOS or MS-DOS system
  42.  
  43.     2. DOS 2.0 or greater
  44.  
  45.     3. A double-sided, double-density disk with at least 360k
  46.            bytes.
  47.  
  48.     4. Either a PC, PC "clone" OR Microsoft's 
  49.            ANSI.SYS,  the MS-DOS screen configuration file. (This 
  50.            file  and  its  functions is described  in  the  RUN/C 
  51.            documentation.)
  52.  
  53.     5.    At least 256k of RAM. If you have more, RUN/C will use 
  54.            more.   If  you  have  less  we  respectfully  suggest 
  55.            expanding your system. Most programs will require 256k 
  56.            of  memory within a year or two as the cost of  memory 
  57.            falls and the use of high level languages for  program 
  58.            writing increases.
  59.  
  60.  
  61. CHECKING YOUR COPY OF RUN/C FOR ACCURACY
  62.  
  63. There  is  a technique for verifying that your copy of RUN/C  was 
  64. properly  copied and undamaged in shipment.  The technique  takes 
  65. the  sum of the bytes  in the file. 
  66.  
  67. In  order to CHECK the SUM you must have the same program we used 
  68. to  establish  the initial comparison value.  Therefore  we  have 
  69. included a program which a generous  person placed in the PC User 
  70. Group  library several years ago.  The name of this  program  was 
  71. CRCK4.COM, but for our purpose we have renamed it:
  72.  
  73.     CHECKFIL.COM
  74.  
  75. In order to use CHECKFIL to find out if the checksum of RC.EXE is 
  76. correct type:
  77.  
  78.     A>CHECKFIL RC.EXE<enter>
  79.  
  80. On a floppy disk taking the check sum of RC.EXE takes more than a 
  81. minute.  It is much faster on a hard (fixed) disk and even faster 
  82. on a RAM disk.
  83.  
  84. Anyway, eventually your screen will look something like:
  85.  
  86.          CRCK ver 4.2B (MS DOS VERSION )
  87.          CTL-S pauses, CTL-C aborts
  88.  
  89.          --> FILE:  RC      .EXE         CRC = 9B 2A
  90.  
  91.           ---------------------> SUM OF CRCS = 9B 2A
  92.  
  93.          DONE
  94.  
  95. If you run the included CHECKFIL program a the resulting sum  for 
  96. RC.EXE is anything other than 
  97.  
  98.      9B 2A
  99.  
  100. for this release of RUN/C -- something is amiss. Either we made a 
  101. mistake or you have a damaged disk or improperly copied program.
  102.  
  103. Incidentally, now that you have CHECKFIL you can use it to check  
  104. the  integrity  of  other programs or  groups  of  programs.  For 
  105. example,  you  could get the check sum of every file on the  disk 
  106. and a total for all the resultant sums with the command:
  107.  
  108.     CHECKFIL *.*<enter>
  109.  
  110.  
  111. FILES ON DISK
  112.  
  113. For  your convenience we have also provided SDIR.COM, a directory 
  114. program  which  allows you to get an alphabetical listing of  the 
  115. files  on  your  disk.   
  116.  
  117. Here are  the  names of the files on the RUN/C distribution disk:
  118.  
  119. RC       EXE    READ     ME     SDIR     COM
  120. CHECKFIL COM    RCANSLIB C      8087TEST C      RCIBMLIB C      ACOS     C  
  121. AGET     C      APUT     C      ASCII    C      ASIN     C      ATAN     C  
  122. ATOF     C      ATOI     C      ATOL     C      CALLOC   C      CEIL     C  
  123. CLOSE    C      CLRERR   C      CONTINUE C      COS      C      CREAT    C  
  124. DOSDATE  C      DOSTIME  C      EXIT     C      EXP      C      FABS     C  
  125. FCLOSE   C      FEOF     C      FERROR   C      FFLUSH   C      FGETC    C  
  126. FGETS    C      FLOAT    C      FLOOR    C      FOPEN    C      FOR      C  
  127. FPRINTF  C      FPUTC    C      FPUTS    C      FREOPEN  C      FSCANF   C  
  128. FSEEK    C      FTELL    C      FTOC     C      GETC     C      GETCH    C  
  129. GETCHAR  C      GETS     C      GOTO     C      HELLO    C      INKEY    C  
  130. IS_TESTS C      LOCATE   C      LOG      C      LPRINTF  C      LPUTC    C  
  131. LPUTS    C      LSEEK    C      MAIN     C      MALLOC   C      OPEN     C  
  132. OUTP     C      PEEK     C      POKE     C      POW      C      PRINTF   C  
  133. PRINTF2  C      PUTC     C      PUTCHAR  C      PUTS     C      RAND     C  
  134. READ     C      RENAME   C      RETURN   C      REWIND   C      SCANF    C  
  135. SETCOM   C      SIN      C      SINH     C      SIZEOF   C      SPRINTF  C  
  136. SQRT     C      SRAND    C      SSCANF   C      STATIC   C      STRCAT   C  
  137. STRCMP   C      STRCPY   C      STRIP    C      STRLEN   C      STRUCT   C  
  138. SWITCH   C      TAN      C      TOLOWER  C      TOUPPER  C      UNGETC   C  
  139. UNGETCH  C      UNION    C      UNLINK   C      VOID     C      WRITE    C  
  140. FSCANF   TST    TEST     FIL    CAPTURE         READ     BAK    
  141.  
  142. In  most cases the programs with ".C" extensions such  as  GETC.C 
  143. are the same program as is listed as an example of the use of the 
  144. function in Chapter 4 of the RUN/C manual.
  145.  
  146. In addition the following example C programs are included:
  147.  
  148.     1)    ftoc.c    -- K&R's fahrenheit to centigrade program
  149.  
  150.     2)    hello.c    -- K&R's first and most famous program
  151.  
  152.     3)    strip.c    -- RUN/C author Steve Walton has  contributed 
  153.                            a version of his High-Bit Nosher which 
  154.                            positively  pulverizes  all  the  high 
  155.                            bits  in WordStar(tm) files  -- making 
  156.                            the  files  much more readable at  the 
  157.                            DOS   level   and  with   other   word 
  158.                            precessors. 
  159.  
  160.     4)   ascii.c    -- Helps determine  what your favorite  daisy 
  161.                            wheel prints when you ask for an ASCII 
  162.                            character.  Works  great  with  SMART- 
  163.                            PRINT,   the   companion  program  for 
  164.                            SMARTKEY. Turn printer on before using.
  165.  
  166.     5)    Source code for cls() and locate() functions
  167.  
  168.         The  C  source  code for two special functions in RUN/C 
  169. (locate() and cls() are included on the disk in two files:
  170.  
  171.             RCANSLIB.C -- for MS-DOS system running ANSI.SYS
  172.             RCIBMLIB.C -- for PC DOS and close compatibles
  173.  
  174.         (See Chapter 1 in the manual for a more on ANSI.SYS.)
  175.  
  176.         The source code can be "#included" when compiling programs 
  177. which use the RUN/C functions locate() or cls(). Alternatively, they 
  178. can be compiled into object modules for inclusion in a program during
  179. the link process.
  180.  
  181. SDIR,  another  public  domain  program which  we have included to 
  182. help  you  manage  the more than 90 files on our distribution disk 
  183. has many hidden features which you can find out all about with the 
  184. command:
  185.  
  186.     A>SDIR /?<enter>
  187.  
  188.  
  189.  
  190. MORE UPDATE NOTES TO RUN/C 1.11
  191. Feb. 22, 1985
  192.  
  193. Dear RUN/C Pioneer:
  194.  
  195. These notes and the enclosed disk and manual completely update the 1.0 RUN/Cì
  196. Pioneer Version to the fully released 1.1 RUN/C. This kit contains newì
  197. software, a new manual and registration materials.
  198.  
  199. About the software
  200.  
  201. RUN/C 1.1 includes many new sample programs, a new RC.EXE and source code forì
  202. our cls() and locate() functions for both PC native and ANSI.SYS systems. Theì
  203. following changes, corrections and improvements have been made in Version 1.1ì
  204. of RUN/C:
  205.  
  206.         a)    structures, unions and initializers have been added. Structuresì
  207. (only) include bitfields and structures, unions and multidimensional arrays canì
  208. be initialized.
  209.  
  210.         b)    arguments to main() are now supported. These can be delivered toì
  211. the program either from the DOS command line or in conjunction with the RUNì
  212. command.
  213.  
  214.         c)    Screen/keyboard I/O can now be redirected from the RUN/C commandì
  215. line. Input can be supplied from a disk file and output can be redirected fromì
  216. the screen to a disk file.
  217.  
  218.         d)    inp and outp have been implemented to provide access to systemì
  219. ports.
  220.  
  221.         e)    peek and poke have been implemented to provide the ability toì
  222. directly read and write to absolute addresses in memory.
  223.  
  224.         f)    aputc and agetc have been changed to aput and aget,ì
  225. respectively.
  226.  
  227.         g)    time and date have been renamed dostime and dosdate,ì
  228. respectively.
  229.  
  230.         h)    rename has been implemented, allowing files to be renamed byì
  231. RUN/C programs.
  232.  
  233.         i)    DIR has been implemented as an alias for the FILES command.
  234.  
  235.         j)    a SET EDITOR command has been implemented to allow you toì
  236. specify an alias for EDITOR.COM or EDITOR.EXE.
  237.  
  238.         k)    Many capacities have changed:
  239.  
  240.             *    There is no longer a fixed maximum number of arrays.
  241.  
  242.             *    The terms YES, NO, TRUE, FALSE are no longer predefined.
  243.  
  244.             *    The maximum number of #defines and #includes has beenì
  245. raised from 20 to 50.
  246.  
  247.             *    The maximum space for struct and union definitions is setì
  248. to 2800 bytes.
  249.  
  250.             *    The program has grown to about 185k from 170k.
  251.  
  252.             *    Execution speed has increased by a factor of 2.
  253.  
  254.             *    Up to seven level of complexity are now supported. This canì
  255. take the form of seven-dimensional arrays or a pointer to an array of an arrayì
  256. of an array of structures, etc. (you get the idea).
  257.  
  258.  
  259. BUG FIXES
  260.  
  261. *    Previously announced support for the 8087 math chip should now work on allì
  262. systems. In 1.0 it worked on our computer, but few others.
  263.  
  264. *    void and static have been improved considerable.
  265.  
  266.  
  267. About the manual
  268.  
  269. The new manual contains a table of contents and listing of functions, commandsì
  270. and other keywords by category (at the beginning of Section 4). See the list ofì
  271. software changes (above) for indication of new and renamed keywords which areì
  272. reflected in the manual.
  273.  
  274.  
  275. Too late to classify:
  276.  
  277. Error message 19 now reads: Stack underflow or misuse of 'void' function inì
  278. expression evaluation. The later portion of this statement indicates that anì
  279. attempt has been made to return a value from a function which has been declaredì
  280. void.
  281.  
  282. In addition, the following unnumbered error messages have been added:
  283.  
  284.  
  285. Variable or function not found. A variable or function has been called in theì
  286. program which is neither a built-in or user declared function nor is it aì
  287. properly declared variable.
  288.  
  289. Too many arguments to built-in func. An attempt has been made to call aì
  290. function with too many arguments.
  291.  
  292. Too few arguments to built-in func. An attempt has been made to call a functionì
  293. with too few arguments.
  294.  
  295. Not implemented special function. Should not appear under normal circumstances.
  296.  
  297. Invalid or unimplemented built-in function. Should not appear under normalì
  298. circumstances.    21, 
  299.  
  300.  
  301. Thank you once again for your patronage and the enthusiasm which so many of youì
  302. have expressed for this effort.
  303.  
  304. Age of Reason Co.
  305.  
  306.  
  307.  
  308.  
  309. RUN/C 1.11 -- Known bugs and deficiencies
  310.  
  311. *    Pointers to functions are not currently supported.
  312.  
  313. *    Pointers into arrays of structs or unions may yield spurious errors whenì
  314. attempts are made to access elements of those arrays through them.
  315.  
  316. *    sizeof does not return correct results for all abstract data types;ì
  317. specifically, to get the sizeof an int, declare int a and then take theì
  318. sizeof(a). sizeof does correctly return sizes in bytes of specific arrays,ì
  319. structs and unions.
  320.