Index of /tcl/ftparchive/sorted/apps/stockwatcher/0.5

      Name                   Last modified     Size  Description

[DIR] Parent Directory 06-Sep-00 09:05 - [   ] README 04-Jun-00 07:55 3k [   ] README.tclticker 04-Jun-00 07:28 8k [CMP] stockwatcher-0.5.tar.gz05-Jun-00 21:30 20k

Stock Watcher README

© Copyright 2000 Laurent Duperval <lduperval@sprint.ca>

Stock Watcher is a simple portfolio/stock watcher. It includes intraday
graphs. Stock Watcher is heavily based on Tom Poindexter's TclTicker program.
Please see the README.tclticker file for more information about TclTicker.

REQUIREMENTS:

- Tcl/Tk 8.3.1. It may work with 8.3.0 but is untested. 
- BLT 2.4. The latest release can be found on http://www.tcltk.com/blt/.
- BWidget 1.3. It may work with earlier release but that is untested. BWidget
  1.3 can only be found in the Tcl CVS Repository. For information, please
  visit http://dev.scriptics.com/software/tcltk/netcvs.html.
  
INSTALLATION:

Make sure all the software mentioned in the REQUIREMENTS section is installed
and works properly for your setup. Then, unpack the archive. The stockwatcher
directory contains all the files needed to run the program.

Windows users will need to change the name of the stockwatcher file to add a
'.tcl' extension. This will enable you to start the program by double-clicking
on it.

Mac users should tell me if it works for them or not. If it doesn't and you
manage to get it working, please provide me with the patches and I'll include
them in my development tree. The same goes for BeOS users and MVS users and
...

USING STOCK WATCHER:

The ticker window at the top of the display behaves exactly like the original
tclticker program. For information on using it, please read the
README.tclticker file. In a nutshell, where it says "Click here", just click
there. It's pretty obvious after that.

The bottom of the display is made up of a notebook. Each tab of the notebook
represents one ticker symbol. Clicking on that tab will show you all
transactions that have been entered for that symbol. The Summary tab contains
the summary of all transactions for each of the symbols listed. Basically, the
Summary page tells you how much money you were to make or lose if you sold all
of your shares immediately. The information is contained in six columns:

Symbol:         The ticker symbol
Quantity:       The number of shares held for that symbol
Purchase cost:  The total cost of buying the shares for that symbol
Current value:  Total value of all the shares held for that symbol
Delta:          Difference between the amount of money paid for all the shares
                and the current value of that symbol.
Daily Delta:    Total daily gain or loss on that symbol.
Graph Button:   Pressing this button will display an intraday graph for a
                symbol.

The information on each of the tabs for the symbols are the same, except that
the data shown is for one transaction. In addition, there are two buttons,
Edit and Delete, which allow you to edit a given transaction or to remove a
transaction from the list of transactions for a given symbol. Note that the
Summary page may not immediately reflect changes made with the Edit or the
Delete button. The changes will appear the next time the symbol appears in the
ticker window.

To add new transactions, click on the "New Transaction" button or type <Ctrl-n> at
the keyboard. 

NOTES:

Program data is saved in the $HOME/.stockwatcher directory. Information for
the ticker is saved in the .tclticker file while information abuot the
portfolio is saved in the portfolio file.

ACKNOWLEDGEMENTS:

The entire quote mechanism comes from Tom Poindexter's TclTicker. Without it,
this program wouldn't exist:
http://www.nyx.net/~tpoindex/tcl.html#Tclticker

CHANGES:

0.5 Jun  5, 2000 - First public release