home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / PSCM13.ZIP / !README.1ST next >
Encoding:
Text File  |  1992-07-31  |  6.8 KB  |  156 lines
  1. The Project Source Code Manager v1.3
  2.  
  3. Copyright (C) 1990-1992
  4.  
  5. J. Bart Henthorn
  6.  
  7. All Rights Reserved
  8.  
  9. -----------------------------------------------------------------
  10.  
  11.                     *** IMPORTANT NOTICE ***
  12.  
  13. PSCM  is  distributed  "As  Is."  This means  that  I  accept  no
  14. liability  for  any  damages, whether  direct  or  consequential,
  15. resulting  from the use of PSCM.  As a professional I have  taken
  16. the  utmost care to ensure that PSCM will, in all cases,  perform
  17. without  flaw.  I also take great pride in my work.  If you  feel
  18. that  PSCM  has  in some fashion damaged you  or  your  computer,
  19. please contact me for help immediately.
  20.  
  21. -----------------------------------------------------------------
  22.  
  23. This  file  details the contents of the  PSCM  v1.3  distribution
  24. archive and where to get started on using it.
  25.  
  26. File Contents
  27. -------------
  28. PSCM v1.3 is distributed as ShareWare.  This means that all files
  29. are  combined  into a single compressed file (usually  called  an
  30. archive)  for easy distribution to bulletin board systems and  on
  31. disk.   The  file  extension may vary depending  on  how  it  was
  32. compressed  and what utility was used, but the file  name  should
  33. always  be "PSCM13".
  34.  
  35. The following list details each file in the archive along with  a
  36. brief description of the file.
  37.  
  38. Name           Description
  39. ------------   --------------------------------------------------
  40. !README.1ST    The file you are currently reading.
  41.  
  42. CHECKIN.EXE    One of two main programs in the PSCM system.  This
  43.                program  is used to add source files to a  project
  44.                database  and  "check in" revisions of  the  files
  45.                during the development of the project.
  46.  
  47. CHECKOUT.EXE   The  other main program.  This program is used  to
  48.                retrieve  prior or current versions of the  source
  49.                files  and  to print lists of files  and  comments
  50.                stored when revisions were made.
  51.  
  52. DIFS.EXE       One  of the four support programs.  DIFS  compares
  53.                two source files and generates a "script" that  is
  54.                used  to  generate prior versions  of  the  source
  55.                files.
  56.  
  57. ISIZE.EXE      The  Project Database maintenance  utility.   PSCM
  58.                uses  a special database management system.   This
  59.                program  is used to optimize the project  database
  60.                file to increase retrieval speed.
  61.  
  62. MRGS.EXE       This  program uses the scripts created by DIFS  to
  63.                create prior versions of a source file from  later
  64.                versions.
  65.  
  66. PSCM.CFG       A beginning configuration file for use with  PSCM.
  67.                This file contains ASCII strings that are used  as
  68.                macro  replacement  values  during  the  retrieval
  69.                process.
  70.  
  71. PSCM.MAC       A  quick  reference page  describing  the  special
  72.                macros  used by PSCM.  This file is formatted  for
  73.                output  to  a  printer.  Copy this  file  to  your
  74.                printer with the command:
  75.  
  76.                     COPY PSCM.MAC PRN
  77.  
  78. PSCM.MAN       The  full documentation for PSCM v1.3.  This  file
  79.                is  formatted for output to a printer.  Copy  this
  80.                file to your printer with the command:
  81.  
  82.                     COPY PSCM.MAN PRN
  83.  
  84.                You  can  also  use formatting  programs  such  as
  85.                LJBOOK (from Vernon D. Buerg).
  86.  
  87. REGISTER.FRM   The  registration  form for PSCM  v1.3.   PSCM  is
  88.                distributed  as  ShareWare.  Please,  if  you  use
  89.                PSCM,   make   sure  you   register   your   copy.
  90.                Registrations  help ensure the future  of  quality
  91.                software distributed in this manner.
  92.  
  93. SHOWDIFS.EXE   Another  one of the PSCM support  programs.   This
  94.                program uses a script file and a later version  of
  95.                a  source file to list the difference between  the
  96.                source file and the next prior version.
  97.  
  98.  
  99. How to Start Using PSCM
  100. -----------------------
  101. The  first  thing you should do is make sure all the  PSCM  files
  102. have  been decompressed, preferably into a  temporary  directory.
  103. Compare  the files with the manifest listing above.  If  you  are
  104. missing any files please contact the source of your PSCM file set
  105. to see what help they can provide.
  106.  
  107. The manual is contained in the file PSCM.MAN.  This file has been
  108. formatted  for  output to a standard printer.  The  maximum  page
  109. length  is  limited to sixty lines so it should work  with  laser
  110. printers as well.  Simply copy the file to your printer.  If  you
  111. wish, you can also use a print formatting program.  (If you  have
  112. a laser printer I highly recommend LJBOOK from Vernon D. Buerg.)
  113.  
  114. Installation of PSCM is quite easy.  Simply copy the program  and
  115. configuration  files  to  any  directory  listed  in  your   PATH
  116. statement.   The  configuration file is a plain ASCII  text  file
  117. containing  the values used for macros by PSCM.  Any plain  ASCII
  118. (i.e.  non-word  processor)  editor can be  used  to  modify  the
  119. configuration  file.  If you have MS-DOS v5.00 then the new  EDIT
  120. command will work just fine.
  121.  
  122. You may want to print out the PSCM.MAC quick reference sheet too.
  123. This is a brief single page reference to the macros supported  by
  124. PSCM.   It  can be especially handy to have around when  you  are
  125. editing  your  source files.  To print the file just copy  it  to
  126. your printer.  I have my copy stuck on the wall behind my desk.
  127.  
  128.  
  129. Please, Register Your Copy
  130. --------------------------
  131. PSCM  is  a professional quality programmer's tool.  In  the  two
  132. years I have been using it, it has saved me well over 20 hours of
  133. lost time recovering and reconstructing source files.  Even at  a
  134. conservative  $20  per hour that's at least $400  that  PSCM  has
  135. saved  me.   The registration fee for PSCM is $25.   If  it  even
  136. saves you two hours then it will have paid for itself.
  137.  
  138. Registration  has  other  benefits too.  Of  course  there's  the
  139. ever-popular   line  about  it  helping  ensure  the  future   of
  140. ShareWare,  etc.   This is very true.  But the major  reason  you
  141. should  register  your copy of PSCM is because you  also  get  to
  142. contribute  ideas  for  the enhancement of PSCM.   If  there's  a
  143. little  feature you would like to see, and you send it to  me,  I
  144. can  guarantee that I will pay a whole lot more attention if  you
  145. have  registered your copy.  Granted, I accept all good ideas  no
  146. matter  who from, but your chances are better if you've paid  for
  147. the software.
  148.  
  149.  
  150. How to Contact the Author
  151. -------------------------
  152. If  you have questions, ideas, or suggestions about PSCM you  can
  153. always contact me by fax at (303) 341-7336.  I generally  respond
  154. in less than 24 hours.  I do not maintain a constant logon at any
  155. BBS or online service, so fax is the only way to go.
  156.