home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PERSONAL / HBRM15.ZIP / HOME.DOC < prev    next >
Text File  |  1994-03-10  |  42KB  |  778 lines

  1.  
  2.  
  3. **************************************************************************
  4. *                        HOME BASIS RECORD MANAGER                       *
  5. *                      Release 1.5        March 1994                     *
  6. **************************************************************************
  7.  
  8.                               Robert Gellman
  9.                              Gellman Software
  10.                           431 Fifth Street, S.E.
  11.                           Washington, D.C. 20003
  12.  
  13.                    (C) Copyright 1991-94  Robert Gellman
  14.                            ALL RIGHTS RESERVED.
  15.  
  16.           ===>  THIS PROGRAM IS SHAREWARE.  DETAILS BELOW.  <===
  17.  
  18.      If you own a house, condominium, cooperative, house trailer, or any
  19. type of residence, you need HOME BASIS RECORD MANAGER.  This program will
  20. help you keep track of the basis (or cost) of your home.  This information
  21. is vital when you sell your home.  By using the HOME BASIS RECORD MANAGER,
  22. you can be certain that you will have all the information necessary to
  23. minimize the taxes due on the profits from the sale of your home.
  24.  
  25.      The tax laws allow a homeowner who sells one home and buys another to
  26. rollover any taxes due.  This means that taxes on profits from the sale of
  27. a home can be postponed for many years.  This also means that you have to
  28. maintain information about a home for years or decades after you have sold
  29. it.  HOME BASIS RECORD MANAGER is perfectly designed for this purpose.
  30.  
  31.      Listen to the IRS:  "You should save receipts and other records for
  32. all improvements, additions, and other items that affect the basis of your
  33. home.  Ordinarily, you must keep records for 3 years after the due date for
  34. filing your return for the tax year in which you sold, or otherwise
  35. disposed of, your home.  But if you use the basis of your old home in
  36. figuring the basis of your new one, such as when you sell your old home and
  37. postpone tax on any gain, YOU SHOULD KEEP THOSE RECORDS AS LONG AS THEY ARE
  38. NEEDED FOR TAX PURPOSES."
  39.  
  40.      Why do you need a computer program to accomplish this?  You could
  41. maintain the information in a ledger.  But you won't.  This program will
  42. prompt you to maintain complete, up-to-date records.  It has information
  43. about basis that you don't have.  It provides printed reports.  If you are
  44. like most computer users who have read this far, you know that you are more
  45. likely to keep complete records in a computer than on paper.
  46.  
  47.      HOME BASIS RECORD MANAGER will help you to identify all costs
  48. associated with home ownership.  The purchase price of your home is just
  49. the starting point.  The program lists three dozen circumstances that can
  50. affect the basis of your home.  Scanning the list provided by the program
  51. will help you to identify every cost element.  The discipline of the
  52. program will save you money.
  53.  
  54.      Tax laws are complex, and there are many surprising events that change
  55. the basis for home ownership.  HOME BASIS RECORD MANAGER offers no tax
  56. advice.  It just helps you in maintaining the records that are necessary so
  57. that you can minimize your taxes.  You may need to consult with a tax
  58. advisor before actually paying tax on the sale of your home, but with
  59. complete records you can be assured of paying the minimum tax possible.  
  60.  
  61. **************************************************************************
  62. *                          RUNNING THE PROGRAM                           *
  63. **************************************************************************
  64.  
  65.      To start HOME BASIS RECORD MANAGER, change to the directory or drive
  66. containing HOME.EXE and enter HOME at the DOS prompt.  The program requires
  67. 256 K and should run under DOS 2.0 or better.  Both color and monochrome
  68. monitors are supported.  A graphics card is not required.
  69.  
  70.      HOME BASIS RECORD MANAGER is menu-driven and simple to use.  If you
  71. managed to buy a house, then you can operate the program.   The best way to
  72. learn is to use the program for a while.  Enter a new house and a few
  73. events.  Then come back and read this file.  This documentation explains
  74. the finer points.
  75.  
  76.      There are three command line switches.  One switch (/HP) selects the
  77. HP Laserjet as the default printer.  Another switch (/IBM) selects the IBM
  78. Proprinter (dot matrix) as the default printer.  Printer use is explained
  79. more fully below.  The third switch allows you to override the use of color
  80. on a color monitor.  To suppress color, use the /BW switch.  You may use
  81. both switches if you like.  Start the program this way:  HOME/BW/HP.
  82.  
  83.  
  84.  
  85. **************************************************************************
  86. *                             REGISTRATION                               *
  87. **************************************************************************
  88.  
  89.      HOME BASIS RECORD MANAGER is shareware.  Shareware provides you with
  90. an opportunity to try a program before you are obliged to pay for it.  You
  91. may use the program on a trial basis for 30 days.  If you don't like it and
  92. don't use it, you own nothing.  If you use the program thereafter, you are
  93. obliged to register with the author.  The price is $25.00.  If you can
  94. afford to buy a home, then you can afford to pay for this software.
  95.  
  96.      To register the program, send $25.00 with your name, address, the
  97. version number you are using, and where you acquired the program, to:
  98.  
  99.                              Robert Gellman
  100.                          431 Fifth Street, S.E.
  101.                           Washington, DC 20003
  102.  
  103.      I hate documentation that goes on for pages explaining shareware and
  104. begging for registrations, so this is it.  IF YOU USE THE PROGRAM, PLEASE
  105. PAY FOR IT.  There are more details on the license agreement, disclaimer of
  106. warranty, and other legal technicalities later in this documentation.  
  107.  
  108.      Gellman Software also offers STOCK PORTFOLIO RECORD MANAGER, an
  109. easy-to-use program that maintains all of the records needed to manage
  110. investments in the stock market.  Registered users of the STOCK PORTFOLIO
  111. RECORD MANAGER can register HOME BASIS RECORD MANAGER for only $20.00. 
  112. Registered users of HOME BASIS RECORD MANAGER are also entitled to a $5.00
  113. discount on the $25 price of the stock market program.  Registered users of
  114. either program also may obtain copies of five freeware game programS from
  115. Gellman Software.  See appendix 1 for more information.
  116.  
  117.      Thanks for your interest and cooperation.  
  118.  
  119.  
  120. **************************************************************************
  121. *                             DOCUMENTATION                              *
  122. **************************************************************************
  123.  
  124.      This document explains the program's general approach and includes
  125. lots of explanatory information.  This document file has margins at 5 and
  126. 75, and there are form feeds roughly every 60 lines.  If you want to print
  127. the document, you can enter TYPE HOME.DOC > PRN from the DOS prompt.  Or
  128. you can load it in your word processor with the proper margins and edit it
  129. to meet your needs.
  130.  
  131.      The program is not as valuable if you can't print reports.  You must
  132. have an IBM Proprinter, HP Laserjet, or printer that is compatible with
  133. either.  Most dot matrix printers work like the IBM, and most laser
  134. printers can emulate the HP.  You must use continuous form paper in your
  135. dot matrix printer.  Version 1.2 permits printing to a DOS file.   The
  136. printer selection process is explained later.  
  137.  
  138.      
  139. **************************************************************************
  140. *                          ADVICE FOR NEW USERS                          *
  141. **************************************************************************
  142.  
  143.      When you start HOME BASIS RECORD MANAGER for the first time, you are
  144. told that the main data file (HOME.DAT) cannot be found.  This is a warning
  145. in the event that any existing data files are not in the current directory. 
  146. Ignore the warning the first time you see it.  If you see it after you have
  147. entered data, chances are that you are in the wrong directory or a file is
  148. missing.  Investigate before entering more data.
  149.  
  150.      When you get to the main menu on your first visit, you only have two
  151. live options.  You can ENTER A NEW HOUSE from the ENTER menu.  The other
  152. option is to QUIT the program.  Once you have entered a new house, all
  153. other options are available.  
  154.  
  155.      The program is easy to use once you get started.  Define a new house,
  156. and then add events to it.  Start with your settlement sheet and find every
  157. expense that affects your basis.  In my case, I found 15 basis events
  158. connected with the purchase of my house.  These included inspections, title
  159. searches, title insurance, and attorney.  You may have more events or
  160. fewer.  Everyone's experience is different.
  161.  
  162.      I have also recorded about 15 improvements that I have made in the ten
  163. years I have owned my house.  Some were major -- like a new heating system
  164. or a new room.  Others were minor -- like a door knocker.  Refinancing my
  165. mortgage added ten more events.  You can list separately all expenses
  166. related to a specific improvement or you can lump them together.  This is
  167. entirely up to you.
  168.  
  169.  
  170.  
  171.  
  172. **************************************************************************
  173. *                             WHAT IS BASIS?                             *
  174. **************************************************************************
  175.  
  176.      NOTE:  Most of the information in this section is taken from IRS
  177. publications.  Tax laws are changeable, and there is NO guarantee that this
  178. information is either correct or current.  
  179.  
  180.      Basis is a way of measuring your investment in property for tax
  181. purposes.  The basis of property you buy is usually the cost or purchase
  182. price.  While you own the property, you may make adjustments (increases or
  183. decreases) to the basis.  If you change the original basis, you have
  184. adjusted the basis.
  185.  
  186.      This adjusted basis is used to figure gain or loss when you sell or
  187. otherwise dispose of the property.  You also must know the adjusted basis
  188. at the time of a casualty to determine your deductible loss for the
  189. casualty.  If you change your home to rental or business use, your
  190. depreciation is based on the fair market value of the home or its adjusted
  191. basis at the time of the change, whichever is less. 
  192.  
  193.      PURCHASE - The original basis of a home you bought is the purchase
  194. price or cost of the property to you.  This includes your down payment and
  195. notes you gave to the seller.  Certain settlement or closing costs are
  196. added to or deducted from your basis.  Some of these costs are discussed
  197. below.
  198.      
  199.      CONSTRUCTION - If you contracted to have your house built on land you
  200. own, your original basis is the cost of the land plus the amount it cost
  201. you to complete the house.  This includes the cost of labor and materials,
  202. or the amounts paid to the contractor, and any architect's fees, building
  203. permit charges, utility meter and connection charges, and legal fees
  204. directly connected with building your home.
  205.  
  206.      If you built all or part of your house yourself, the original basis is
  207. the total amount it cost you to complete it.  Do not include the value of
  208. your own labor or any other labor you did not pay for in the cost of the
  209. house.
  210.  
  211.      CONDOMINIUM - Your basis is its cost plus improvements.
  212.  
  213.      COOPERATIVE APARTMENT - Your basis in the apartment is usually the
  214. cost of your stock in the co-op housing corporation, which may include your
  215. share of a mortgage on the apartment building.
  216.  
  217.      GIFT - If your home was a gift, its original basis to you is the same
  218. as the donor's adjusted basis when the gift was made.  However, if the
  219. donor's adjusted basis was more than the fair market value of the home when
  220. it was given to you, you must use that fair market value as your basis for
  221. measuring any possible loss if you later sell the home.  You still use the
  222. donor's adjusted basis to measure any gain.  Please be aware that gifts
  223. raise complicated tax questions.  Consult the IRS or your tax advisor.
  224.  
  225.  
  226.  
  227.      INHERITANCE - If you inherited your home, the original basis of the
  228. home is its fair market value on the date of the decedent's death or the
  229. later alternate valuation date if that date was used for federal estate tax
  230. purposes.  If you are a surviving spouse, and you owned your home jointly,
  231. your basis for the half interest owned by your spouse will be one-half of
  232. the fair market value on the date of death (or alternate valuation date). 
  233. The basis in your half will remain one-half of the adjusted basis
  234. determined previously.  Your new basis is the total of these two amounts.
  235.  
  236.      ADJUSTED BASIS - This is your original basis increased or decreased by
  237. certain amounts.
  238.  
  239.      Increases to basis include:  1) Improvements;  2) Additions;  3) Other
  240. capital expenses;  4) Special assessments for local improvements;
  241. 5) Amounts spent to restore damaged property;  6)  Legal recording fees; 
  242. 7) Abstract fees;  8) Surveys;  9) Transfer taxes;  10) Title insurance;  
  243. 11) Architect's fees.  This is not a complete list.
  244.  
  245.      Decreases to basis include:  1) Insurance reimbursement for casualty
  246. losses;  2) Deductible casualty loss not covered by insurance;  3) Payment
  247. received for easement or right-of-way granted;  4) Depreciation deduction
  248. if you used your home for business or rental purposes;  5) Gain from sale
  249. of old home on which tax was postponed.  This is not a complete list.
  250.  
  251.      Certain settlement fees do not affect basis at all:  1) Points; 
  252. 2) Fire insurance premiums;  3) Mortgage insurance premiums;  4) Charges
  253. for services concerning occupancy of the house.
  254.  
  255.      An improvement adds to the value of your home, prolongs its useful
  256. life, or adapts it to new uses.  Improvements are added to the basis of
  257. your property.  Improvements can be anything from a new room to a new
  258. furnace to built-in furnishing to new appliances to new locks.
  259.  
  260.      Repairs maintain your home in good condition.  They do not add to the
  261. value or prolong its life and are not added to the basis of your property.
  262.  
  263.      For example, putting a recreation room in your unfinished basement,
  264. adding a bathroom, putting up a fence, putting on a new roof, and paving
  265. your driveway are IMPROVEMENTS.  These are added to basis.
  266.  
  267.      Repainting your house, fixing gutters, repairing leaks, and replacing
  268. broken windows are REPAIRS.  These expenses do not affect your basis.  But
  269. if items that are considered repairs are done as part of extensive
  270. remodeling or restoration, the entire job is considered an improvement.
  271.  
  272.      If you claimed any residential energy credit and added the cost of
  273. energy items considered improvements to the basis of your home, you also
  274. must decrease the basis by the amount you claimed as a credit.
  275.  
  276.      
  277.  
  278.  
  279.  
  280. **************************************************************************
  281. *                          BASIS CATEGORIES                              *
  282. ************************************************************************** 
  283.  
  284.     HOME BASIS RECORD MANAGER recognizes over 40 basis categories.  Most of
  285. these categories represent events that increase basis.  Some represent
  286. events that decrease basis.  A few represent events that do not affect
  287. basis at all.
  288.  
  289.      The categories are used to keep similar events together.  One report
  290. lists all events for a house according to the basis categories.  Thus, all
  291. improvements will be listed together.
  292.  
  293.      You are not required to use the categories provided by the program. 
  294. While the list of categories is long, it may not include every category of
  295. basis that affects real estate.   You may supply your own categories if you
  296. like.  Follow the prompt (i.e., just hit ESCAPE) from the basis category
  297. screen.
  298.  
  299.      The list of categories will prompt you to identify and include all
  300. events that affect basis.  Scan through the list when it appears on the
  301. screen to look for basis events you might have missed.  
  302.  
  303.      The list of categories shows whether events in that category normally
  304. increase or decrease basis.  This is just a guide.  An unusual transaction
  305. may result in a different effect.  If so, don't feel bound by the guidance. 
  306. Do the right thing.
  307.  
  308.      You can enter events that have no effect on basis.  This is a helpful
  309. facility for several reasons.  First, you can track other events related to
  310. your house that are not basis events.  For example, you might want to know
  311. how much you have spent on repairs that do not affect basis.
  312.  
  313.      Second, you may not be sure if or how some events affect basis.  For
  314. example, points paid by the buyer are normally not basis events, but they
  315. may be in some circumstances.  If you are not sure, record the points as an
  316. event that does not affect basis.  You will have all of the relevant
  317. information, and you can decide on the tax consequences later.  
  318.  
  319.      For more information about basis, I recommend IRS publications 523
  320. (Tax Information on Selling Your Home) and 551 (Basis of Assets).  These
  321. are available at no cost from the IRS.  
  322.  
  323.      For each event, the program allows for both a description and a basis
  324. category.  The purpose of the description is to identify the specific
  325. event.  For example, all new rooms added to your house will be categorized
  326. as "improvements".  You use the description so that you can distinguish
  327. between the new bedroom and the new porch.  
  328.  
  329.      You also may use the note fields that are part of each event to
  330. include additional details of each transaction.  There are two notes
  331. fields.  Use them or leave them blank as you please.
  332.  
  333.  
  334.  
  335.  
  336. **************************************************************************
  337. *                        HOW THE PROGRAM WORKS                           *
  338. **************************************************************************
  339.  
  340.      You will find it helpful to understand how the program stores
  341. information.  There are two types of files created and maintained by the
  342. program.  Summary information about all houses is maintained in a file
  343. called HOME.DAT.  This file grows in size with each house entered.
  344.  
  345.      For each house, you must provide a DOS file name (up to eight
  346. characters) for that house.  Information about the events entered for each
  347. house is maintained in a file using that name with a .LOG extension.  There
  348. is one .LOG file for each house.  
  349.  
  350.      The program checks to make sure that a house file name does not create
  351. a DOS file with a reserved file name.  Thus, names like CON, NUL, LPT1,
  352. LPT2, COM1, COM2, COM3, COM4, LST, and AUX will be rejected.  These are
  353. reserved names in some versions of DOS.  If your file name is rejected,
  354. just pick another one.  
  355.  
  356.      The .LOG file contains information about each basis event entered. 
  357. The file grows in size with each event entered.
  358.  
  359.      If you enter two houses, there will be three data files on your disk
  360. (HOME.DAT plus two .LOG files).  You may NOT change the name of these
  361. files.  If you delete any of these files through DOS rather than through
  362. the menu, all of your data will be irretrievably ruined.  The program
  363. cannot deal with missing files or renamed files.  You may, however, rename
  364. the HOME.EXE file.
  365.  
  366.  
  367. **************************************************************************
  368. *                               PRINTERS                                 *
  369. **************************************************************************
  370.  
  371.      While all information can be viewed on the screen, some useful reports
  372. can only be printed.  The reports are the most powerful feature of the
  373. program.  You no longer need a printer to see reports.  Beginning with
  374. version 1.2, you can print reports to a DOS file, and printing to a DOS
  375. file is the default.  See the PRINT TO FILE discussion below.
  376.  
  377.      The program supports two physical printers:  the IBM Proprinter and
  378. the HP Laserjet.  There are two ways to select a physical printer.  First,
  379. pick SELECT PRINTERS (option 4) from the PRINT menu.  Follow the prompts to
  380. make a selection.  You can switch printers during a session as often as you
  381. like.  The SELECT PRINTERS menu line shows which printer type is the
  382. current selection.  
  383.  
  384.     There is a command line switch to specify a physical printer.  This
  385. switch allows you to specify a printer in a batch file without having to
  386. remember to select it each time you run the program.  To select the HP
  387. Laserjet, enter HOME/HP from the DOS prompt.  Enter HOME/IBM to select the
  388. IBM Proprinter.
  389.  
  390.  
  391.  
  392.      If you don't have a Proprinter or Laserjet, you still may be able to
  393. print.  Most laser printers emulate the HP codes.  If your printer can use
  394. HP codes, then you can print reports.  Many dot matrix printers use the
  395. same codes as the IBM Proprinter.  If you have any dot matrix printer, try
  396. the IBM selection.  When using any dot matrix printer, you must use
  397. continuous form paper.  You cannot feed single sheets.  If nothing else
  398. works, you can always print reports to a file and then load that file into
  399. a word processor.  You can then control printing through your word
  400. processor.
  401.  
  402.      There are only three printer codes used by the program so there is a
  403. good chance that your printer is compatible.  The IBM Proprinter codes used
  404. are CHR$(12) [Form Feed]; CHR$(15) [Condensed Printing - approximately 17 
  405. characters per inch]; and CHR$(18) [Regular Printing - 10 characters per 
  406. inch].  You cannot control the printer using printer switches because most 
  407. reports use both regular and condensed printing.
  408.  
  409.      All physical printing is done through LPT1.  If your printer is
  410. connected to another parallel port or to a serial port, you must handle
  411. printer redirection at the DOS level.  If you don't understand this
  412. paragraph, don't worry about it unless you can't print.  Then you should
  413. consult your DOS manual about use of the MODE command.
  414.  
  415.      When you order a printed report, the program tests to see if printer 1
  416. (LPT1) is on-line.  If it isn't, you are warned.  This test is not reliable
  417. for every type of equipment and configuration so an override is provided. 
  418. If you try to print and there is no printer, the program will crash.  VERY
  419. IMPORTANT:  Before you do this for the first time, exit back to DOS.  This
  420. writes any data you entered to the disk.  Then if the program crashes, you
  421. won't lose any data entered during the current session.
  422.  
  423.  
  424. **************************************************************************
  425. *                                REPORTS                                 *
  426. **************************************************************************
  427.  
  428.      HOME BASIS RECORD MANAGER provides several printed and visual reports. 
  429. The reports are the most powerful feature of the program.  All information
  430. maintained by the program can be printed.  
  431.  
  432.      The report menu offers three types of printed reports.  The first is a
  433. list of all events associated with a house organized by basis categories. 
  434. This is likely to be the most useful report.  
  435.  
  436.      The second report is a list of all events for a house organized by
  437. basis effect.  All increases are listed together; all decreases are listed
  438. next; events with no effect are last.
  439.  
  440.      The third report is a summary of all houses.  There is one line
  441. listing for each house contains a description of the house, the date of the
  442. first and last event for that house, and the current basis of the house.  
  443.  
  444.      In addition to the formal reports, you can print a complete list of
  445. each house and its events.  You may print the entire file or, the main
  446. house files alone.  The screen prompt explains the available options.
  447.  
  448.  
  449.  
  450. **************************************************************************
  451. *                           ASSORTED DETAILS                             *
  452. **************************************************************************
  453.  
  454.      1) CURRENT DIRECTORY:  The program looks for and creates its data
  455. files in the current directory.  Any marginally adept PC user should
  456. already understand directories.  If you don't, read the DOS manual.
  457.  
  458.      HOME BASIS RECORD MANAGER can be run from a floppy or hard disk.  The
  459. data files MUST be in the current directory when the program is started. 
  460. The program can be kept elsewhere if you understand how to do it.  
  461.  
  462.      2) DATA ENTRY:  You can enter and correct new data for a house or
  463. event before formally adding it to the program.  Enter data in the
  464. highlighted field and move to the next field by hitting ENTER or by using
  465. the UP or DOWN cursor keys.  If you try to move in an impermissible
  466. direction, nothing happens.  When the input is correct, highlight the "ALL
  467. DONE" box and hit ENTER.  The ESCAPE key aborts the current data entry.
  468.  
  469.      While entering or editing data in a highlighted field, the standard
  470. editing keys work.  This includes the cursor keys, HOME, END, BACKSPACE,
  471. DELETE.  The INSERT key toggles the standard insert mode.  If you enter
  472. more characters in a data field than the program can accept, the program
  473. beeps at you.  
  474.  
  475.      Some data fields are optional.  These fields can be used to hold any
  476. information that you like.  If data is mandatory and you fail to provide
  477. it, you will not be able to continue.  There are separate note fields for
  478. each house and each event.
  479.  
  480.      3) DELETE RECORDS:  You can delete an individual event or an entire
  481. house file through the delete menu.  If you delete a house file, all
  482. associated events are also deleted.  You are warned several times before
  483. files are actually deleted.
  484.  
  485.      The only safe way to delete files is through the program.  If you
  486. delete an event (.LOG) file through DOS, the house file will still be in
  487. HOME.DAT.  Serious problems will arise because there are no underlying
  488. events.  The program cannot recover from a missing .LOG file.  The only
  489. hope is to delete the house entry and start again.
  490.  
  491.      4) CHANGE RECORDS:  Any data that can be entered by the user can be
  492. changed through the change menu.  House and event data can be modified.
  493.  
  494.      5) DOLLAR LIMITS:   HOME BASIS RECORD MANAGER can handle transactions
  495. in the millions of dollars.  
  496.  
  497.      6) BACKUPS - I STRONGLY recommend that you back up all data in several
  498. ways.  I keep multiple copies of my data files in case of disaster.  I keep
  499. printed copies of data as well.  Finally, I keep all original documents so
  500. that I can recreate the data files if necessary.  UNDER NO CIRCUMSTANCES
  501. should you rely exclusively on the program as the only source of data. 
  502. There is a possibility that an undiscovered error will ruin all data. 
  503. Always be able to recreate essential records.  The legal gobbledygook below
  504. disclaims all responsibility for program failures.
  505.  
  506.  
  507.      7) PRINT TO FILE - Version 1.2 added the ability to print reports to a
  508. DOS file.  This saves paper, allows those with nonconforming printers to
  509. use the program, and permits users to import reports into other programs. 
  510. Printing to a DOS file is the default.  To print on paper, use the SELECT
  511. PRINTERS option on the PRINT menu or the command line switches.  
  512.  
  513.      Version 1.4 added an internal file viewer that allows you to read the
  514. DOS report files.  Use the DISPLAY REPORTS ON SCREEN selection in the
  515. DISPLAY menu.  You will find this to be a great convenience.  You can also
  516. read the documentation from within the program as well.
  517.  
  518.      The program will examine the path and file name that you enter, and
  519. blatantly illegal choices will be rejected.  All target file names MUST
  520. have a .RPT extension, and the default file name is HOUSE.RPT.  Remember
  521. that the path and file name are only checked for validity and not for
  522. availability.  If the drive you select is full or not available (e.g., the
  523. drive door is open), the program will crash.
  524.  
  525.      If the program does crash, any data entered during the current session
  526. may be lost and data files can be ruined.  To be extra careful before
  527. printing to a disk file, exit the program first to write all new data to
  528. disk.  Then restart the program and print to your disk file.
  529.  
  530.      Data written to a disk file will be appended to a file.  This permits
  531. you to write multiple reports from the one or more sessions to the same
  532. disk file.  You can change the name of the target DOS file as often as you
  533. like during a session.
  534.  
  535.  
  536.  
  537. **************************************************************************
  538. *                          PROBLEMS, PROBLEMS                            *
  539. **************************************************************************
  540.  
  541.      I have made only limited attempts to make HOME BASIS RECORD MANAGER
  542. idiot-proof.  If you want to screw up the data, you can do it.  Things will
  543. go well if you follow instructions and enter good data.
  544.  
  545.      Your data should be safe unless you take steps to erase it.  Data is
  546. vulnerable right after it is entered.  The program does not always write
  547. new data to disk immediately.  The best precaution after entering new data
  548. is to exit the program.  This flushes the buffers and writes data to disk.
  549. If you find that data in a house file becomes irretrievably incorrect, you
  550. may have to delete the file for that house and start over.  
  551.  
  552.      Any abnormal end to the program can result in the loss of newly
  553. entered data.  ALWAYS exit through the menu.  An abnormal termination may
  554. also result in the retention of temporary working files.  If you find files
  555. in the default directory with a .XXX extension, these files can (and
  556. should) be deleted.
  557.  
  558.  
  559.  
  560.  
  561.      If HOME BASIS RECORD MANAGER can't find the HOME.DAT data file when it
  562. starts, you are warned.  When you run the program for the first time, this
  563. warning should be ignored.  If you see this warning at any other time,
  564. check it out before you enter any new data.  Note that a missing .LOG file
  565. produces no warning.  You are responsible for maintaining the existence and
  566. integrity of the data files except when the program is running.  The
  567. program has not been known to trash its own files.
  568.  
  569.      The program has been tested in a reasonably thorough manner.  Of
  570. course, it is likely that there are still a few bugs somewhere, and new
  571. features may create new difficulties.  Please write to me if you encounter
  572. a problem or any difficulty of any type.  Be specific about the problem and
  573. what you did that resulted in the error.  
  574.  
  575.  
  576. **************************************************************************
  577. *                     PROGRAMMING NOTES AND HISTORY                      *
  578. **************************************************************************
  579.  
  580.      The current version is written and compiled in Microsoft's QuickBASIC
  581. 4.5 under DOS 3.1.  The source code is not public.  
  582.  
  583.      Version 1.5 was released in March 1994.  It changed the order of
  584. operations as the program finished so that files would be erased or written
  585. to disk as the next to last (rather than the last) act.  It also now
  586. remembers dates, basis category, and documentation for events and will
  587. offer a prompt to repeat the previous entry.  The program shows the report
  588. files available to be viewed.  Finally, the topline display in the file
  589. viewer has been adjusted slightly.
  590.  
  591.      Version 1.4 was released in May 1993.  It added a DOS file viewer for
  592. reports and for the documentation.  Also, an internal problem was fixed.   
  593. The program could accept unlimited events, but it was unable to display
  594. more than 400 using the one-line, scrollable display.  In addition, the
  595. display of events could result in an improper background color if there
  596. were a large number of transactions.  All of this has been fixed by a
  597. complete revision of the display routines.  The display screen is now
  598. constructed on the disk rather than in memory.  The downside is that it
  599. takes longer to create the screen.  A progress counter has been added to
  600. the "Task in Process" screen. 
  601.  
  602.      Version 1.3 was released in June 1992.  It corrected a small but vital
  603. error that prevented basis figures from appearing on the screen.
  604.  
  605.      Version 1.2 was released in April 1992.  Significant changes and
  606. improvements include the addition of the capability of printing to a DOS
  607. file.  Printing to DOS is the default, and a new command line switch has
  608. been added to select the IBM Proprinter.  The program now recognizes
  609. February 29 as a legal date, but it does not check to see if it is a leap
  610. year.  The report by basis category has been modified so that a category
  611. subheading will not print alone at the bottom of a page.
  612.  
  613.      Version 1.1, the first public version, was released in July 1991.
  614.  
  615.  
  616.  
  617.  
  618.  
  619. ***************************************************************************
  620. *                LICENSE AGREEMENT AND OTHER LEGAL STUFF                  *
  621. ***************************************************************************
  622.  
  623.      THIS PROGRAM AND ACCOMPANYING DOCUMENTATION ARE PROVIDED "AS IS" AND
  624. WITHOUT WARRANTY OF ANY KIND.  THE ENTIRE RISK AS TO THE RESULTS AND
  625. PERFORMANCE OF THE PROGRAM IS ASSUMED BY THE USER.  The entire liability of
  626. Gellman Software and Robert Gellman shall be limited to a return of the
  627. registration price or replacement of the program at the option of Gellman
  628. Software and Robert Gellman.
  629.  
  630.      GELLMAN SOFTWARE AND ROBERT GELLMAN DISCLAIM ALL WARRANTIES, EITHER
  631. EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF
  632. MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE WITH RESPECT TO THE
  633. PROGRAM AND WRITTEN MATERIALS.  
  634.  
  635.      IN NO EVENT SHALL GELLMAN SOFTWARE OR ROBERT GELLMAN BE LIABLE FOR ANY
  636. DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF
  637. BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION,
  638. SPECIAL, INCIDENTAL, CONSEQUENTIAL, INDIRECT, OR SIMILAR DAMAGES) DUE TO
  639. LOSS OF DATA OR ARISING OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM
  640. EVEN IF GELLMAN SOFTWARE OR ROBERT GELLMAN HAS BEEN ADVISED OF THE
  641. POSSIBILITY OF SUCH DAMAGES.
  642.  
  643.      Anyone may use the program for a thirty day trial period.  At the
  644. conclusion of the trial period, you must stop using the program or pay a
  645. $25.00 registration fee.  To register, send $25.00 with your name, address,
  646. and version number you are using to:
  647.  
  648.                              Robert Gellman
  649.                          431 Fifth Street, S.E.
  650.                           Washington, DC 20003
  651.  
  652.      I will respond to all who register to let you know if you are using
  653. the latest version.  Copies of later versions will only be provided in
  654. accordance with the update policies set out below.
  655.  
  656.      There is no restriction on personal use of the program by a registered
  657. user.  Registered users may not license others to use the program or
  658. transfer their license to others.
  659.  
  660.      Anyone may give a copy of the program with all accompanying
  661. documentation to any other person.  The program with its documentation may
  662. be distributed by computer bulletin boards, software clubs, shareware
  663. libraries, and similar organizations at a standard charge for media and
  664. distribution.  The maximum charge permitted without specific written
  665. permission from Gellman Software is $6.00.  No other forms of distribution
  666. for money are authorized.
  667.  
  668.      The program and its documentation are copyrighted.  No one is
  669. authorized to make changes to either the program or the documentation.
  670.  
  671.  
  672.  
  673. ***************************************************************************
  674. *                             UPDATE POLICIES                             *
  675. ***************************************************************************
  676.  
  677.      I plan to fix errors, make changes and improvements, and add new
  678. features from time to time.  I WELCOME SUGGESTIONS FROM USERS.  I am not,
  679. however, making any binding commitments to issue updates or corrections.  
  680.  
  681.      While I expect to issue occasional updates, I am not anxious to get
  682. into the disk distribution business.  HOME BASIS RECORD MANAGER is
  683. available from the Public (Software) Library, P.O. Box 35705, Houston, TX
  684. 77235.  I provide updates to PSL as soon as they are released.  At this
  685. time, disks are available from PSL for $5.00 plus a $4.00 shipping charge. 
  686. A 3.5 inch disk costs an extra dollar.  I encourage everyone to use PSL. 
  687. It offers good service, and its monthly shareware catalog is excellent.  
  688.  
  689.      A Washington D.C. computer bulletin board has agreed to serve as "home
  690. base" for Gellman Software shareware programs.  Sysop Rob Richmond of the
  691. CPA's BBS has graciously agreed to make the programs available to all.  The
  692. phone number of the BBS is 202-882-9067.  The file names will be SPRMxx.ZIP
  693. and HBRMxx.ZIP.  The xx stands for the current version number.  Interested
  694. users may find it worth their while to visit the CPA's BBS and to read the
  695. bulletin about these programs.  I can be reached through the CPA's BBS
  696. under the name Bob Gellman.  Information about the phone number and
  697. availability of the BBS is current as of the file date.  It is, of course,
  698. subject to change at any time.
  699.  
  700.      I try to put new versions on Compuserve and America Online, although I
  701. am not on either system as a user.  
  702.  
  703.      Finally, I will make updates directly available to registered users in
  704. two ways.  Any registered user who sends me a self-addressed, stamped disk
  705. mailer and a disk can receive a copy of the latest version at no cost.  If
  706. a user wants me to provide the disk and mailer, the cost is $5.00.  I
  707. reserve the right to revoke this offer at any time.
  708.  
  709.      I want to discourage people from asking me to provide disks and
  710. mailers.  I don't have the time or the facilities.  But I want to
  711. accommodate my users, and I will provide updates at no cost if you provide
  712. the disk, the mailer, and the postage.  
  713.  
  714.      If you like, I can include my other programs along with any update.  
  715. If you like the home basis program and you own stocks, please consider my
  716. STOCK PORTFOLIO RECORD MANAGER.  My other programs are freeware games and
  717. are described in Appendix I.  Let me know if there are any that especially
  718. appeal to you.  Tell me if you can handle ZIP archives and I will send
  719. everything squeezed on one disk.  All of my programs will not fit on a
  720. single 360K floppy.  It takes two regular floppies or one 1.2 Meg floppy. 
  721. HBRM and the stock market program will fit on one disk, however.
  722.  
  723.      I have always responded to any correspondence from registered users so
  724. let me know if you need help, find problems, or have complaints.  Alas, I
  725. cannot promise to notify registered users of new versions.  The Public
  726. (Software) Library monthly catalog will contain update notices.
  727.  
  728.  
  729. ***************************************************************************
  730. *               APPENDIX I:  OTHER GELLMAN SOFTWARE PROGRAMS              *
  731. ***************************************************************************
  732.  
  733.      SPRM39     STOCK PORTFOLIO RECORD MANAGER         (shareware)
  734.  
  735.           This program stores, manipulates, and prints records needed to
  736.      manage a portfolio of stocks.  STOCK PORTFOLIO RECORD MANAGER totally
  737.      replaces or supplements paper records.  It provides powerful reports
  738.      about your portfolio, transactions, and dividends.  Both laser and dot
  739.      matrix printers are supported.  Anyone who has investments in the
  740.      stock or bond markets should consider using this program.
  741.  
  742.  
  743.      HBRM15     HOME BASIS RECORD MANAGER              (shareware)
  744.  
  745.           If you own a house, condominium, cooperative, house trailer, or
  746.      any type of residence, you need HOME BASIS RECORD MANAGER.  This
  747.      program will help you keep track of the basis (or cost) of your home. 
  748.      This information is vital when you sell your home.  By using the HOME
  749.      BASIS RECORD MANAGER, you can be certain that you will have all the
  750.      information necessary to minimize the taxes due on the profits from
  751.      the sale of your home. 
  752.  
  753.      Gellman Software has also published these freeware games:
  754.  
  755.      POKER571       Head to Head Draw Poker            (freeware)
  756.      1POKER14       Poker Solitaire                    (freeware)
  757.      CALC15         Calculation Solitaire              (freeware)
  758.      LABELLE4       La Belle Lucie Solitaire           (public domain)
  759.      SIXLTR42       Six Letter Word Game               (freeware)
  760.  
  761. The last two programs were coauthored by other programmers.
  762.  
  763.       These programs are available from the Public Software Library, P.O.
  764. Box 35705, Houston, TX 77235.  The latest versions are normally sent to PSL
  765. as soon as they are released.  I recommend PSL to anyone interested in
  766. shareware or freeware.   Gellman Software programs are also available on
  767. finer computer bulletin boards in the Washington, DC area and elsewhere.
  768.   
  769.      Copies of all programs are available directly from Gellman Software. 
  770. Send a self-addressed, stamped mailer and disk to the address on the first
  771. page.  State which programs you want.  IMPORTANT:  Please indicate if you
  772. know how to handle ZIP archives.  If you want all programs, send one 1.2
  773. Meg disk, two 360K disks if you can unZIP, or three 360K disks if you do
  774. not understand ZIP archives.  There is no charge if you supply the disk,
  775. the mailer, and the postage.  
  776.  
  777.  
  778.                         ****End of HOME.DOC****