README.TXT: List of files and installation instructions       25-Dec-93

WINSINCE.EXE Version 4.5     "File Management Automation"

Copyright 1993 Rob Hueniken
68 Fox Mill Crescent, London, Ontario,       
Canada, N6J 2B4, 
1-519-471-0333  10am-7pm EST
Compuserve 70162,1521
Internet rob.hueniken@onlinesys.com

Registration: $25

WinSince: A file management automation tool

Overview
========

WinSince is a unique and powerful file manager that can help you find and 
work with your files. Unlike most file managers, WinSince is list oriented: 
you search for files you are interested in and build a list of those files. 
Once you have a file list, you can perform any action you need on the list, 
including DOS commands, DOS programs and Windows programs.

For example, you might want to find all *.BAK files on your hard drive and 
delete them. Other file managers require you to set up such a file search 
each time. Not WinSince! With WinSince you set up an icon just once that 
will automatically perform that file task any time you need it. You can run 
your action in a Window or minimized and out of the way.

By showing the files you have selected as a list, WinSince makes file 
management a lot like using a grocery list. You can sort the list of files 
in lots of ways, such as by file name, extension, date and size. You can 
add files to the list by searching for a different type of file, or 
searching in a different directory. You can also remove files from the list, 
and select only certain files to work on.

One of the strengths of WinSince is its ability to search for files 
created since a particular date. In fact, that is how it got its name. 
As with many file managers, you can tell WinSince the date of the files 
you want to find. But WinSince also allows relative date searching, such 
as finding files created some amount of time before now.

For example, you might want to find all report files created in the last 
8 hours and copy them to another directory for safe keeping. With WinSince 
this is easy. You can also tell it to only look for files that have not yet 
been backed up, which is a good safety net for those times between backups 
when you aren't exactly sure which files have been worked on.

If you want, WinSince will also create a text file that logs all the files 
it finds and the actions it takes. This makes WinSince really handy for 
keeping track of which files have changed. You can have it add new 
information to an existing log file or even create a new one each time you 
run WinSince. This feature is especially useful for people using networks 
or working together on files, since it provides a kind of audit trail.

WinSince also has a built in timer which you can use to perform repetitive 
or time dependent activities. Using the timer you could set up your own 
timed backups for programs that don't have that feature. For example, you 
could have a copy of WinSince whose job it is every hour to search for your 
type of spreadsheet file, check if any have changed, and copy them to another 
directory. You can have as many copies of WinSince running as you have tasks 
for it to do. WinSince can also search files for selected text.

WinSince has been described as being more than a utility, but rather being a 
utility construction set. Its customizable DOS and Windows Actions and 
definable File Type buttons make it very flexible, while its list approach 
makes it easy to use. Give it a try. I think you'll find, like me, that you 
have lots of file-related tasks that can be easily automated, to save you 
time and effort.

The feature history found below has more details on WinSince capabilities.

Full help is available within the program. A text version of the help 
is available as WinSince.wri, which you can print using the Windows 
WRITE.EXE.

WinSince runs unders Windows 3.1, and under OS/2 2.1 in WIN-OS/2 Full
Screen in addition to Seamlessly on the OS/2 Desktop.

Some Review Comments
====================

  David Busch of Windows User magazine calls it "More than a utility,
  it's a utility construction set."

  Preston Gralla of PC Computing magazine calls it an "Ultra powerful
  file automation tool."

Installation
============

*** To install, run the SETUP.EXE program. 

    This will prompt you for the directory to put WINSINCE into, and 
    copy the files to the appropriate directories.

WinSince requires VBRUN300.DLL. This file is available on all bulletin
boards and on one of the companion disks for book sales. It is most 
commonly placed in your C:\WINDOWS\SYSTEM directory.

WinSince supports VGA and higher resolutions.

The version of Since.dll used by version 4.4 is dated 08-11-93 04:39 pm 
and is 31771 bytes in size. 

