home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / qedit / qascii.arc / QASCII.DOC next >
Text File  |  1989-11-01  |  6KB  |  134 lines
  1.  
  2.     QASCII.ZIP  --  An internal patch and ASCII table for QEdit version 2.08+
  3.  
  4.                         Date: August 28th, 1989
  5.  
  6.         THIS FILE MAY BE DISTRIBUTED FREELY, WITH NO RESTRICTIONS.
  7.  
  8.              QEdit is Copyright (C) 1985-1989 by SemWare.
  9.              QMAC is Copyright 1988-1989  by Karl Brendel
  10.  
  11.  
  12. DESCRIPTION
  13. -----------
  14. This set of files implements a "built in" patch and ASCII table for QEdit (version
  15. 2.08, or OS/2 version 1.00).
  16.  
  17. It allows you to place the cursor on a key to be looked up, press one
  18. key, and have the Decimal, Hexadecimal, Binary, and English
  19. representation of that character appear.  The format of the ASCII chart is
  20. completely up to the user, but a sample file is supplied. The patch is
  21. even more amazing since it makes QEdit considerably more user friendly.
  22.  
  23. The files contained within this set are:
  24.  
  25.     QASCII.DOC     --   This file.
  26.     Q208FIX.BAT    --   Shareware accelerator
  27.     QASCII.QM      --   Text version of QEdit ASCII chart macros.
  28.     QASCII.MAC     --   Binary version of QEdit ASCII chart macros.
  29.     QASCII.LST     --   Sample ASCII chart for use with above.
  30.  
  31. QASCII.QM can be "compiled" with QMAC.EXE to form QASCII.MAC.  However, for
  32. those without QMAC, a precompiled copy of QASCII.MAC, which assumes the
  33. ASCII chart is called QASCII.LST and is always in the current directory, is
  34. supplied.
  35.  
  36.                              *** *** ***
  37.  
  38. QUICK INSTALLATION INSTRUCTIONS
  39. -------------------------------
  40. EITHER:   (1) Edit the macros in QASCII.QM to match the location of your
  41.               QASCII.LST file on disk.  You will probably want to specify a
  42.               full path to QASCII.LST in the macros, so that they will
  43.               operate correctly from any directory.
  44.  
  45.               Compile the macros to QASCII.MAC by invoking QMAC:
  46.  
  47.                       QMAC QASCII.MAC QASCII.QM B N
  48.  
  49.               Load the QASCII.MAC into QEdit when editing, using the
  50.               MacroRead command, and execute the two keys as needed.
  51.  
  52. OR:       (2) Add the macros from QASCII.QM into your QCONFIG.DAT, and use
  53.               QCONFIG to configure them permanently into your copy of
  54.               Q.EXE.  Then you will not have to load QASCII.MAC to operate
  55.               these macros, as they will be "permanent" in Q.EXE.
  56.  
  57.               As above, be sure to change the string 'QASCII.LST' to a full
  58.               path specification to your ASCII chart file.
  59.  
  60. After compiling the macros, or running QCONFIG, just make sure that your
  61. QASCII.LST file is present in the appropriate directory, and you are ready
  62. to use the macros.
  63.  
  64.  
  65. ABOUT THE ASCII CHART
  66. ---------------------
  67. The QASCII.LST file is free-form, with one ASCII character represented per
  68. line.  The only restriction is that each character appear between
  69. parentheses in QASCII.LST, only once.
  70.  
  71. The Control-F4 macro requires that the ASCII character itself appear in
  72. Column 24 of each line, and that the first ASCII character appears on line
  73. 6 of the file.  If you change the format of the ASCII chart, you will have
  74. to edit the third macro appropriately, particularly the GotoLine and
  75. GotoColumn commands.
  76.  
  77. The rest of each line in QASCII.LST can contain numeric or other
  78. descriptions of that ASCII character, subject to your whim.  The sample
  79. QASCII.LST displays the character in Decimal, Hexadecimal, Binary, and by
  80. Name.
  81.  
  82. Due to restrictions on ASCII text files, and the way QEdit reads them, the
  83. Carriage Return, Line feed and Tab characters cannot appear "literally" in
  84. the QASCII.LST file.  The sample file has these characters translated to
  85. 00h, but their descriptions are left in for completeness.
  86.  
  87.  
  88. ABOUT THE SHAREWARE ACCELERATOR
  89. -------------------------------
  90. This handy little bugger makes QEdit a truly user friendly program.
  91. Place the debug command, q208fix.bat and q.exe (qedit.exe) in the same
  92. subdirectory for a quick start.  Enter "q208fix" and you will have a
  93. user friendly QEdit. Minor modifications may be necessary to the batch
  94. file, but they should be obvious.
  95.  
  96. WHAT THE MACROS DO
  97. ------------------
  98. The three macros work as follows:
  99.  
  100. (1)  Control-F2 opens the ASCII chart as a window below the current one,
  101. and moves the cursor to the line containing the ASCII character on which
  102. the cursor was sitting in the first file.
  103.  
  104. You can then scroll around in the ASCII chart and look at other characters.
  105. It is up to you to close the window to the ASCII chart when you are done
  106. with it.
  107.  
  108.  
  109. (2)  Control-F3 opens the ASCII chart just long enough to copy the
  110. information on the character, and then it displays it in a dialog box
  111. near the character itself in the original file.  The user can press
  112. Return or Escape to continue editing.
  113.  
  114.  
  115. (3)  Control-F4 opens the ASCII chart, allowing the user to scroll
  116. around within it.  The user can chose an ASCII character he would like
  117. inserted into his original file by moving the cursor to that line.
  118.  
  119. Then, just press RETURN, and that character will be inserted into the
  120. text of the original file at the cursor, exactly as if you typed it.  This
  121. can be much more convenient than having to "type" the character with the
  122. ALT-numeric keypad.
  123.  
  124.  
  125. Try all three macros out to see which one(s) you like best.
  126.  
  127.                              *** *** ***
  128.  
  129. If you have any problems with these files, please contact us via the
  130. SemWare QEdit Support Board, at (404) 641-8968, 2400 bps, 24 hours.
  131.  
  132.                              *** END ***
  133.  
  134.