home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / dos / prg / pas / swag / newfor.300 < prev    next >
Text File  |  1994-11-26  |  4KB  |  89 lines
  1. ┌──────────────────────────────────────────────────────────────────────────┐
  2. │                        SOURCEWARE ARCHIVAL GROUP                         │
  3. │                  NEW ADDITIONS TO READER.EXE VERSION 3.0                 │
  4. └──────────────────────────────────────────────────────────────────────────┘
  5.  
  6. Please read the READER.DOC file for  a complete explanation of the features
  7. of this version of the READER.
  8.  
  9. There have been MANY changes made to  the the entire SWAG product since the
  10. last release.  The SWG files have a completely new file structure :
  11.  
  12. TYPE
  13.   SwagHeader =
  14.     RECORD
  15.       HeadSize : BYTE;                  {size of header}
  16.       HeadChk  : BYTE;                  {checksum for header}
  17.       HeadID   : ARRAY [1..5] OF CHAR;  {compression type tag}
  18.       NewSize  : LONGINT;               {compressed size}
  19.       OrigSize : LONGINT;               {original size}
  20.       Time     : WORD;                  {packed time}
  21.       Date     : WORD;                  {packed date}
  22.       Attr     : WORD;                  {file attributes and flags}
  23.       BufCRC   : LONGINT;               {32-CRC of the Buffer }
  24.       Swag     : STRING[12];            {stored SWAG filename}
  25.       Subject  : STRING[40];            {snipet subject}
  26.       Contrib  : STRING[35];            {contributor}
  27.       Keys     : STRING[70];            {search keys, comma deliminated}
  28.       FName    : PathStr;               {filename (variable length)}
  29.       CRC      : WORD;                  {16-bit CRC (immediately follows FName)}
  30.     END;
  31.  
  32. There are several advantages to this approach.
  33.  
  34. 1. It allows the SWAG material to  be stored as an archive of snipets. Each
  35. file is almost as small as the current compressed .SWG files but the entire
  36. file does NOT have to uncompressed for viewing.
  37.  
  38. 2.  The headers  are stored  dynamically, so  returning them  is VERY, VERY
  39. fast.
  40.  
  41. 3. The deletion of  items is much quicker as the entire  file does not have
  42. to be rebuilt each time.
  43.  
  44. 4. The GREP function now works at  "light" speed as it should. I've changed
  45. the default for GREP to search just  the headers. If a user wants to search
  46. the entire body  of the text, then they will  enter the tilde (~) character
  47. for this. This  does slow the search down, but  it's still much faster than
  48. the present  GREP. Also added the  KEYS field which expands  the header and
  49. gives greater flexibility on searches.
  50.  
  51. Essentially, version 3.0  data is based on the LHARC  file format with some
  52. extra information. This allows for compression of each snipet as a seperate
  53. item, and provides for a VERY FAST return of each header.
  54.  
  55. I've written  a collection of programs  to ADD, DELETE and  VIEW the snipet
  56. archives. This  will permit users  to create their  own SWAG collection  if
  57. they so choose.
  58.  
  59. Major Changes  to READER.EXE for version  3.0, released on 11/26/94  are as
  60. follows :
  61.  
  62. 1. Added EDIT HEADER feature using CTRL[H] to allow editing of CONTRIBUTOR,
  63. SUBJECT  and KEYS.  KEYS are  used  in  the GREP  function, making  it much
  64. faster.
  65.  
  66. 2. Added code to  permit the use of the EQUAL(=) key  and TAB key to return
  67. the NEXT item in the snipet window.  Also added the BACKSPACE key to return
  68. the prior snipet.
  69.  
  70. 3. The  "KILL" feature now  deletes the snipet  and internally reorganizing
  71. the file in place.  Also, if you "KILL" all of the  snipets in a .SWG file,
  72. the file will be deleted.
  73.  
  74. 4. Improved and  speeded up the BOOLEAN AND/OR logic  in the GREP function.
  75. See READER.DOC for full instructions on how this works.
  76.  
  77. 5.  Changed the  logic used  by the  GREP function  to search  for KEYS. In
  78. previous verisons, the READER would  search the ENTIRE snipet including the
  79. buffer unless you added a TILDE (~)  in front of the search string. Now, it
  80. search the HEADER by default, and you  can make it search the entire snipet
  81. by using the TILDE (~).
  82.  
  83. 6.  Eliminated the  need for  SWAGCOMP.EXE to  compress .SWG files.
  84.  
  85. WARNING !!!!!  DO NOT USE  THE SWAGCOMP.EXE program  on the new  .SWG files
  86. after  conversion. This  program is  NO LONGER  distributed, and  should be
  87. deleted. The new READER.EXE version 3.0 WILL NOT HANDLE files compressed in
  88. the fashion used by previous versions.
  89.