Category : Financial and Statistics
Archive   : CGZ30P.ZIP
Filename : HISTORY.DOC

Capital Gainz Revision History

Revision 1.0:
* Initial release of Capital Gainz.

Revision 1.1:
* 'Backup' is now invoked via a function key on the Main Menu
instead of being a menu option.

* Entering a key corresponding to the initial character of a
menu selection now automatically invokes the associated
function. Previously, the menu selection was only
highlighted and the Enter key had to be hit to invoke the
function.

* 'Stock Split' is now invoked via a function key on the
Security Table instead of being an option on the Activity
Menu.

* Totals on the bottom of the Security Table are now
recalculated after executing a price change operation.

* 'Open Shares' has been added to the Security Lookup Table
called for symbol validation.

* Broker/investment company name changes and broker/investment
company deletions now propagate to all securities that
reference the broker. Previously, the broker name associated
with the securities was not affected by changes or deletions
in the broker table. Deletion of an entry in the broker
table clears the broker field in associated securities.

* Fixed a problem with transaction logging that caused Capital
Gainz to abort.

Revision 1.2 (Special release - limited distribution):
* Added Money Market Fund security type.

* Changed SHARES field of OPEN/CLOSE files from allowing up to
9,999.9999 shares to allow up to 999,999.9999. There was a
bug in previous versions that allowed the user to enter more
than the field could hold. This change requires a data file
upgrade from version 1.1.

Revision 2.0:
* Includes version 1.2 changes as listed. Requires data file
upgrade from version 1.1.

* Faster building of tables - approximately 10-15% faster.

* Faster printing - approximately 10-15% faster.





* Smaller runtime requirements - approximately 10-15KB less.

* Report menu now includes portfolio and broker options.

* Install program added.

* Can now DOS shell from any menu, program only uses about
4KB.

* Added VENDOR.DOC file, which contains the program
description for vendors.

* Fractions window automatically brought up for BUY, SELL,
DISTRIBUTIONS, and PRICE CHANGE.

* Fixed bug in selling shares by ID, can now go back and
change amount to sell after entering a portion to sell
previously.

* Fixed 'value' on total screens and on reports for OPEN
shares so that commission is not subtracted.

* All menu selections - including menu fields - are
auto-select with a single key. (First letter in menu
choice.)

* Price update from security table now skips securities with
no open shares.

* Got rid of per share value on detail report for distribution
type of FEE.

* When printing summary or detail reports, active security
symbol is displayed in message.

Revision 2.1:
* Fixed problem where attempting to change entries in the SOLD
log resulted in the error "Can't Change Sell Method".

* Fixed problem where rounding error could cause the amount
calculated during a sale to be up to several cents different
from entered amount.

* Deleting a Security now updates Security Table totals.

* Fixed problem in Reports - if a report was sent to a file,
all subsequent reports had to be sent to a file as well.

* Reports now use 62 lines instead of 55.


2





* Security Summary report open totals now show correct
gain/loss when reporting over a range of dates.

* Added subtotals to Sold Shares Detail report so all shares
involved in disposition are grouped together.

* Integrated upgrade utility into installation procedure.


Revision 2.2 (8/6/91):
* Can group delete log entries by date range.

* Fixed INSTALL so you can't enter too long of a registration
number.

* Due to the addition of extra functions, some screens (such
as the Security Table) now have a More function key. This
key shows other available functions.

* INSTALL now checks if there is enough space on the
destination disk.

* Price/Date no longer required when add/change Security.

* Replaced single, latest Price in security with a price
history. You can add/change/update price history entries
from a table available from the Security Table function key.
The Price History Table flags highs and lows, and displays
distributions and average price. You can also print a Price
History report. See the user's manual for details.

* Changed CAPGNZBU.BAT to recognize either a drive letter or a
drive letter followed by a ':'.

* When print to a file, file name entered is validated instead
of being automatically translated into a valid name.

* ASP Ombudsman address changed.