If you get an error when starting WinSince that says "The file
c:\directory\SS3D2.VBX is out of date" or a similar error message for 
another .VBX file, then you need to delete that file: WinSince installs 
the latest versions in your \Windows\System. You may need to exit and 
re-enter Windows to be able to delete the file, since Windows may say
that it is using it. If you get a General Protection Fault that shows an 
error in KRNL386.EXE then you probably have an old SS3D2.VBX file in your 
\Windows directory that should be deleted.

If the SETUP program does not install WinSince, you can run WinSince out 
of a directory containing all of the distribution files. Alternatively, 
the "Files needed" section below can show you where each WinSince file 
is normally copied to. 

Norton Desktop Installation Notice
==================================

A small problem in the MicroSoft Setup Kit with NDW 2.x can result in a 
DDE message following a successful installation: "An application using 
DDE did not respond to the system's exit command". If you see this message, 
click on the CLOSE button. This problem does not affect the installation 
or the running of WinSince. My apologies for this inconvenience.

Documentation
=============

In addition to this README file, there is full documentation both on-line 
and in printable format. Use the Windows WRITE.EXE to open and print 
WINSINCE.WRI. It is currently about 35 pages long, and is installed in 
your WinSince directory, which is usually C:\WINSINCE\


To Register (with free upgrades)
================================

On CompuServe ($25):
--------------------

For quick registration on CompuServe, enter GO SWREG .
Choose menu item "2  Register shareware", then Search by "1  Registration 
ID". WinSince's registration number is 1619.
Alternatively, you can Search by "2  Title" and search for WinSince.

After agreeing to register, your registration code will be sent by e-mail 
or given over the phone, usually within two days. This registration code 
can be entered into the Help | Enter Registration Code menu item for any 
version of WinSince from 4.2 or later.

Credit Card Orders ($27, including shipping):
---------------------------------------------

You can order with MasterCard, Visa, Amex, or Discover from Public 
(software) Library (PsL) by calling 800-2424-PsL or 713-524-6394 or 
by FAX to 713-524-6398 or by CIS Email to 71355,470. You can also mail 
credit card orders to PsL at P.O.Box 35705, Houston, TX 77235-5705. 

Ask for PsL product number 11055 (WinSince).

** These PsL numbers are for orders only **

Any questions about the status of the shipment of the order, product 
details, registration options, refunds, technical support, volume 
discounts, dealer pricing, site licenses, etc, should be directed 
to Rob Hueniken at 1-519-471-0333 (10am-7pm EST), or via CompuServe 
at 70162,1521.

To insure that you get the latest version, PsL will notify Rob 
Hueniken the day of your order. Rob will ship the product directly 
to you.

Orders by Check or Money Order ($27, including shipping):
---------------------------------------------------------

For orders by mail, send a cheque or money order for $27, 
made out to:  Rob Hueniken

     68 Fox Mill Crescent
     London, Ontario       
     Canada, N6J 2B4 

Questions concerning registration, site licensing, and support for registered owners:
-------------------------------------------------------------------------------------

     1-519-471-0333  10am-7pm EST
     or Compuserve 70162,1521
     or Internet rob.hueniken@onlinesys.com


Upgrading to a new version
==========================

Registered owners can get FREE upgrades of WinSince by downloading
a newer version of WINSNC.ZIP from CompuServe or other bulletin boards.
On CompuServe, you can enter GO SWREG to determine which forum WinSince
can be found on. The newest version is currently kept on the CIS:WINSHARE
and PBSAPPS forums (ie. GO CIS:WINSHARE). You do not have to register
WinSince again - just download the newest version of WINSNC.ZIP.

Keep your WinSince registration code on hand for possible later use. 
Usually, the Setup program will transfer your registration for you to the 
new version.

Registered owners can get a disk version of the latest WinSince
upgrade by mail by sending a cheque or money order for $2,
made out to: Rob Hueniken

     68 Fox Mill Crescent
     London, Ontario       
     Canada, N6J 2B4 


New features in version 4.5
===========================

The date to find files since can now be set using the Calendar button.

