(c) Dr Jeff Software 2009-10
PRODUCT INSTALLATION GUIDE
==========================
EASY INSTALL
In most cases, installation of any Dr Jeff app is very easy.  Simply download,
unzip (extract all files), and go.  Double-click the app's ".exe" file, or its
shortcut (user created), to launch.  That's it!

Users may want to read on for details, for a more complete understanding, or
if there are any problems with this "easy install".  Especially read the details 
of "Installation" below, and the section on "Security Software" if the app's 
launch does not happen (it may be filtered and/or quarantined by antivirus software).

(This text file should be printed and saved for future use for all Dr Jeff 
Software products.  However, since this applies equally to all our products,
and since the installation procedure is really quite simple, you may not need 
to refer to it after your first install.)

SYSTEM SOFTWARE REQUIREMENTS
(Please check for the complete set of "system requirements" on a separate 
document on our website.)
1. "Microsoft.NET Framework" - All Dr Jeff Software products require your PC to 
have this installed.  ".NET Framework" comes pre-installed on Vista and Win7, and 
it is available for XP as a free download from Microsoft.  If you do not have 
".NET Framework" installed, go to the "Resources" page of our website for 
further instructions.  Our products will run on any version of .NET Framework.
   The easiest way to determine if your PC has ".NET Framework" installed is to 
run one of our "Demo" products directly off our website (see "DEMO" below).  The
Demo will either run error-free (it is installed), or you will get an error message 
(not installed properly -- see TROUBLESHOOTING below).  
   Note that by Dr Jeff Software products using the "Microsoft.NET Framework," 
all support "library" files (.dll files) are provided ONCE, and only once 
in common -- for all ".NET" programs, and hence, for all Dr Jeff Software products!  
This has the following benefits:
   A. Makes installs and uninstalls much easier -- since there is only one file 
(a single ".exe" file) to install for each product.
   B. Saves disk space by storing only ONE copy of the complete library of ".dll" 
files, leaving each Dr Jeff product much smaller.
   C. Provides a very rich, stable, robust and upgradeable web-form style operating 
environment -- one developed, debugged and maintained by Microsoft itself!  This
translates into error-free computing.  (In the event an error does occur, it will
be trapped either by the Dr Jeff program or by .NET, so that it does not impact
your PC's operation.)

2. ZIP - All Dr Jeff Software products require user PCs to have a "zip" reader
program.  Various Windows versions contain this, including Vista and Win7.  Else, 
users should purchase a program such as "WinZip".  (Note:  "ZIP" is a patented form
of compressing data files, using a "Lempel-Ziv" type of algorithm. ZIP programs
produce archive .zip files containing 1 or more compressed files.)

3. NO OTHER APPS - Dr Jeff provides user's guides and other text files in simple 
text format, for fast opening plus assured compatibility (simple common denominator)
-- thereby not requiring any other apps ssoftware such as MS Word or Adobe Reader, 
with their peculiar version (in)compatibilities and slow startups.

ZIP ARCHIVE
Dr Jeff Software products encapsulate all their product files (see "FILES" below)
into a single ".zip" archive file, providing these benefits:
   1. Simplifies downloading -- it uses a single file
   2. Simplifies installation -- much easier to use than a "setup.exe" file (since 
there is no "installing" process per se)
   3. Speeds up downloading -- the archive file is compressed
   4. Bypasses web server and browser filters -- ".zip" files get through
(most filters do not allow ".exe" files to be transmitted)

FILES
All Dr Jeff Software products consist of a single ".zip" archive file containing a
single application (.exe) file, 2 text files (also on the website, but in the 
.zip file for convenience), plus 0-2 product data files (full product only), viz.:
   1. app file:  named in the format "XXX_vn.m.exe" (e.g., "SMM_v1.0.exe" is the 
first release of the Stock Market Modeler); or "XXX-demo_vn.m.exe" for the demo
(e.g., "SMM-demo_v1.0.exe")
   2. user's guide (product specific, in the form "xxx-user_guide.txt", 
e.g., "SMM-user_guide.txt")
   3. software license, or "EULA" (sole "DrJeff-EULA.txt" for all products; only 
ONE copy needs to be stored, per folder)
   4. product data files (".drj" files that can be treated as ".txt" files to be
read by a simple text reader such as "Notepad") -- in any combination of main data,
user data, sample data files (e.g., "xx-user.drj", "form_data.drj"]

   Most Dr Jeff products will utilize an external "main" data file, containing a 