* Revamped user's manual. Added details on where you can get
more information on dividend reinvestment plans. Added
chapter on how you can use Capital Gainz for analysis. Also,
screen depictions now use extended ASCII line drawing
characters.

* Changed SETTINGS to an ASCII file, SETTINGS.K01 no longer
exists (key file).

* You can now customize the screen colors through the Global

3





Settings form. Screens are divided by type (i.e., Security,
Broker, etc) and kind (i.e., Form, Table, etc). See the
user's manual for details.

* Fixed a bug where you could not change Sell Method even if
no shares were sold.

* Added 'Quit' to Main Menu, can no longer Escape to DOS.

* Date Range is now acceptable in any order - the later date
can be entered as From and the earlier date entered as To.

* Added Allocation display and report. This breaks down your
portfolio by amount per Security Type. Amounts are shown and
percentages calculated. See the user's manual for more
information.

* When doing Price Update, all securities - even those with 0

open shares - are included. This is so you can track price
history. Skip Forward and Skip Backward functions are also
available to skip over securities.

* Reports now include page numbers in the upper right hand
corner.

* When entering Buy/Sell/Distribution from Activity Menu, the
Buy/Sell/Distribution Forms include a counter of records
added in the upper right hand corner.

* When building tables - like for Open/Close/Distribution Logs
- a 'Building...' message is displayed.

* All 'Printing...', 'Building...', and Error messages are
displayed on the bottom 3 lines.

* Added Schedule B and D reports, similar to tax forms. After
accepting the desired year, the Dividend information on Part
II of Schedule B is printed, and the Capital Gains
information from Parts I, II, and III of Schedule D is
printed. See the user's manual for details.

* Added last buy/sell/distr dates to Security Lookup Table.

* Screens and reports now line up values in columns using the
decimal point.

* Menus items are numbered, and keying in the number
automatically selects the indicated item. After selecting an
item, a checkmark is placed to the left of the number.

4





* Fixed stock splits to modify per share amounts in
distributions records.

* Reports - Added lines per page to Settings - this sets the
lines per page for reports; added line draw chars to
Settings - this allows you to print dashes instead of line
drawing characters in your reports; reports no longer do
initial form feed, saving paper; can abort printing with the
ESCAPE key; added 'end-of-report' marker.

* The total return figure would be incorrect if there was a
stock split after the start of the date range, and the first
date within the range was in the closed shares log. The
price history file fixes this problem.

* Fixed a couple of inconsistencies in calculating gain/loss
percentages for reports. These inconsistencies were related
to the commissions involved.

* Overhauled the internal overlay structure, resulting in
better performance and less memory usage.

* Can now print activity detail reports from open, close,
distribution logs. Can print summary report from security
summary screen.

* Increased description length for Security Type, Distribution
Type.

* Portfolio Report can be subtotaled by Broker/Investment
Company. Also, security account numbers were added to the
report.

* Added Open Amount/Open Commission totals to Sold Shares
Detail Report and Security Summary Report for closed shares.

* Security Summary Report, and Distribution Detail Report now
include capital gain distributions per share.

* Much better 'busy' displays. All displays indicating
internal activity have been moved to the bottom of the
screen.

* Remaining open records after a double category sale now
maintain the original purchase price in the record.

* Shareware version now asks if you want to print a copy of
the registration form on exit.


5





* Can now modify the last migration date and the 'any sold'
flag for double category securities

Revision 2.2 (9/13/91):
* The default choice of 60 lines per page was not wise, as it
results in most laser printers printing blank or 'short'
pages. This was changed to 58.

* After you printed a Price History Report from the Price
History table, Capital Gainz thought it was showing the
prices for a different security. The same problem existed
for the Open Shares, Closed Shares, and Distribution Log
tables.

* The second and subsequent times you printed a report during
a session, Capital Gainz erroneously output an initial
formfeed.

* The Date Range was ignored in the Security Summary Report.

* Your could not change/delete entries in the price history
table.