WinSince can now search files for a text string. The new Search menu 
 allows you to select the text to search for, if the search is to be 
 case sensitive, as well as to ignore the warning when a file is locked 
 and unavailable for searching. The text search feature works in 
 conjunction with the other file search parameters, such as creation 
 date and file type. The Search History shows how many files were found 
 and searched, as well as showing which files were locked. The option 
 to ignore locked file warnings is saved to the Since.ini file.

New /find command line switch to initiate a text search.
New /text=find this} command line switch to show what text to search for.
New /nofindwarn switch to ignore locked file errors during text searching.
New /case switch to perform a case sensitive text search.

Edit menu extended. Now use Edit | Edit Actions to define the Actions
 instead of just clicking on the Edit menu header.
Edit menu can now copy selected paths or entire entries from the 
 File List to the Windows Clipboard.
Directory Anchor feature allows you to select a directory to return to
 by clicking on the double-arrow Return button.
The Save Date and Reset Date buttons now also use the Anchor and Return
 button styles.
The date setting VCR buttons have been relabelled: "<" means back a day, 
 and "<<" means back a week.
The File | Command Line Values menu item now shows the directory where 
 WinSince is running from.

Three new custom control files from Crescent: Qpro200.dll, Cscmd.vbx
 and Cscalndr.vbx.
Readme.txt and WinSince.wri reformatted for easier viewing in VGA.

New features in version 4.4
===========================

Now able to combine multiple Actions into a single button, to allow a 
 single mouse click to perform a series of Actions on the selected files.
Edit screen now has a "Preview" button to show how the Action will look
 when it is run.
Can now add files to the File List, rather than clearing it with each 
 file search.
New /Add command line qualifier, for adding files to the File List.
New %Attrib function to set file attributes such as Archive and 
 Read-only.
New /NoAttribWarn command line qualifier for ignoring locked file 
 attribute messages.
Registration available through credit card orders (800-242-4775 or 
 713-524-6394).

Changes to Since.ini Action Definitions (check your use of these Action 
 numbers):

Action #6 has changed to "Attrib +A" from "Have File".
Action #10 has changed to "Action 2+6" from "Copy From".

New features in version 4.3
===========================

