home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / fortran / library / comline / readme.txt < prev   
Text File  |  1991-07-01  |  5KB  |  102 lines
  1. COMLINE.ASM and FORTCK.FOR :
  2.  
  3.    These were are files that I have found useful in writing MICROSOFT FORTRAN
  4. files, I do not guarantee that they will with any other version of FORTRAN or
  5. on any system other than the IBM PC (tested on an XT, AT, 386 and will most 
  6. likely work with any DOS 2.0 or higher IBM machines).
  7.  
  8.    Please distribute them in this unmodified form in COMLINE.ZIP or if you
  9. prefer another archive format.
  10.  
  11.    Include the files:
  12.    
  13.           COMLINE.ASM  - Command line translator (Borland Turbo Assembler)
  14.           COMLINE.OBJ  - Linkable object file 
  15.           C_CLINE.C    - C demo                  (MS Quick C)
  16.           QB_CLINE.BAS - Basic demo              (MS Quick Basic)
  17.           P_CLINE.PAS  - Pascal demo             (Borland Turbo Pascal)
  18.           FORTCK.FOR   - Fortran file checker    (MS Fortran)
  19.           FORTCK.EXE   -    Run time version
  20.           README.TXT   - This file
  21.           README.BAT   -    Stupid batch file to read this file
  22.           ALLCHARS.255 - All 255 characters, to test FORTCK and other programs
  23.  
  24.  
  25. COMLINE:
  26.  
  27.    This will read information from the DOS Command line when you initially
  28. run a EXE file.  The information is returned in a CHARACTER*128 string with
  29. the first character being the length of the string.  The string is terminated
  30. with a carriage return.  An example of how to use COMLINE is provided in 
  31. FORTCK.FOR and the other demo programs.
  32.  
  33.    COMLINE is totally self contained ASSEMBLY language, but it was written
  34. to work via a FORTRAN style FAR PROCEDURE call.  Therefore other languages
  35. must follow the FORTRAN FAR calling convention (where the address of the
  36. rightmost argument is the first thing pushed to the stack, high byte first,
  37. before the return address, all of which must be 32 bit addresses).
  38.  
  39. FORTCK:
  40.  
  41.    FORTCK will check a program for anything that is not a FORTRAN readable
  42. character (ASCII [32 - 126] + CR/LF).
  43.  
  44.           !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`
  45.           abcdefghijklmnopqrstuvwxyz{|}~   and SPACE
  46.  
  47. It is designed to indicate embedded control characters and also to detect
  48. a broken carriage return/line feed sequence, which my editor occasionally
  49. slips in.
  50.  
  51.    There are a few command line options (none are case sensitive and they may
  52. begin with '-' or '/'):
  53.          /s###  : Skip ASCII value
  54.                   Where ### is a number corresponding to an ASCII character
  55.                   code.  The number may be up to 3 characters long.  If the
  56.                   last character is an 'H' then the number is assumed to be
  57.                   hexadecimal.  If more than one number is specified, they
  58.                   must be 3 characters long (the leading zeroes must be 
  59.                   entered).  If you only include one number, it may be from
  60.                   one to three characters.  This option may be called
  61.                   repeatedly.
  62.                   If the character specified is in the "legal" range of this
  63.                   program (SPACE to ~), the character is marked as bad and
  64.                   any occurrences of the character are displayed.  If a CR
  65.                   is specified, the CR/LF sequence check is not completed.
  66.         /a$     : Skip ASCII character
  67.                   Where $ is an ASCII character.  The characters are typed
  68.                   directly you may include up to MAXSKIP characters.  This
  69.                   option may be called repeatedly.
  70.                   This option may also be used to mark bad characters bad.
  71.         /f      : Fix on (+)
  72.                   The program will delete any bad characters (and fix
  73.                   any broken CR/LF sequence).  This is done in the file:
  74.                   FIXED.TXT, your original file is left intact.
  75.         /? /h   : Print help summary screen
  76.  
  77. DEMOS IN OTHER LANGUAGES:
  78.  
  79.    I wanted to test the portability of COMLINE.ASM to different languages on
  80. the IBM PC.  The test files show the proper way to set up the subroutine as
  81. a FAR call (variables and return) and will then print out the length of the 
  82. string and the data contained in the string.  All the variables that I tested
  83. were fixed length strings, which really aren't much of a problem; however, 
  84. with variable length strings, the termination character varies from language
  85. to language.
  86.  
  87.    The Pascal routine wasn't really necessary for Turbo Pascal since it has
  88. command line information as a built in feature, but it should give 
  89. other interested Pascal programmers a push in the right direction.
  90.    
  91.  
  92.  
  93.  
  94.    Again, I am very poor so contributions of any dollar amount will be
  95. greatly appreciated.  Send them to:
  96.                                      Scott Heavner
  97.                                      19 Pine Woods Drive
  98.                                      North Tonawanda, NY 14120
  99.  
  100.    If you have any comments or suggestions, email them to sdh@po.cwru.edu
  101.  
  102.