home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / qtawk / read.me < prev    next >
Text File  |  1990-11-11  |  15KB  |  311 lines
  1.     QTAwk  version  4.20,  dated  10/10/90.    This  version  contains    two
  2.     additions from the previous version:
  3.  
  4.     1) The behavior of the RS pre-defined variable has been changed.  It is
  5.        now similar to the behavior of the FS variable.    If RS is assigned a
  6.        value, which when converted to a string value, is a single character
  7.        in length, then that character becomes the record separator.  If the
  8.        string  is  longer  in  length  than  a single character, then it is
  9.        treated as a  regular expression.   The string matching    the regular
  10.        expression is treated as a record separator.  As for FS, the  string
  11.        value is converted to the internal regular expression form when    the
  12.        assignment  is  made.    To  obtain  the  same behavior for RS as in
  13.        previous  versions,  use  the  character  class operator for regular
  14.        expressions.  If s was the string previously used for RS, then use:
  15.  
  16.        RS = /[s]/;
  17.  
  18.     2) Two new functions have been added:
  19.  
  20.        getc() -->  reads a  single character  from the    current input file.
  21.        The character is returned by the function.
  22.  
  23.        fgetc(file) --> reads a single character from the file 'file'.   The
  24.        character is returned by the function.
  25.  
  26.        These functions allow the user to naturally obtain single characters
  27.        from any file including the standard input file (which would be    the
  28.        keyboard if not redirected or piped).
  29.  
  30.     2) Error messages now have    a numerical value displayed in    addition to
  31.        the short error message.  The error messages are listed in numerical
  32.        order in  the QTAwk  documentation with    a short  explanation of the
  33.        error.  In some cases, an attempt has been made to provide  guidance
  34.        as to what may have caused  the error and possible remedies.   Since
  35.        the error messages  are generated at  fixed points within  QTAwk and
  36.        may be  caused by  different reasons  in different  utilities during
  37.        compilation or during execution on data files, it is not possible to
  38.        list every possible  reason for the  display of the  error messages.
  39.        The line  number within    the QTAwk  utility on  which the  error was
  40.        discovered and the input data file record number are provided in the
  41.        error message  to provide  some help  to the  user in  attempting to
  42.        ascertain the real reason for the error.
  43.  
  44. ===========>
  45.  
  46.     QTAwk Version  4.10, dated    09/14/90, contained  one addition  from the
  47.     previous version:
  48.  
  49.     1)    In  previous  versions,  the  GROUP  pattern  keyword  could accept
  50.     patterns consisting  only of  a regular  expression constant.    For
  51.     version 4.10, The GROUP pattern keyword has been expanded to accept
  52.     regular expression constants, string constants and variables.    The
  53.     variables are evaluated  at the time  the GROUP patterns  are first
  54.     utilized to scan an input record.  The value is converted to string
  55.     form and interpreted as a regular expression.
  56.  
  57. ===========>
  58.  
  59.     Version 4.01 contained two additions from the previous version:
  60.  
  61.     1)    The  command  line  argument,  double  hyphen,    "--", stops further
  62.     scanning  of  the  command  line  for  options.   The double hyphen
  63.     argument is not passed    to the QTAwk utility  in the ARGV array  or
  64.     counted in  the ARGC  variable.   Since QTAwk  only recognizes    two
  65.     command options, this has been    included to be compatible with    the
  66.     latest Unix(tm) conventions.
  67.  
  68.     2) The built-in array ENVIRON has been added.  This array contains    the
  69.        environment strings passed to QTAwk.   Changing a string in  ENVIRON
  70.        will have no effect on  the environment strings passed in  the QTAwk
  71.        "system" built-in function.   Environment strings  are set with  the
  72.        PC/MS-DOS "SET" command.  The strings are of the form:
  73.  
  74.        set name = string
  75.  
  76.        where the blanks on either side of the equal sign, '=', are optional
  77.        and depend on the  particular form used in  the "SET" command.   The
  78.        QTAwk utility may scan the elements of ENVIRON for a particular name
  79.        or string as desired.
  80.  
  81. ***********>
  82.  
  83.     Total  QTAwk  package  to  registered  users  consists of the following
  84.     files:
  85.  
  86.        1) qtawk.exe    ==> QTAwk executable with 8086/88 processor
  87.                and up with/without numeric coprocessor
  88.  
  89.        2) qtawkf.exe   ==> QTAwk executable with 8086/88 processor
  90.                and up with           numeric coprocessor
  91.  
  92.        3) qtawk2.exe   ==> QTAwk executable with 80286 processor
  93.                and up with/without numeric coprocessor
  94.  
  95.        4) qtawk2f.exe  ==> QTAwk executable with 80286 processor
  96.                and up with           numeric coprocessor
  97.  
  98.        5) qtawkn.exe   ==> QTAwk database for Norton Online Guides
  99.                Self-extracting compressed file
  100.  
  101.        6) qtawku.exe   ==> Archive of QTAwk utilities
  102.                Self-extracting compressed file
  103.  
  104.        7) qtawkd.exe   ==> QTAwk Documentation w/QTAwk utility to display
  105.                Self-extracting compressed file
  106.  
  107.        8) qtgrep.exe   ==> Documentation for shareware program
  108.                Self-extracting compressed file
  109.  
  110.        9) xb.exe       ==> Documentation for shareware program
  111.                Self-extracting compressed file
  112.  
  113.       10) diffdoc.fmt  ==> Differences between QTAwk and AWK
  114.  
  115.       11) license.fmt  ==> QTAwk registration notice
  116.  
  117.       12) order.frm    ==> QTAwk registration form
  118.  
  119.       12) qtawk.man    ==> QTAwk Unix(tm) style manual pages
  120.  
  121.       13) read.me      ==> This file
  122.  
  123.       14) prod_lis.t   ==> Other shareware products available
  124.  
  125.     The self-extracting files contain compressed forms of the
  126.     following files:
  127.  
  128. ------ Self-extracting File List ------
  129.  
  130. QTAWKU.EXE - QTAwk Utilities Archive
  131.  
  132.   Name        Original    Packed  Ratio   Date     Time   Attr Type  CRC
  133. --------------    --------  -------- ------ -------- -------- ---- ----- ----
  134.   ADDCOMMA.EXP         591       359  60.7% 90-01-07 17:13:44 ---w -lh1- F87A
  135.   ALARM.EXP        4071      1607  39.5% 90-07-25 21:29:46 ---w -lh1- 6929
  136.   ANSICLST.EXP        7227      1730  23.9% 90-04-30 20:46:26 ---w -lh1- 677E
  137.   ANSICSTD.EXP        3619      1564  43.2% 90-04-23 21:27:34 ---w -lh1- 2FFC
  138.   ANSIRSV.EXP        1973       612  31.0% 89-04-28 20:55:58 ---w -lh1- FDA2
  139.   ANSIRSVG.EXP        1514       605  40.0% 89-04-28 20:53:16 ---w -lh1- DD7E
  140.   APPTADD.EXP        4813      1918  39.9% 90-07-25 21:30:46 ---w -lh1- B50C
  141.   APPTDIS.EXP        4374      1760  40.2% 90-07-25 21:31:18 ---w -lh1- 6E01
  142.   CALCIN.EXP        9027      3287  36.4% 90-09-27 20:12:24 ---w -lh1- 86BC
  143.   CALCINNA.EXP        8095      3133  38.7% 90-09-27 20:14:16 ---w -lh1- 9C76
  144.   CALCRP.EXP       20781      6324  30.4% 90-11-09 21:22:08 ---w -lh1- 24EB
  145.   CALCRPNA.EXP       19406      6095  31.4% 90-11-09 21:22:04 ---w -lh1- D929
  146.   CALEXPT.EXP        5198      1869  36.0% 90-04-30 21:03:30 ---w -lh1- 6D53
  147.   CALNDPRT.EXP        3222      1258  39.0% 90-04-23 21:29:44 ---w -lh1- 37FB
  148.   CDCL.EXP        6215      1786  28.7% 90-04-30 21:03:40 ---w -lh1- 2F56
  149.   CLICHE.EXP         298       201  67.4% 89-03-15 17:59:48 ---w -lh1- 1964
  150.   COMPAT.EXP        3547      1574  44.4% 90-05-02 20:01:02 ---w -lh1- 615C
  151.   COMPRESS.EXP         307       190  61.9% 90-04-23 21:30:32 ---w -lh1- E3B8
  152.   CRV.DAT         264       174  65.9% 90-01-05 21:16:18 ---w -lh1- B5C6
  153.   CURVEFIT.EXP       11800      3714  31.5% 90-04-30 21:03:52 ---w -lh1- E5B9
  154.   DATE.EXP        1160       620  53.4% 90-04-23 21:30:56 ---w -lh1- 2474
  155.   DIFFDOC.FMT       13966      5400  38.7% 90-10-22 20:34:12 ---w -lh1- 7917
  156.   FILENAME.EXP        1055       568  53.8% 90-04-23 21:31:12 ---w -lh1- 8AF4
  157.   FIN.EXP       28186     10128  35.9% 90-05-16 15:26:42 ---w -lh1- A41D
  158.   FIN.INP         225       129  57.3% 90-03-06 16:56:06 ---w -lh1- 2069
  159.   FINNA.EXP       26779      9850  36.8% 90-05-16 15:26:30 ---w -lh1- E9FA
  160.   FMTDOC.EXP       27754      9253  33.3% 90-04-29 20:20:30 ---w -lh1- 2EB9
  161.   FMTDOC2P.EXP       28123      9377  33.3% 90-04-29 20:20:34 ---w -lh1- DF5E
  162.   GEODH.EXP        4794      1700  35.5% 90-04-23 21:32:30 ---w -lh1- DB07
  163.   GETDIR.EXP        3987      1709  42.9% 90-07-25  9:02:32 ---w -lh1- 1856
  164.   GRAPH.EXP        3387      1345  39.7% 90-04-23 21:32:52 ---w -lh1- 03E2
  165.   HISTOGRM.EXP         763       446  58.5% 90-04-23 21:33:24 ---w -lh1- 048D
  166.   HOLIDAY.EXP        4971      1633  32.9% 90-04-23 21:33:52 ---w -lh1- AD97
  167.   LICENSE.FMT        8095      3387  41.8% 90-11-10 16:42:26 a--w -lh1- 00ED
  168.   LINENUM.EXP          22    22 100.0% 89-03-07 20:47:44 ---w -lh0- 2723
  169.   MORE.EXP       19624      7112  36.2% 90-10-09 21:25:20 ---w -lh1- C779
  170.   MOREQ.BAT          64    62  96.9% 90-08-05 19:55:54 ---w -lh1- FF4A
  171.   PRDN.EXP        1141       256  22.4% 90-04-23 21:34:52 ---w -lh1- 572E
  172.   READ.ME       11966      4826  40.3% 90-11-10 20:52:56 a--w -lh1- 0323
  173.   ROMN.EXP        2137       746  34.9% 90-04-23 21:35:00 ---w -lh1- EC84
  174.   SCREEN.EXP        4460      1352  30.3% 90-04-23 21:35:32 ---w -lh1- CDDB
  175.   SINCOS.EXP        2710      1143  42.2% 90-02-10 19:47:22 ---w -lh1- D70F
  176.   SLIKE.EXP        3993      1740  43.6% 90-04-23 21:35:52 ---w -lh1- 4054
  177.   SOUNDIX.EXP        3418      1546  45.2% 90-03-31 18:58:14 ---w -lh1- 3433
  178.   SOUNDX4.EXP        2926      1167  39.9% 90-04-23 21:36:22 ---w -lh1- 8BE4
  179.   SSFUNCS.EXP       14208      1865  13.1% 90-04-29 21:50:42 ---w -lh1- 2D33
  180.   STATE.EXP         706       331  46.9% 89-11-25 18:23:44 ---w -lh1- A7E6
  181.   STATES.DTA        3575      1836  51.4% 89-10-29 19:31:20 ---w -lh1- 5637
  182.   TABLE.EXP         809       451  55.7% 90-02-10 19:56:58 ---w -lh1- C632
  183.   TOC.EXP        1268       667  52.6% 90-04-23 21:37:08 ---w -lh1- D1AC
  184.   WORDFREQ.EXP         962       565  58.7% 90-02-10 20:25:16 ---w -lh1- 53CA
  185. --------------    --------  -------- ------ -------- --------
  186.     52 files      344382    121337  35.2% 90-11-10 21:01:52
  187.  
  188. QTAWKN.EXE - QTAwk Database for Norton Online Guides
  189.  
  190.   Name        Original    Packed  Ratio   Date     Time   Attr Type  CRC
  191. --------------    --------  -------- ------ -------- -------- ---- ----- ----
  192.   DIFFDOC.FMT       13966      5400  38.7% 90-10-22 20:34:12 ---w -lh1- 7917
  193.   LICENSE.FMT        8095      3387  41.8% 90-11-10 16:42:26 ---w -lh1- 00ED
  194.   ORDER.FRM       12380      4747  38.3% 90-11-10 16:58:40 ---w -lh1- A9B4
  195.   QTAWK.NG      121970     43839  35.9% 90-10-10 20:55:56 ---w -lh1- 7D69
  196.   READ.ME       14758      5734  38.9% 90-11-10 21:03:24 a--w -lh1- DF6A
  197. --------------    --------  -------- ------ -------- --------
  198.      6 files      171997     63470  36.9% 90-11-10 21:09:22
  199.  
  200. QTAWKD.EXE - QTAwk Documentation
  201.  
  202.   Name        Original    Packed  Ratio   Date     Time   Attr Type  CRC
  203. --------------    --------  -------- ------ -------- -------- ---- ----- ----
  204.   DIFFDOC.FMT       13409      5382  40.1% 90-11-04 16:46:34 ---w -lh1- F951
  205.   LICENSE.FMT        8095      3387  41.8% 90-11-10 16:42:26 a--w -lh1- 00ED
  206.   ORDER.FRM       12380      4747  38.3% 90-11-10 16:58:40 a--w -lh1- A9B4
  207.   PROD_LIS.T        2077      1006  48.4% 90-07-22 18:46:12 ---w -lh1- A98F
  208.   QTAWK.DOC      344917     93948  27.2% 90-11-10 20:23:48 ---w -lh1- 47A9
  209.   QTAWK.MAN       37508     14864  39.6% 90-11-04 16:44:06 ---w -lh1- F152
  210.   QTGREP.DOC      130828     40974  31.3% 90-11-04 16:50:44 ---w -lh1- 9D30
  211.   READ.ME       12040      4496  37.3% 90-11-10 20:42:56 a--w -lh1- A48F
  212.   XB.DOC       42294     11985  28.3% 90-07-09 20:54:28 ---w -lh1- 9672
  213. --------------    --------  -------- ------ -------- --------
  214.     10 files      604741    181339  30.0% 90-11-10 20:47:02
  215.  
  216. ------ File Description --------
  217.  
  218. Executables:
  219.  
  220. QTAWK    .EXE    with or without 80x87, 8086/8088/80286... (80x87 used if present)
  221. QTAWK2    .EXE    with or without 80x87,         80286... (80x87 used if present)
  222. QTAWK2F .EXE    with        80x87,         80286...
  223. QTAWKF    .EXE    with        80x87, 8086/8088/80286...
  224.  
  225. Utilities:
  226.  
  227. ADDCOMMA.EXP    utility to add commas to numbers
  228. ALARM    .EXP    utility to set TSR alarm from appointment list
  229. ANSICLST.EXP
  230. ANSICSTD.EXP
  231. ANSIRSV .EXP
  232. ANSIRSVG.EXP
  233. APPTADD .EXP    utility to add appointments to data file for alarm/apptdis
  234. APPTDIS .EXP    utility to display todays appointments from alarm data file
  235. CALCIN    .EXP    infix calculator (assumes ANSI.SYS)
  236. CALCINNA.EXP    infix calculator (does not assume ANSI.SYS)
  237. CALCRP    .EXP    reverse polish calculator (assumes ANSI.SYS)
  238. CALCRPNA.EXP    reverse polish calculator (does not assume ANSI.SYS)
  239. CALEXPT .EXP    calender calculation utility
  240. CALNDPRT.EXP    calender calculation utility
  241. CDCL    .EXP    translate C declarations to English
  242. CLICHE    .EXP    cliche creator
  243. COMPAT    .EXP    test compatability of utility to QTawk
  244. COMPRESS.EXP    compress successive blank line in text files
  245. CURVEFIT.EXP    fit data to one or best of 9 curves
  246. DATE    .EXP    date computation utility
  247. FILENAME.EXP    split path and filename.ext
  248. FIN    .EXP    financial calculator (assumes ANSI.SYS)
  249. FINNA    .EXP    financial calculator (does not assume ANSI.SYS)
  250. FMTDOC    .EXP    document formattor
  251. FMTDOC2P.EXP    document formattor - 2 pass
  252. GEODH    .EXP    utility to compare iterative and exact solutions for geodetic Lat.
  253. GETDIR    .EXP    sample utility to get contents of directory
  254. GRAPH    .EXP    graphing utility
  255. HISTOGRM.EXP    histogram utility
  256. HOLIDAY .EXP    compute holidays
  257. LINENUM .EXP    add line numbers to file
  258. MORE    .EXP    display files one screen at a time/search for expressions
  259. PRDN    .EXP    print pre-defined regular expressions
  260. ROMN    .EXP    convert arabic number to roman numeral
  261. SCREEN    .EXP    functions to utilize ANSI.SYS for screen/cursor manipulation
  262. SINCOS    .EXP    graph sine/cosine functions
  263. SLIKE    .EXP    find words which sound like a specified set of words
  264. SOUNDIX .EXP    algorithm for "slike"
  265. SOUNDX4 .EXP    another algorithm for "slike"
  266. SSFUNCS .EXP    standard scoring functions for trade studies
  267. STATE    .EXP    state demostration utility
  268. TABLE    .EXP    table creation utility
  269. TOC    .EXP    line oriented Table of Contents creation utility
  270. WORDFREQ.EXP    count words
  271.  
  272. MOREQ    .bat    batch file driver for more.exp
  273.  
  274. Data:
  275.  
  276. FIN    .INP    sample input file for financial calculator
  277. CRV    .DAT    input data for curvefit.exp
  278. STATES    .DTA    input data file for state.exp
  279.  
  280. Documentation:
  281.  
  282. READ    .ME    this file
  283.  
  284. QTAWK    .MAN    QTAwk Unix(tm) style manual pages
  285.  
  286. QTAWK    .NG    QTawk database for Norton Online Guides
  287.  
  288. QTAWK    .DOC    QTAwk Documentation
  289.  
  290. LICENSE .FMT    QTAwk Registration Notice
  291.  
  292. ORDER    .FRM    QTAwk order form
  293.  
  294. DISPLAY .DOC    QTAwk utility to display QTAwk documentation files
  295.         QTAwk.doc and QTAwk.man. ANSI.SYS display driver must
  296.         be installed to utilize phrase and search highlighting
  297.  
  298. DISPLAY .BAT    Batch file to run display.doc utility - assumes ANSI.SYS
  299.         installed. Use displayn.bat if ANSI.SYS display driver not
  300.         installed. Adaptation of more.exp utility
  301.  
  302. DISPLAYN.BAT    Batch file to run display.doc utility - ANSI.SYS not
  303.         installed. Use display.bat if ANSI.SYS display driver
  304.         installed. Adaptation of more.exp utility
  305.  
  306. DIFFDOC .FMT    QTAwk Differences from
  307.         "Awk Programming Language" by:
  308.             Alfred V. Aho
  309.             Brian W. Kernighan
  310.             Peter J. Weinberger
  311.