
 Project Log (c) 1995 Nocturnal Creations


 What is Projlog:
 ----------------

   Projlog is a command line utility designed with programmers in
   mind to track the amount of time you spend working on a project,
   and the size changes of your source code.


 Command line help:
 ------------------

   Just type Projlog.


 How do I use Projlog:
 ---------------------

    1. create a log

      C:\>projlog create myproj

      Projlog will inform you weather the creation was successful or
      not. If so Projlog will create myproj.pl this file contains the
      information necessary to log your project.

    2. create a bat file

      @echo off
      projlog login myproj your name
      qb myproj.bas
      projlog logout myproj your name

   Projlog will inform you each time you log in & out with a blue box
   containing statistics of the log. If Projlog encounters an error
   i.e. cant find .pl file, .pl file corrupt. it will inform you with
   a red box containing the error message or prompting you to take an
   action.

 How do I view the log:
 ----------------------

   The first time you login to your new log a file will be generated
   with the same name as your log with a .log extension. This file is
   a plain ascii file that can be viewed with your favorite text editor.
   The information in this file will be individual log entries and a
   summary line.

     1  login       your name                00:00:00  00/00/00   0
     2  logout      your name                00:00:00  00/00/00   0
        Time this session 00:00:00  Source file size change 0 bytes

 How do I view the hard statistics:
 ----------------------------------

   You can view the hard stats by using the "info" command on the
   command line.

     C:\>projlog info myproj

   You will also see the hard stats every time you login & out.

 Can I add notes to my .log file:
 --------------------------------

   Yes, You may find it helpful to add "edit myproj.log" to the end
   of your .bat file and add notes about that sessions progress ( or set
   backs ) under that session block. This will not interfere with the
   log as Projlog just appends the new entries at the end of the
   file.

 What happens if my computer locks while programming:
 ----------------------------------------------------

   If your anything like me you probably lock up your computer once a
   a while ;-) letting a pointer go astray or something.  Since you
   will never make it back to the logout line in your .bat file, you can
   do one of two things:

     1. logout on the command line after reboot.
     2. rerun your .bat file and Projlog will prompt you for an
        estimated amount of time you spent.

 How do I track the source file sizes:
 -------------------------------------

   You can track your source files total size and net change by
   creating a text file with the same name as your log with a .trk extension.
   There are three rules for these files:

     1. comments are allowed using the c++ style rem "//"
     2. all file names must end with a semicolon ";"
     3. each file name must be on its own line

      // file functions
      create.c;
      readdata.c;

      // output functions
      messages.c;
      menu.c;
      errors.c;

      * white space is o.k.

   Projlog automatically checks to see if this file is present. If it
   is Projlog will tally up all the sizes and log it in the .pl and .log
   files.

 What happens if I delete my .log file
 -------------------------------------

   Projlog will create a new one and just pick up were you left off.


 Error list:
 -----------

   1.  Not enough arguments for command.
   2.  Not a valid command.
   3.  .pl does not exist. ( login/out )
   4.  Can't open file. ( login/out )
   5.  .pl file is corrupt or is not a valid Projlog file. ( login/out )
   6.  User did not enter an estimated time. ( login/out )
   7.  Can't logout because no one has logged in yet ( login/out )
   8.  User does not want to overwrite file. ( create )
   9.  Unable to create file. ( create )
   10. .pl file does not exist ( info )
   11. Unable to open file. ( info )
   12. .pl file is corrupt or is not a valid Projlog file. ( info )

   All error numbers are returned to DOS.


 *********************** Projlog is Donation Ware **************************

  If you find Projlog useful you may contribute to the cause.

  Asking donation: $2.00 U.S. dollars via U.S. Mail.

  For your donation you will receive.

       1. Gratitude.
       2. Upgrades to Projlog.
       3. The source code to Projlog written in C. ( if desired )

  david.pastore@the-spa.com
  timtruman@aol.com

  Make check payable to:

                               David Pastore
                               P.O. Box  138
                          Springfield,  MA   01151
                             FAX (413) 543-9181
                            Voice (413) 543-3237  
                          United States of America