Revision 2.2 (11/06/91):
* On the Security Summary report, the Grand Total Closed
Gain/Loss percentage is calculated incorrectly. The
gain/loss is divided by close amount, instead of open
amount.

* On the Closed Shares Report, subtotals are inadvertantly
printed after every two closed records with differing closed
dates.

* UPGRADE program failed on long pathnames.

Revision 2.2 (01/05/92):
* (d) Sales Price totals on Schedule D were incorrect - they
included sales commissions. The gain/loss figures were
correct, though.

* Can now print order form to a file.

Revision 2.2 (01/11/92):
* Security Summary screen - failed to pick up first/last price
when Print. Also, upon return from printing, screen had
incorrect values.

Revision 3.0 Pre-Release (12/31/91):
* Can now send reports to the screen. This eliminates the

6





Security Summary and Allocation screens, since you can view
the reports. The internal veiwer supports: go to top, go to
bottom, go to page, scroll up line/page, scroll down
line/page. If you are partial to a particular file viewer,
such as LIST, you can specify it in the User Settings screen
and it will be used for viewing reports.

* Global Settings is now called User Settings.

* Added Average Annual Return (APR) calculation to Activity
Summary Report (was Security Summary Report). Uses simple,
yearly compounding calculation.

* Added a 'performance' calculation to the Activity Summary
Report (was the Security Summary Report). This calculation
tells you how you've done with a particular security,
factoring in initial amount, purchases, distributions,
sales, and ending amount. Also calculates APR. It's
interesting to see if your dollar-cost averaging approach
beat the buy-and-hold approach indicated by Total Return.
Return is calculated by using the holdings at the start of
the request period, the purchases during the period, the
sales during the period, and the open value at the end of
the period.

* Allocation Report does not print initial blank sheet
anymore.

* Supports up to 999 portfolios. Each portfolio has associated
OPEN, CLOSE, DISTR, and LOCAL SECURITY files. Local
securities are linked to global securities. When more than
one portfolio is defined, the current portfolio name appears
on portfolio-specific screens and reports. The main
operation are divided into local and global functions. Local
activities are Buy/Sell/Distribution, Local Security Table,
and Activity Logs. Global activities are Reports, Global
Security Table, Broker/Investment Company, Portfolio Table,
and User Settings.

* Added concept of 'local' and 'global' securities. A 'global'
security encompasses a symbol, name, and price history
information. A 'local' security is similar to pre v3.0
securities, except its symbol is linked to a global
security. This reduces redundant information, plus allows
you to link multiple local securities to a single global
security. Thus, you can own shares of mutual fund XYZ in a
regular account and in an IRA account, yet keep them
separate within the same portfolio. When changing local
securities, you can change the related global security.

7





* Users manual includes a 'quick tour' section, so you don't
have to wade through everything prior to getting started.

* DoublePrint, DP.COM, is a nice little bonus for registered
users: you can print 2 pages per sheet in landscape mode on

a LaserJet IIP compatible, convert extended ASCII characters
to alternates, specify begin/end pages to print, and a few
other things. Type DP ? for a list of commands. You are
welcome to use DP for any other printing needs, free of
charge.

* Changed Y N (yes/no) options to YES NO. A little bit
prettier.

* INSTALL can automatically update the FILES= statement in
your CONFIG.SYS file. For upgrades, it extracts the
registration number from the previous installation.

* INSTALL constructs a CG.BAT startup file. This batch file
changes to the directory specified at installation, cleans
up any leftover temporary files, and executes CAPGNZ.EXE.
You can choose to have this copied to your root directory.
Since DOS checks for BAT files before EXE files of the same
name, you will still start Capital Gainz with CAPGNZ.

* There is a new batch file, CAPGNZRS.BAT, that restores files
backed up with CAPGNZBU.BAT.

* INSTALL now accepts a directory name for temporary files
created and used by Capital Gainz. If you make this a RAM
drive, printing and DOS commands are much faster.

