CVSFilter 1.0 Readme
====================

Copyright (c) 2003 dato Software

Author:
=======
  Jerinic Stasa: stasa.jerinic@dato.at

Idea:
=====
  Bernd Maierhofer: bernd.maierhofer@dato.at

Description:
============

CVSFilter is an application, which you can use to filtering comments of stored files in CVS. Its a command line tool, which can be controlled by batch files or makefiles. All needed parameters (e.g. Author, Inputs, Outputs,...), to filter comments from CVS, can be defined either as command line parameters, an ini-file or in the registry. 

Advantages of CVSFilter: That the comments can be extracted for exactly one or all user/s that has/have stored the files into CVS. Further it is possible to extract the comments for a defined period of time. 
The output format for CVSFilter shows the comments in a structured way.

For example: 
CVSFilter.exe /person=MAB /author=JES /input=C:\Projects\cvslog.txt /output=C:\Projects\cvslog_out.txt /date=.gt18.09.2003


  PARAMETERS:
  ===========

  Parameters must be declared:
    /PERSON     : This switch includes the persons name which has started the CVSFilter tool. This name 
                  will be written in the output file.
    /INPUT      : This switch sets the path name of the file, from which you will filtering.
    /OUTPUT     : This switch sets the path name of the file, in which the filtering results will be stored.
  Other possible parameters:
    /AUTHOR     : This switch contains the name of the author. The CVSFilter tool will fillter comments for this autor.
    /DATE       : This switch manages the working date. 
                  You can set here a specific date. Isnt a date set, then it will be set the todays date automatically.
                  Specification of this switch can also be relative. For example: /date=.eq-7
                  Possible definitions of date:
                    .gt greater than.    All comments with date after are extract
                    .ge greater equal.   All comments with date after or equal are extract
                    .eq equal.           All comments for this date are extract
                    .le less equal.      All comments with date before or equal are extract
                    .lt less than.       All comments with date before are extract
    /?          : This switch lists the overview of all registered switches.
                  Immediately afterwards the application terminates.
    /RegOff     : This switch starts the readout from the registry in or out. Default value is '-'.
    /IniOff     : This switch starts the readout from the ini file in or out. Default value is '-'.
    /CmdOff     : This switch starts the readout from the command line in or out. Default value is '-'.
    /RegPath    : This switch sets the registry path. 
                  Default value is '\Software\DATO\"Applicationname"\'.
    /IniPath    : This switch sets the path of the ini file. Default value is "Application path".
    /IniFile    : This switch sets the name of the ini file. Default value is '"Application name".ini'.
    /WriteIni   : This switch activates the writing of the registered switches into the ini file.
                  Immediately afterwards the application terminates.
    /WriteReg   : This switch activates the writing of the registered switches into the registry.
                  Immediately afterwards the application terminates.
    /SHOWHIDDEN : This switch shows or hides the switches, which are registered with the special register method.
                  Default value is 'off'.


  Example for ini file (CVSFilter.ini is in the same path like the application):
  =============================================================================

    [PARAMETERS]
    PERSON=MAB
    INPUT=C:\Projects\cvslog.txt
    OUTPUT=C:\Projects\cvslog_out.txt
    DATE=.gt18.09.2003
    AUTHOR=JES

      
  OUTPUT File:
  ============
  User: MAB
  Datum: 18.09.2003

  dato/
      Projekte6/
          Bibliothek/
              PropertyReminder/
                  uDeveloperExpressPropHandler.pas
                      Memory Leak removed. fGridList Object destroyed.
          CVSFilter/
              CVSFilter.dpr
                  uCVSFilterEnglishConstants added
              uCVSFilterConstants.pas
                  created
              uCVSFilterEnglishConstants.pas
                  created
          Outlook-RuleAssistant/
              cRuleEditor.pas
                  By initializing added the minimal width and height of window. The text
                  checked for occurrence of [ and ].
              cTimer.pas
                  Added call from CenterForm method
              fRuleEditor.dfm
                  no message
              fRuleEditor.pas
                  no message
              fTimer.dfm
                  no message


  CVSNotification.cmd:
  ====================
  This file can be used if you want to extract the information what has changed in the CVS, for example.
  You can add this file to accessories->system programs->planed tasks and by using a E-Mail client, 
  or also by using our application SendMail, you get every morning an e-mail with the changes in the CVS.


Contact:
========

  For further ideas or if you have any problems with CVSFilter please write an e-mail to: stasa.jerinic@dato.at.
  Please visit our homepage: www.dato.at
