home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / q.lbr / QL.HZP / QL.HLP
Encoding:
Text File  |  1991-11-18  |  8.5 KB  |  175 lines
  1. ;
  2.                                      QL.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                9k (70)   BFE5  4.1        Ross Presser 1/89        Z3COM7
  6.  
  7.   1- Syntax  2- Usage  3-  Notes                                              
  8.    
  9.    QL is  a 'Quick Look' typer for reasonably sized libraried  or unlibraried,
  10. crunched,  squeezed and normal text and binary files, for Z80 cpu's only under
  11. CP/M 2.0 or later.  
  12.  
  13.    Features include:  fast random access paging  of libraried  or stand-alone,
  14. crunched,  squeezed  or normal text files;  DDT-like display of binary  files, 
  15. crunched,  squeezed or normal;  easy access to  lbr members;  page  numbering;
  16. immediate jump to any page;  core dumping;  fast simple  string searching  for 
  17. text and hex bytes within files and core for reasonably sized files or as much
  18. as can be entirely RAM resident.
  19. :1
  20.  
  21.    Syntax:  QL <afn>   //where <afn> should not match more than 255 files//
  22.  
  23. 1. Type QL.   A vertically oriented,  alphabetized display of all filenames in 
  24.    the current du: will be displayed, with a number next to each one.
  25.    
  26. 2. Pick a number of  a  file to view.   If it's squeezed/crunched,  it will be 
  27.    taken care of.   If it's a library file,  you'll  be presented with   a new 
  28.    screen with all the members listed. 
  29.  
  30. 3. Now view the file, one screen at a time.   Go forward/backward  a page at a 
  31.    time, forward line by line,  or directly to a  specific page by typing  the 
  32.    'page' number, or by using the 'find' command to scan for specific text.
  33.    
  34. 4. Typing '?' will display a help screen  which also gives current settings of 
  35.    the 'toggles' and a summary of the file,  where it is,  its size  in kbytes 
  36.    and number of words and lines if appropriate.
  37.    
  38. 5. Type ^X (or ESC or Q)  to escape  to the previous level.  ^C  (or ^K)  will
  39.    instantly exit to CP/M from any point. 
  40. :2
  41.  
  42. Usage:  Invocation
  43.  
  44.    The  original  invocation  of  QL  may  contain  a  filename specification,
  45. ambiguous or otherwise.   Thus 'QL *.DOC' will limit the 'on screen' selection
  46. display to only those files with  the '.DOC' extension.   If the file is fully 
  47. specified, or if only  one file matches, the select-by-number process  will be 
  48. skipped.   Note that, like a filesweep utility,  just plain 'QL' is equivalent
  49. to 'QL *.*'.
  50.  
  51.  
  52. Usage:  File Extraction (LBR files only) 
  53.  
  54.    At the 'View a member' prompt  you may enter 'E',  as indicated, which will
  55. put  you into  extract mode.   The new prompt  is 'Extract a member:' and  any
  56. members selected  will automatically  be extracted from  the library to a disk
  57. file.   The files will be unsqueezed/uncrunched along the way, if appropriate.
  58. Files are written to  the originally  logged  drive (indicated in the prompt),
  59. even if  the library  resides  on  a different  drive.   The ZCPR version will 
  60. accept a user number in the command line,  and files will be  written  to  the
  61. originally logged  driver and user.   QL will  NOT over-write  a  pre-existing
  62. file without a prompt.
  63.  
  64.    If a library file is  to be specified  on the  command line, you should not
  65. type the .LBR extension.  In this manner,  QL will add the extension and treat
  66. the file as  a library.   If you DO fully specify the  filename (no wildcards,
  67. AND the  extension typed out),  the file will be treated like  a miscellaneous
  68. [binary] file.   The hex dump which  will ensue will  allow you to examine the
  69. 'guts' of  the library's directory.   All other combinations (including selec-
  70. ting a file by number) will result in the file being opened as a library.
  71.  
  72.  
  73. Usage:  Multi-File Use
  74.  
  75.    Version 4.1 adds  the  ability to  view several files,  or LBR members,  in
  76. succession; it can also  be used  to extract some or all of a LBR's members to
  77. disk.  'Multi' mode is activated from the file selection menu:
  78.  
  79.    a. To select  all the files (or members) in  the list,  simply press *.  QL
  80.       will  open each  one in turn.   Once the  file is open,  everything acts 
  81.       normally; you can page forward or backward,  extract members, etc.  When
  82.       finished with a file,  hit ESC (or ^X); QL will pick the next one in the
  83.       list.  ^C aborts at any time.   When all files have been processed,  you
  84.       will be returned to the file selection menu.
  85.  
  86.    b. To select just some of the files in the list,  type  a left parenthesis.
  87.       Then type file numbers from the list.  If you type an invalid number, it
  88.       won't be accepted; you'll hear a beep and it'll be erased.  Type a comma
  89.       between each file number,  and when you have listed all you want, type a
  90.       right parenthesis or just hit return.  QL will open each in in sequence.
  91.  
  92.  
  93. Usage:  Sorting the File List 
  94.  
  95.    You may resort the file list to another order, if you so wish.  At the file
  96. selection  menu,  type S.   The prompt  comes  back 'Sort file beginning at:'.  
  97. This is asking  for the  character position,  in the filename, of the start of
  98. the key.   (The dot between the filename and extension is not included.)   The
  99. most useful numbers to respond with are probably 8,  to sort by extension, and
  100. 0,  if you change your mind and want  to sort by  the entire  name again after
  101. having sorted by extension.   However,  any  number between 0 and 10 inclusive
  102. will work here, and may be useful with specialized filenames.   You may repeat
  103. the sorting process  as many times  as you want,  intermixed with file-viewing 
  104. in any order.  
  105.  
  106.    A word of caution:  the list  of LBR members is  read from disk AGAIN after
  107. each member is  viewed or extracted.   Therefore,  before using the multi-file
  108. options, sort beginning at 0!  Otherwise the file numbers will not be the same
  109. after the first member is processed, and you will miss members from your list,
  110. or possibly miss the first member if using *.
  111.  
  112.  
  113. Usage:  Memory Dump
  114.  
  115.    The memory dump option can be initiated by invoking 'QL CORE'.   (Note that
  116. you must not have any file  on the current DU: called 'CORE' or 'CORE.LBR' for
  117. this to work.)   This will display  the current system memory.   In  core dump
  118. mode, the addresses shown are the actual addresses.   When a file is displayed
  119. in HEX mode,  the  addresses  are  correct  for  a file loaded at 100h,  as is 
  120. normally  the case.   Most commands  are available during core dump,  although
  121. some, notably switching to ASCII, make little sense and would produce strange
  122. displays, and are therefore disabled.
  123.  
  124.  
  125. Usage:  Help Screen
  126.  
  127. QL v4.1 /Z3 26 January 1989
  128.       
  129.   --- While viewing ---              --- Toggle Commands ---
  130.  
  131. <cr>   Forward one page            A   Display ASCII / HEX:  ASCII
  132. <sp>   Forward one line            T   Truncate long lines*    YES
  133. <##>   Go to any page ##           C   Case sensitive find:     NO
  134.  B     Backward one page
  135.  F     Find text or hex byte
  136.  R     Repeat find
  137.  X     Exit viewing  //also ESC, ^X, Q//
  138.  
  139.   File: B10:QL     .DOC
  140.   Size: 2419 bytes (3k)
  141. Approx: 53 lines, 396 words.
  142.  
  143. Command, or <ret> to resume Viewing:
  144.  
  145.  
  146. Usage:  Toggle Commands
  147.  
  148. 'Truncation'       When ON, lines longer than 80 chars are chopped off (a char 
  149.                    in  the last column  identifies these lines).   This is the 
  150.                    recommended mode,  as QL  does not  now support  left-right
  151.                    scrolling.   If lines  are allowed to wrap,  the pagination
  152.                    will not work correctly - lines may scroll off your screen.
  153.  
  154. 'Case Sensitive'   This  only involves the  'Find' function.  When  'OFF',  no 
  155.                    distinction is made between upper and lower case; otherwise
  156.                    the match must be exact.
  157.  
  158. 'Display Mode'     'ASCII' is the normal mode  for viewing  a text file.   The 
  159.                    'HEX' mode display  emulates a typical debugger type memory
  160.                    dump,  with 16 hex bytes/line and their ASCII  equivalents,
  161.                    if any, on the right part of the screen.  QL will initially
  162.                    guess  at the proper setting  based on  the content  of the 
  163.                    first few  bytes,  but it  may be 'faked out.'   If  a file 
  164.                    comes up wrong, type 'A' to alternate the display mode.
  165. :3
  166.  
  167.  
  168. QL Notes:
  169.  
  170.    a. QL will handle 50k for normal text files,  50k for squeezed  files after
  171.       unsqueezing, or 28k for crunched files after uncrunching.
  172.     
  173.    b. To search for hex bytes  in HEX mode,  precede them with '$'.  '$1176AC' 
  174.       thus searches for the series of bytes 11h, 76h, 0ACh.
  175.