* INSTALL now lets you install programs, documentation, and
utility program in any combination. Thus, if you want to add
the on line documentation after installation, you don't need
to reintall the programs.

* There is a new chapter in the Users Manual that describes
the INSTALL procedure.

* There is a new chapter in the Users Manual on performance
and disk space. This includes a brief discussion of using
expanded/extended memory.

* There is a new chapter in the Users Manual on running under
DOS 5.0, Windows, DESQview, etc.

* INSTALL creates a file called CAPGNZ.INF that contains
information such as the version number, registration number,

8





and temporary directory.

* User Settings now lets you specify the Form Accept/Reject
short cut keys. By default, these are CTRL-ENTER and CTRL-
ESC. You can redefine them to avoid Windows and DOS 5.0
keystroke conflicts.

* Distribution per share information is kept in the Price
History record instead of the Distribution record. Also,
stock split information is kept in the Price History record.
The Price History table includes prices, distributions per
share, and stock splits, and they are all updateable.

* You can execute and record stock splits, or just record
them. Stock splits affect all local securities linked to the
global security.

* When recording distributions, the Distribution record is
written and a distribution per share record is added to the
Price History file.

* You can specify precision for prices and number of shares
for each local security, from 2 to 4 decimal places. Now,
Capital Gainz default calculations on Buy/Sell/Distr Forms
should not need modification. Plus, on installation, Capital
Gainz scans the activity logs for each security and
determines the required precision - so you probably don't
have to change anything.

* When filling in the Buy Form or Sell Form, you can specify
any 2 of: number of shares, price, amount. Capital Gainz
will calculate the other value. For Distributions, you
specify one of: amount, per share. If you set your
security's precision values correctly, the calculated values
should be correct.

* Short sales are now supported. There is a new Sell Method,
'SHORT SALE'. the purchase price is 0 until you cover the
sale. When you record a purchase in the Buy Form, Capital
Gainz checks for any outstanding short sales for the
security and asks if you want to cover them. If you don't
use short selling, turn it off in User Settings for slightly
better performance during purchases. You can turn it on
later, or it is automatically turned on when you execute a
short sale. There is an example of a short sale in the users
manual.

* In User Settings, you can elect to include or not include
open commissions in the basis for calculations. Previously,

9





they were not included in the basis - thus, you could have
greater than 100% loss on an open or closed position. You
can try this setting either way - it's strictly for personal
preference. Commissions are always included in calculations
for the tax forms.

* You can choose to view the user documentation from the Main
Menu. This uses the same file viewer as for reports, but
with one big performance enhancement for the users manual -
on installation, a small index file is created for the users
manual to speed up going to specific pages.

* Some of the function keys on tables have changed,
particularly in the Local Security Table (previously the
Security Table).

* Last accessed local/global security is saved and highlighted
on return to the table.

* When recording a FEE in the Distribution Form, you have the
option of selling shares to cover the amount. If you don't
pay your mutual fund IRA fee with a separate check, this is
what they are doing to get it - watch your statements.

* You can now use an averaging method with non-mutual fund
securities. You are given a warning, and the IRS won't like
it.

* From the Local or Global Security Table, you can choose to
update prices from an ASCII file. The file format is:
Symbol,Price,Date. Also, in User Settings, you can specify a
file name to read on startup to update prices. You can
create a 'skeleton' price file, with all of the global
security symbols, from the Local or Global Security Table.

* A separate program CGUTIL, provides some handy, non-
essential tools for registered Capital Gainz users. This
program includes: Upgrade, Rebuild Price History File,
Copy/Move Portfolio, Copy/Move Security, and Import/Export
Comma-Delimited File.

* The Capital Gainz users manual is now a perfect bound book.

* Added Interest distribution type. A global security is
defined as receiving interest or dividends.

* Added CD (Certificate of Deposit), to Security types.

* Added option to Broker/Investment Company Report to

10





summarize commissions and fees.

* The Activity Log screens now include a function key to
change the security, in addition to the ESC key.

* Added 'Cost' to Portfolio Detail Report (was Portfolio
Report).