Flickering of File List removed when selecting all files or deleting files.
Registration available through GO SWREG ( Registration ID# 1619 ).

New feature in version 4.2
==========================

Free upgrades for registered owners.

New feature in version 4.1
==========================

Can now cancel a file copy or delete activity after the current file is 
 done.

New features in version 4.0
===========================

Timer function allows WinSince to be activated at regular intervals, to 
 search for files, and to perform an Action on the files found.
New /timer command line switch to set the time between timer events.
New /timercount command line switch to set number of times the timer 
 will run.
New /nosearch command line switch to not search for files when WinSince 
 starts.
New Options to only copy files that are Newer or Different in Size or 
 Date, as well as command line switches /IfDifferent and /IfNewer.
New Option to ignore non-fatal file copy errors, such as a locked or 
 open file, as well as command line switch /NoCopyWarn.

New features in version 3.3
===========================

File List can now be sorted by File Name, Path, Extension, Date, Size or 
 File Attributes. This makes it very easy to locate a particular file in 
 the list, or to determine the largest file in a directory area.
Escape key is equivalent to clicking on Cancel in Action Warning.

New features in version 3.2
===========================

Copy command in the File menu for single file copies. Defaults to 
 selected file.
New option to not warn when clearing or removing File List entries.
Logging of directory creation and removal events.

New features in version 3.1
===========================

Drag and Drop a file from the directory list directly onto an Action, 
 without needing to add it to the File List first. Very handy for 
 taking quick action on a single file.
Drag and Drop a file from the directory list into the File List, for 
 one shot, spot additions or for creating a diverse file list.
Drag and Drop the file creation date of a particular file, to find 
 files created since that date.
Remove selected files from the File List, or clear the list completely.

New features in version 3.0
===========================

New %Copy and %Del commands for copying and deleting files without DOS.
New %CurDrv and %CurDir drive and directory tokens for copying files 
 to and from the current directory. Get new copies of selected files 
 from other directories.
Create and remove subdirectories.
Improved logging of the actions taken on selected files.
New /All startup qualifier for auto-selecting all files after a file 
 search.
New /NoWarn qualifier to suppress Action warnings. 

New features in version 2.2
===========================

Search date can now include the time, for even more specific file 
 searches.
Relative date search can specify the amount of time prior to NOW, 
 such as -0:08:00:00 meaning 8 hours before now. This is really 
 powerful for searching, automating file management and tracking 
 changes. See the /since description.
Single directory file searching is now faster.
New %A substitution token represents the entire path and file name, 
 such as C:\WINDOWS\WIN.COM. Version 2.1 used %D:\%P\%F (which still 
 works).

New features in version 2.1
===========================

Now handles multiple file types during the search, such as *.txt;*.exe 
 (separate with semicolon).
Can now have multiple instances of WinSince running at the same time.
Shows the total size of selected files in the new List menu.
The log file name can be automatically generated from the date to 
 create unique log files.

New features in version 2.0
===========================

WinSince is now able to run in batch with command line startup 
instructions. This will allow you to create specialized WinSince 
instances that automate your file management. Once you set up your 
WinSince Actions, you can create Program Manager WinSince icons to 
define each of your file tasks.

There are now 27 start up commands:

 /dir=          Directory to start the program search.
 /filetype=     Type of files to search for.
 /subdir        Search down the subdirectory tree from the current 
                 directory.
 /drives=       Search the entire selected drives for the file type.
 /cleardate     Ignore the creation date when finding files.
 /since=        Creation date of files to find since; can be absolute 
		 or relative to Now. Can include time as well as date: 
                 /since=mm-dd-yyyy:hh:mm:ss
 /archive       Search for files with the Archive file attribute set.
 /search        Search for files when WinSince starts.
 /nosearch	Do not search for files when WinSince starts.
 /all           Select all files after each file search.
 /action=       Action number (1 to 10) to perform on the files found.
 /nowarn        Suppress warning before Action is taken on selected files.
 /exit          Exit WinSince once the initial file search and action 
                 are done ("batch mode").
 /min           Run minimized. This is handy for running WinSince as a 
                 batch job.

 /timer=	Set the amount of time between timer events
 /timercount=	Set the number of times the timer is to run; 0 for 
                 continuous

 /ifdifferent	Copy file only if different in size or date than in 
                 target directory.
 /ifnewer	Copy file only if source file is newer than that in 
                 target directory.

 /nocopywarn    Ignore errors encountered when copying, such as locked 
                 files.
 /noattribwarn  Ignore errors when setting file attributes on locked or 
                 open files

 /add           Add files to the File List, rather than clearing the list

 /log=          Name of log file to write files found and actions 
                 performed by WinSince.
 /append        Append to an existing log file, as specified in /log 
                 qualifier.

                My personal preference for interactive file management 
                is to always specify /log on the command line but without 
                the /append. It barely slows things down and is often very 
                handy for checking details about what files were found and 
                what actions were taken.

 /find          The next file search will include a text search   (* NEW *)
 /text=2 words} Text to find. Note the ending }                   (* NEW *)
 /nofindwarn    Ignore errors when searching locked or open files (* NEW *)
 /case          The text search will be case sensitive            (* NEW *)

 To set up WinSince to use the command line switches, use the File | 
 Properties menu item in the Program Manager to modify the WinSince 
 command line. Ie. instead of running C:\WINSINCE\WINSINCE.EXE you 
 might change it to show: 
 C:\WINSINCE\WINSINCE.EXE /DIR=C:\ /FILETYPE=*.BAT /SEARCH 

 The command line switches can be combined to do a variety of tasks 
 that range from customizing the startup file type to automatically 
 copying files between directories.


Setting up multiple icons for WinSince on the Windows desktop
=============================================================