proprietary coded database (data that is intrinsic to the product).  This makes
for easy upgrades of the DATA portion of such data-intensive apps (e.g., 
Word World's dictionary) -- by providing continual data updates on our website's 
product pages (either for free or a nominal fee).  The new data files can be down-
loaded and replace the older versions directly.  (To change versions, just rename 
the version wanted, and move or rename all others.)
   ALL files of any given product (the app, user's guide, EULA and data, if any)
must be stored in the SAME folder -- anywhere on a PC.  The support file NAMES 
must not be changed (users may change the app file name, but this is not 
recommended).  Use of data files with other names is supported via the "File/Open"
and "File/Save As" menu commands; default file names are used during program load.
   Additionally, Dr Jeff products allow any number of extra USER data files (with 
the "Open" and "Save As" commands).  These files may be given any name, and are 
found via standard file browsing.  These extra data files can be stored anywhere -- 
even in a different folder than the apps.
   Like any Win PC application, Dr Jeff "click2start" (tm) applications can be RUN 
by simply double-clicking the product ".exe" file icon, or its shortcut (which can 
be easily created and placed on the Desktop).

DEMO VERSION
All Dr Jeff Software products have a free "Demo" version (which is sub-functional
but a substantive demo of all features and main functions) posted on our website.
It is expected that each user will want to test the "Demo" version before 
purchasing the full product.

Demo products without data files may be run directly off our website, without 
ever saving any files on your own PC (to keep it "clean").  However, most products
will have data files -- which will need to be downloaded, "extracted" and saved 
along with the program file, in order to utilize the data files.  (The demo program 
may initially be run directly off our website merely to test the basic program, 
running without any data.)

This "Demo" program is the only version of the product which may be run and/or 
downloaded without first being purchased from our website.  Once the "Full" product 
is purchased, it may be acquired and installed as described in the next 2 sections.

PURCHASE
Currently, all released Dr Jeff products are available for sale using any major 
credit card or a PayPal account, via PayPal.  Users will be taken to a PayPal-owned 
web page to complete the transaction.  After payment is accepted by PayPal, users 
will be returned to a new Dr Jeff web page that contains the full product in a 
"zip" archive file, plus in some cases a selection of data files  (e.g., TV provider
databases for Channel88) -- ready for user download.

INSTALLATION
Follow these steps to install any Dr Jeff Software product (full or demo):

1. Download and Save the ".zip" file anywhere on the user PC (into any folder or the 
Desktop) -- use the "save" option from the web browser download dialog box.
2. OPEN the ".zip" file by double-clicking it.
3. Your regular "Zip" reader should launch (either Microsoft Windows' "Zip" or 
"WinZip" or another; if no program launches, and you cannot find one on your PC, 
then STOP until you obtain one).
4. UnZIP all files by selecting the "extract ALL" command -- into any folder (or the 
Desktop).  (You may get a warning from your "zip" program about opening ".exe" files, 
and you should ignore the warning in this case -- since you know what the .exe file is.)
Be sure to store all files in the same folder.  
(Note:  The EULA file need only be extracted/saved once for all Dr Jeff products, but 
must be located in the same folder as the program to be found by it.)
5. Find the extracted ".exe" file (this is your application file).
6. Optionally create a shortcut and place it on the Desktop (right click icon, 
select "Create Shortcut").

RUN
Open/launch the app by double-clicking the original ".exe" file or its shortcut.

The License (EULA) and User's Guide can be opened and read anytime from the
app window via the "Help" commands -- as long as the original file names are kept
and the files are located in the same folder as the app.  These files can also be 
read via Notepad (or other text reader) anytime via double-clicking the files directly 
(from anywhere).

SECURITY SOFTWARE
Antivirus security software such as Norton's AV/360 suites routinely detect and isolate
any downloaded executable (.exe) files, since they may be a threat.  Dr Jeff has requested 
Symantec-Norton's "white-list" approval for all its apps, including demos.  Once approved,
these files are supposed to be included in the next "Live Update" session; and then the
apps would no longer get quarantined.  However, Dr Jeff cannot assure you there will never 
be glitches here.

Moreover, any upgrades to the Dr Jeff apps (new version numbers) will require a new 
"white-list" approval request by Dr Jeff.  While that might take a few days to get resolved,
there might be brief periods when these upgrades would get quarantined.

Users should suspect a Dr Jeff app has been quarantined whenever it is not being launched
after "opening" it, and/or a Norton (or other vendor) alert box pops up saying so.  When 
this happens, opening the vendor's control panel should display the file name along with 
the action taken (e.g., "quarantine").

The workaround for Norton is to select "options" from their control panel, and then select 
"restore" along with "do not filter" this file again (making it now acceptable).  The file should
run without interference from then on.  Repeat this for each instance.

UPGRADES
Dr Jeff may, from time to time, and product to product, issue new versions of a 
product -- an upgrade -- to the program (.exe file) and/or any affiliated data
files.  Dr Jeff lists the latest available product and data versions on the product 
web pages.  Anyone purchasing a Dr Jeff product is eligible to download any such 
upgrades for free.  Users should bookmark the original page from which the initial
download was made, and then return to that page to download an upgrade.

TROUBLESHOOTING
Error messages:
1. "missing .dll files"
Likely due to your PC NOT having the "Microsoft.NET Framework" adequately installed.
In the case of these errors, follow the instructions in the "dotNET-install_guide" 
file on the Dr Jeff website's "Resources" page.
2. "will not initialize"
Likely due to your PC NOT having the Microsoft.NET Framework "system services"
enabled.  These services are normally enabled.  They may have been manually
disabled by a tech or other consultant.  Check this status via the "Selective Startup" 
dialog box.

TO CLOSE:  Hit browser BACK button
LAST EDIT:  9/24/10