* Added total open shares value to right of Shares field on
Buy Form.

* If you have Confirm Delete set to YES, then deleting a
record causes the appropriate form to pop up, and then you
are asked for confirmation. You don't accept the form first
anymore. Likewise, if you are not confirming deletions, then
you are not shown the corresponding form before the record
is deleted.

* The Interest section has been added to the Schedule B
report.

* The Schedule D report has been replaced by the Schedule D-1
report. All of the other information on Schedule D had been
left blank anyway.

* Added a listing of fees to the Schedule B report.

* You can now specify whether or not to round off to dollar
values in the tax forms.

* The tax forms now print the local security symbol and as
much of the symbol name as will fit on the form.

* You can now switch between the Buy Form, Sell Form, and
Distribution Form without going back to the Activity Menu.

* Report were renamed for consistency's sake: there is now
Portfolio Summary, Portfolio Detail, Activity Summary, and
Activity Detail (as well as the rest). What may cause
confusion for current users is that the Portfolio Report is
now the Portfolio Detail Report, and the Security Summary
Report is now the Activity Summary Report.

* The fractions table now includes 32nds (ie, 1/32, 3/32,
etc).

* Added an option to the Portfolio Detail (previously the
Security Summary) report to use a brief report format, with
one line per security.

11





* Added two options to the Activity Detail report. You can
group the logs by security or log type, and you can print a
'mixed' detail report. The mixed report shows one line per
transaction, and open, close, and distribution activity is
intermingled in chronological order.

* Overhauled the Double Category selling method. Instead of
Capital Gainz automatically performing share 'migration'
from short term to long term, it's now only done on user
request. Thus, entering historical information on selling
shares will work correctly. In essence, the last share
migration date is the date used to determine short-term and
long-term status. If you have used the double category
method, please see the in depth discussion in the users
manual.

* The actual open price is now saved in the sold shares
records. This allows the actual open price/amount to be be
used when you 'unsell' shares that used an averaging sell
method.

* Added a chapter in the users manual on error messages.

* Added a Stock Split example to the users manual.

* The Date Range form combines the two forms used previously
into one. You can enter the begin/end date, or hit a
function key to use all dates.

* Transaction logging is now inactive - the option on the
settings form is ignored. Because of the complexity of
Capital Gainz, performance is degraded far too much by the
I/O used by commit/rollback technology. If you are concerned
about power outages while using Capital Gainz, add a line to
the startup batch file that backs up the data files on
startup.

* You can now reinvest a distribution in a different security.

* Added an example of reinvesting distributions to the users
manual.

* You can now redistribute proceeds from a sale into another
security, for sweeping the proceeds to other accounts. This
works similar to distribution reinvestments. There is a new
setting to allow this.

Revision 3.0 (02/24/92):
* Price History report now has totals, high and low prices at

12





bottom.

* Fixed problem where deleting a local security did not delete
associated open shares, closed shares, and distribution
records if Confirm Deletes was set to NO.

* If try to run without upgrading, now show message in white
on black. Otherwise, hues read from settings file may be
unreadable.

* When sell shares, now ask migration question after sell
method entered, instead of after symbol entered.

* Removed FEE from Price Type Lookup Table.

* Utility Program now allows ESC from Price Interval Form.

* Added Price Type Lookup Table to users manual.

* Fixed scrolling column size in Security Type Table.

* You can now 'unsell' a deleted range of closed shares
records.

* When unsell shares, shares are combined with existing open
shares, if possible.

* Added Return of Principal (PRIN) to distribution types, but
actually ends up selling 0 shares with amount = principal
returned. Also added Return of Principal (PRIN) selling
method. You get the same results using a sale or a
distribution.

* Add Partnership security type.

* Added 'Brief' option for Activity Detail Reports

* Added Calc On/Off option to Buy Shares, Sell Shares, and
Distribution Form. If off, no calculation are done.