As you come up with your own list of file tasks that you would like to
automate, you can add copies of the WinSince icon within its Windows 
group. To do this, hold down the Ctrl key while you click and drag the 
WinSince icon to a free spot within its group. Modify its File Properties 
with the command line qualifiers, and change its title to show the meaning 
of the task it does.

 Example  : You want to review or edit TXT files changed in the last 
            hour, and create a log file showing the list of the files found:

             WINSINCE.EXE /DIR=C:\MYWORK /FILETYPE=*.TXT /ACTION=3 /MIN /EXIT
                          /SEARCH /LOG=C:\MYWORK\CHECK.LOG /SINCE=-0:01:00:00

        This tells WinSince to look only in the C:\MYWORK directory for 
        files with the extension TXT that have been created since 
        yesterday. The /SINCE=-0:01:00:00 tells WinSince that you are using 
        a relative date of one hour in the past. On each of these TXT files, 
        WinSince will run Action number 3 ("Edit"), which in the 
        distribution version of WinSince runs the Windows NOTEPAD editor 
        on the selected file. (You may customize all Actions to do 
        whatever you want if you don't like the defaults). Since /MIN is 
        specified, each Notepad session will appear as an icon, ready 
        for you to work on when ready. Since /EXIT is specified, WinSince 
        itself will never appear to you: it will just start up the Notepad 
        sessions and then exit. The list of files found, along with their 
        dates and sizes, will be put into C:\MYWORK\CHECK.LOG, as 
        requested in the /LOG command. This is an Ascii file suitable for 
        later editing or printing.


Features introduced in version 1.2
==================================

Quick Start tutorial help section.
Point and click file button assignment; it's fun and easy!
Double click on file name to run associated program.
Options for getting files when starting, and warning before running 
 double clicked files.
The action definition can be cleared by double clicking.
Two-size edit screen (summary and editing details).
Screen layout modified slightly to allow for use under VGA.
Saves last position of program for next session.


Files needed
============

There are 13 files required for running WinSince.exe:

1)  WinSince.exe
2)  WinSince.hlp  (must be on the path, or in the working directory)
3)  Since.dll     (usually in the \Windows\System subdirectory,
                   must be on the path, or in the working directory)
4)  Since.ini     (usually in the Windows subdirectory, on a network 
                   this can be in the same directory as the end user's 
                   version of win.ini)
5)  Sincerun.bat  (must be on the path, or in the working directory,
                   is put into the \Windows subdirectory)
6)  Sincecls.pif  (must be on the path, or in the working directory,
                   is put into the \Windows subdirectory)
7)  SS3D2.vbx     (usually in the \Windows\System subdirectory,
                   must be on the path, or in the working directory; 
                   this is the Sheridan 3D Widget Runtime)
8)  Vbrun300.dll  (usually in the \Windows\System subdirectory,
                   must be on the path, or in the working directory;
                   part of Visual Basic 3.0 runtime)
9)  Msafinx.dll   (usually in the \Windows\System subdirectory,
                   must be on the path, or in the working directory)
10) Spin.vbx 	  (usually in the \Windows\System subdirectory,
		   must be on the path, or in the working directory)
11) Cscmd.vbx 	  (usually in the \Windows\System subdirectory,  (* NEW *)
		   must be on the path, or in the working directory)
12) Cscalndr.vbx  (usually in the \Windows\System subdirectory,  (* NEW *)
		   must be on the path, or in the working directory)
13) Qpro200.dll   (usually in the \Windows\System subdirectory,  (* NEW *)
		   must be on the path, or in the working directory;
		   this is the Crescent QuickPak dynamic link library)

There are two additional files:

14) WinSince.wri  (Windows Write version of the WinSince.hlp)
15) Readme.txt    (this file)


Distribution disk setup versus Bulletin board setup
===================================================

The SETUP.EXE program uses SETUP.LST to check which special files 
are needed for Setup. The supplied SETUP.LST is either a copy of 
SETUP.BBS (2 files, no VBRUN300.DLL listed) or SETUP.DSK (3 files, 
including VBRUN300.DLL). The version of SETUP.LST needed for a 
bulletin board or for computers that already have VBRUN300.DLL is
in SETUP.BBS. WinSince is already on Compuserve as WINSNC.ZIP, 
in the WINSHARE File Utilities area.

