home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / MADTRB08.ZIP / LU.DOC < prev    next >
Encoding:
Text File  |  1985-02-23  |  7.1 KB  |  199 lines
  1.         LU.PAS             MS-DOS VERSION 1.21           January 12, 1985
  2.  
  3.  
  4.     NAME
  5.  
  6.          lu - create and maintain a Novosielski library file.
  7.  
  8.     SYNOPSIS
  9.  
  10.          lu   - all prompts for data are done by the program
  11.  
  12.     DESCRIPTION
  13.  
  14.          Library  Utility  (Pascal)  is a program to allow  combining 
  15.          multilple files into one larger file.
  16.  
  17.          Version  1.21  replaces all prior versions of Pascal coding.  
  18.          The  major  revisions are:   
  19.                  revamping of the screen handling to use the graphics
  20.          characters in the character set.
  21.  
  22.          making the modifications to the library more interactive
  23.          through the use of automatically updated directorys
  24.          on screen at all times, filesize and entry usage...
  25.  
  26.          The use of a simple window scheme to keep prompts from
  27.          overwriting any of the screen display.
  28.  
  29.          the addition of a status line/function key setup to
  30.          allow use of the function keys to control LU.PAS
  31.  
  32.          Version 1.21 does NOT include the following LU86 4.0 
  33.          revisions: 
  34.          
  35.          The addition of CRC calculation and checking to improve
  36.          reliability,  
  37.  
  38.          The addition of member time and date stamping,
  39.          
  40.          Support  for exact file lengths of library members.
  41.  
  42.          Wildcards  may  MOT be used.
  43.          
  44.          Error reporting and  recovery have also been improved.
  45.  
  46.  
  47.           Prior  versions  of  16-bit LU and  LU86  would  re-use 
  48.           deleted directory entries when performing an add/update 
  49.           operation. LU.PAS 1.21 will not reuse deleted directory 
  50.           entries [Note 1] and requires reorganization to reclaim  
  51.           deleted  directory entries.    This was done to provide
  52.           an indication of unused space in the lbr file.
  53.              *
  54.              [Note 1]
  55.               Except that in the case where an added file has
  56.               the same name.typ as a DELETED entry,  the  DELETED 
  57.               entry is  intentionally  invalidated  by  LU.PAS to
  58.               prevent an inadvertent unerasure and duplication of
  59.               that entry name.),  
  60.  
  61.                   
  62.                   
  63.                   -1-
  64.  
  65.  
  66.  
  67.  
  68.  
  69.     LU86.EXE           MS-DOS VERSION 4.0           September 2, 1984
  70.  
  71.  
  72.     LIBRARY FORMAT
  73.  
  74.          The  entire library file and each of its members are concep-
  75.          tually organized into "sectors", each sector being 128 bytes 
  76.          long.  (From CP/M, where LU originated).  Each sector of the 
  77.          file  belongs to at most one library  member.   Each  member 
  78.          comprises  a whole number of sectors.   The last sector of a 
  79.          member  may,  however,  be  logically declared as  a  "Short 
  80.          Sector".  Although it physically contains 128 bytes, a Short 
  81.          Sector  contains one or more "pad" bytes at the end for  the 
  82.          purpose of maintaining the structure of the library file  as 
  83.          a whole.  A member may have as few as 0 sectors.
  84.  
  85.          Members  may be referred to by a name of up to 8 characters, 
  86.          and  an extension of up to 3 characters.   The naming  rules 
  87.          are identical to those for the naming of CP/M-80 disk files.  
  88.          Members  must be uniquely named;  any given  combination  of 
  89.          name and extension may identify at most one member.
  90.  
  91.          The  start and end points of each member are defined by  the  
  92.          pointers in a "directory entry" for the member.   There  are 
  93.          no embedded start or end marks separating the members.   All 
  94.          sectors between the start and end sectors of a member belong 
  95.          to that member.   The members need not appear in the library 
  96.          in the same order that their directory entries appear in the 
  97.          directory.
  98.  
  99.          The  directory  information in an LU style library  is  con-
  100.          tained in the same file as the data files,  or members.  The 
  101.          amount  of  space to be allocated to the directory  must  be 
  102.          specified by the user when a new library is created, but can 
  103.          be  changed when the file is reorganized.  The size of  each 
  104.          LU directory entry is 32 bytes, which means each four direc-
  105.          tory  entries take up one 128-byte 'sector' of  the  library 
  106.          file.   The LU directory uses one entry for control informa-
  107.          tion  itself,  so the number of  directory 'sectors'  needed 
  108.          for a library of m members is (m + 1) / 4, rounded up to the 
  109.          next whole number.
  110.  
  111.          The  user  need not be concerned with  this  discussion,  as 
  112.          directory size  is calculated by the program.  All directory 
  113.          sizes are  input and output in terms of entries,  each entry 
  114.          being a potential member file. The program adjusts directory 
  115.          size to an integral number of sectors.
  116.  
  117.     MISFEATURES (BUGS)
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                   -2-
  130.  
  131.  
  132.  
  133.  
  134.  
  135.     LU86.EXE           MS-DOS VERSION 4.0           September 2, 1984
  136.  
  137.  
  138.     ACKNOWLEDGEMENTS
  139.  
  140.          Gary  Novosielski designed the LU format and wrote the first 
  141.          programs supporting 'LBR' files.   He has continued to main-
  142.          tain and improve the LU format by distributing a file of the 
  143.          offical LU format definition.   The current version of  this 
  144.          definition is contained in LUDEF5.DOC.  Interested users are 
  145.          directed  to that file for more complete information on  the 
  146.          LU format.
  147.  
  148.          Large  portions of this document are excerpts from the  CP/M 
  149.          file  LU300.DOC,  which documents the operation of the  CP/M 
  150.          version  of LU (an implemenation much superior to  LU86,  by 
  151.          the way).  Any particulary lucid and useful sections of this 
  152.          document  probably  originated with Gary  Novosielski.   The 
  153.          Turgid Obfuscation is probably mine.
  154.  
  155.          This program had its genesis in the UNIX progam LAR.C.   LAR 
  156.          was  rendered into C that mortal compilers could  understand 
  157.          by Tom Jennings who renamed the source to LU.C.   I used  LU 
  158.          as a base and have renamed the effort to LU86.
  159.  
  160.          LU86, ver 4.0 is a 'C' program, and is compiled with version 
  161.          2.10B of the Computer Innovations C86 MS-Dos compiler.
  162.  
  163.          LU.PAS was written by Steven ????, and heavily modified
  164.          by John Plocher.
  165.  
  166.          This doccumant was unselfishly pilfered and palagerized from
  167.          the doccumentation for LU86 4.0 by the following person:
  168.  
  169.                Paul J. Homchick
  170.                Chimitt Gilman Homchick, Inc.
  171.                One Radnor Station, Suite 300
  172.                Radnor, PA 19087
  173.  
  174.             LU.PAS is written to compile with Borlands Turbo Pascal,
  175.         and run on a Victor 9000.  It will run on an IBM PC with
  176.         these changes - 
  177.         the window handling routines make 2 assumptions:
  178.         
  179.         1 : the text screen being used is located at $F000:0000
  180.             and is 2048 words (16bit) large, and
  181.             (the IBM PC is at E000:0000 or $E800:0000)
  182.         2 : The terminal driver recognizes the VT 52+ screen
  183.             control codes to move & save cursor...
  184.             These are NOT the same as ANSI (IBM PC) codes!
  185.         
  186.         In addition, there is a chance that the character graphics 
  187.         used here will not be the same as those on the Victor.
  188.  
  189.  
  190.         The changes/additions to this program and this doccument
  191.         were done by:
  192.  
  193.              John Plocher
  194.                          17403 McIntyre
  195.              Detroit, MI
  196.              48219
  197.              (313) 535-7858
  198.  
  199.