* Changed selling shares to use purchase/selling commissions
proportionally. Selling 50 shares of 100 share purchase with
$35 purchase commission now uses only 50/100 * 35 = 17.50 of
purchase commission in closed shares record. Likewise,
combining 2 purchases of 60 and 40 shares into one sale with
$35 commission results in selling commissions of 60/100 * 35
= $12 and 40/100 * 35 = $14.

* If you change/delete a record from the Open Shares Log,

13





Closed Shares Log, or Distribution Log, the corresponding
price history entry is changed/deleted. Price history
entries are not deleted if you execute a Delete Range.

Revision 3.0a (02/26/92):
* Added 'Backup' Help screen. Also added 'Maps' as an option
at the bottom of help screens.

Revision 3.0b (03/05/92):
* Made Viewing Documents a little faster by not scrolling when
do PgUp, PgDn.

* Added TOUR.DOC file to shareware release.

Revision 3.0c (03/08/92):
* Sell Method in Local Security updated when shares are sold.

* Re-read SETTINGS file if ESC from Settings Form.

Revision 3.0d (03/15/92):
* Fixed CTL-ENTER bug on Price Form.

Revision 3.0e (03/23/92):
* Fixed overlay problem with Insert/Change/Delete split from
Price Table.

* Fixed change Distr, Split from Price Table so new record
displayed without exiting, rebuilding table.

Revision 3.0f (03/28/92):
* Put program 'subversion' on opening screen.

* Changed CAPGNZ and CGUTIL to create entire CAPGNZ.INF.

Revision 3.0g (04/01/92):
* Fixed Global Security Form, Local Security Form - when
change security, if another record (such as broker) was
looked up, the original security record was reread.

* When sell shares of a security for the first time, if SCAT
or DCAT used on a security defined with a different sell
method, the original sell method was used.

Revision 3.0h (04/06/92):
* Selling shares now takes the sell date into account to:
limit open shares selected for MIN, MAX, and LIFO methods;
recalculate average price for SCAT and DCAT methods.
Previously, the selling process assumed that all shares were
available for purchase - essentially, you were assumed to

14





not enter any purchases subsequent to a sale until the sale
had been recorded.

* Stock splits now only affect open shares and prices
on/before the split date.

Revision 3.0i (04/10/92):
* Cleaned up Double Category stuff. You no longer need to
migrate shares, but you do have to put up with some extra
calculations. The short/long term averages are recalculated
on startup and when shares are sold (based on the sell
date).

* Fixed Price Report from Global Security Table.

* Fixed CTRL-ENTER problem when change closed shares.

* You can now change from an average selling method. You get a
warning, and really should not do it.

* There were problems reinvesting distributions or selling
shares to cover fees when you recorded a distribution
directly in the Distribution Log. Also, redirecting proceeds
from the Closed Log had similar problems. These operation
are now only supported from the Activity Menu.

Revision 3.0j (04/27/92):
* Added comments about Schedule B and D in README.DOC.

* Changed Closed Report so only Short Sales and Short Term
Sales are listed as Short Term. Return of Principal was
being reported as short term also.

* Fixed small bug where if you requested a range of dates for
the Closed Report, the first sale was skipped if happened to
occur on the beginning date specified.

Revision 3.0k (04/30/92):
* Short term capital gains are now combined with dividends,
instead of with long term capital gains, on Schedule D.

Revision 3.0l (05/01/92):
* Fixed problem where changing a Return of Principal record
made it a long/short term sale instead.

* Fixed problem where a warning was given about the sale
preceding a previous sale, but there were no sales for the
security.


15





Revision 3.0m (05/05/92):
* Fixed problem with return of principal - the total basic
reduction was correct, but the individual purchase
reductions were off.

Revision 3.0p (05/06/92):
* Fixed problem with unselling return of principal, with
multiple purchases on one date.

* Also, fixed problem with partial sale of shares that had
return of principal. Basis used price * shares.

Known Problems:
* INSTALL assumes that C:\ is root directory for CONFIG.SYS.




































16