README.AHD
                                                         November 19, 1995

TO: DUXShelf OS/2 (ENC) Users
FM: Valon Cross, Sr. Programmer Analyst

RE: 2.00 Release Upgrade to "American Heritage Dictionary & Roget's Thesaurus
    for OS/2"


------------------------------------------------------------------------------
Special Notes
------------------------------------------------------------------------------

                             README FIRST
                             ------------

This installation upgrades your American Heritage Dictionary product with
a new program, new fonts, and a new help file.  You also get the new 
Concise Columbia Electronic Encyclopedia's help file (but you'll need
the database to take advantage of it).  

The new program (DUX.EXE) is called "DUXShelf" and is our new platform for
a bookshelf reference databases.  You already have the dictionary and
thesaurus database files.  DUXShelf also works with the the Concise Columbia 
Electronic Encyclopedia database with thousands of entries and hypertext.  
We plan to add additional reference works (e.g. the full Columbia Electronic 
Encyclopedia).
                            INSTALLED FILES
                            ---------------
README.AHD     This file.
DUX.EXE        The DUXShelf program.
DUXSHELF.DLL   The DUXShelf database interface library.  
AHDPHON.AFM    New dictionary fonts.
AHDPHON.PFB    New dictionary fonts.
AHDPHONI.AFM   New dictionary fonts.
AHDPHONI.PFB   New dictionary fonts.
AHD.HLP        New dictionary on-line help.
ENC.HLP        Encyclopedia on-line help.


                             CONFIG.SYS
                             ----------
Note:  If you do a manual install, then the following describes what changes 
need to be made to CONFIG.SYS.  Use the system editor "E" to add the
following changes.  The installation utility should make these changes for 
you.  

Note:  When you have received the Concise Columbia Electronic Encyclopedia's
database, you will also get a statement added for the encylopedia's database.
If this is only an upgrade to the dictionary, ignore references to the 
encyclopedia.

The databases can now reside on different drives and directories than the
DUX.EXE and DUXSHELF.DLL program & font files.  The install utility will add 
the following line(s) to your CONFIG.SYS:
   SET DUX_AHD_DATA=C:\DUXSHELF
   SET DUX_ENC_DATA=C:\DUXSHELF
where C:\DUXSHELF is the directory you specified for the data.  This will
default to the installed program directory.  

You can install and run DUX from the hard drive, yet keep the dictionary's 
database on the CD ROM.  Look for the file ahd3dlx.dct on your CD ROM - this 
is the dictionary database.  Set the DUX_ENC_DATA CONFIG.SYS variable to this
directory.  

The install program also modified the CONFIG.SYS' statements:
   SET PATH=
   SET LIBPATH=
   SET HELP=
by appending "I:\DUXShelf;" where "I:" is the drive for the DUXShelf
directory.  These changes and the above SET DUX_ENC_DATA= & SET DUX_AHD_DATA=
are all the changes needed to reconfigure CONFIG.SYS manually.  


-----------------------------------------------------------------------------
Usage Notes and "Requirements"
-----------------------------------------------------------------------------

If the program won't run, initially, try starting it from the command line
with DUX /I to reinitialize its initialization file.  This can fix problems
if the program or its files get moved.  This should be no problem for an 
initial installation.  

Please alert us if you find "show stopper" bugs.  These are program crashes.

Also give us your "wish list" of desired additional behaviour or any other
bugs, little or not so little.  See "User Feedback" towards the end of this
document.  Do read over the list of high-medium-low planned bug fixes and 
enhancements later in this manual.  If we know about the ommited behaviour, 
don't just ask for it, try to prioritize it vs. other features to add or 
behaviour to enhance.  This ensures that we do the work most needed and 
wanted by our users!  Give us a rank of 1 to 10 (with 1 being the most 
desired bug fix or enhancement) for all of your suggestions.  Again, this 
will really help us prioritize our efforts.  


-----------------------------------------------------------------------------
New Features (since 1.6 pre-release version only)
-----------------------------------------------------------------------------
2.0 Release
- Copy entry text to the clipboard!
- Window resizing between the entry display and the list box.
- Application resizing.  
- Size and position saved between runs.  
- Progressive Search in the Browse page.  "Type your way" to any entry in
  the database.  
- Tabbing between a page's windows.  
- Increased dictionary font size to 10 points for increased readibilty.  
- The initialization paramaters are now kept in the OS/2 system .INI files.  
  This feature will be important when DUXShelf with multiple databases is 
  distributed on CD ROM.  
- Search displays a "No Entries found" message if search returns nothing.
- Added keyboard "Alt-" accelerators to the word search tab page.  
- The Home & End keys scroll to top and bottom of the entry text.  
- The Left & Right arrow keys scroll up and down like the Up and Down arrow
  keys.  
- The Dictionary's phonetic font and character mapping has been overhauled.  
- Many dictionary font problems are fixed.  Make sure you have the following 
  files (or the dictionary won't run):
      AHDPHON .AFM
      AHDPHON .PFB
      AHDPHONI.AFM
      AHDPHONI.PFB

-----------------------------------------------------------------------------
Bugs & current limitations in priority order.  If you have other priorities, 
let us know.  
-----------------------------------------------------------------------------

                             "high priority"

Entry Text Display Window Customization:  We have a known large "hole" in
the user interface:  You can not currently change the size, colors, or the 
fonts of the text in the entry display window.  Nor can you set the window
background color.  This really is an enhancement, not a bug.  But it seems
vital and thus is forthcoming ASAP.  

The line length calculation is off and therefore word wrap is imperfect.  
Space is wasted at the end of a line.  Narrow punctuation characters are 
forced to the next line, even though there is room on the preceeding line.
Occasionally a word is not wrapped when it should be.  Try resizing the entry
text display window with the splitter bar or the program's frame.  

Smooth (and faster) Entry Window scrolling.  


                             "medium priority"

Clear the text window (like the "Lookup Entry" tab) if no or multiple 
returns for word search, anagrams, and thesaurus.  

Search:  Highlight the search word(s) in the entry's text window.  


                             "low priority"

Beef up the saving of dragged and dropped custom colors & font.  Not all 
changes are saved & restored.  


-----------------------------------------------------------------------------
Other Planned Enhancements
-----------------------------------------------------------------------------

                                   Options
                                   -------
Copy Text to Clipboard:  Add line breaks between definitions and between the 
entry heading and the entry's text.

                                    Other
                                    -----
Printer setup and entry text printing.

Multimedia, Multimedia, Multimedia, Multimedia, Multimedia, Multimedia!
At least pictures and diagrams.  I've always wanted the "Periodic Table of
the Elements" a few mouse clicks away.  And what did Millard Fillmore
look like?  Just kidding, this is important but it's not available yet.  


-----------------------------------------------------------------------------
User Feedback
-----------------------------------------------------------------------------
Do include the version # at the beginning of the feedback report.  This
is in the program's title bar.  

Review the on-line help (& this readme) for clarity, content, and proper 
English.  Please consult the on-line help for detailed program usage 
instructions.
  
Let us know if this is necessary.  Ideally, you would never need to use the 
on-line help.  You can also comment on the printed documentation.

We want to know about "english" bugs in any of the program's displayed text.
If you see any character mapping display bugs, please note these too.

Please send comments/criticisms/bugs to Beth Stevens at DUX Software.  She 
can be reached in the following ways:

EMAIL
     beth@rivendell.com

PHONE/FAX
     V (415) 473-1800
     F (415) 462-8723

US MAIL
     Beth Stevens
     c/o DUX Software
     425 Sherman Ave.
     Suite 330
     Palo Alto, CA 94306

Your positive comments can be as specific or general as you wish!

But criticisms need to specific for a possible "quick fix".  If you find a 
bug we need the EXACT steps you took to arrive at the bug.  The "hyper text"
feature can take many steps to find a problem.  

If the bug is reproducible or the criticism is specific, then we can address
the issue without calling and asking you "what did you mean when you said...?"  

And you need to give us your name and phone number(s) so we can get back to 
you, if need be.  

You can currently receive updates via FTP at:
     ftp.rivendell/dux


Thanks again, in advance.


Valon Cross & Mark Pietras
DUXShelf Programmers



-----------------------------------------------------------------------------
DUXShelf Release History
-----------------------------------------------------------------------------

1.6 Release
 * If the user gets multiple returns after pressing the Enter Key for "Lookup 
   Entry" entry, focus is put on the list box.  Use the arrow keys & the enter
   key to select a list box entry.  This works for the Enclopedia database.

 * Text window scrolling:  Added "Drag" scolling and proportionally size the
   scroll bar thumb.  The thumb now indicates the amount and position of the
   displayed text lines vs. the total # of text lines in the displayed entry.

 * The browse page now has an input field - like the "Lookup Entry".  This
   is the start of our new "Progressive Search" feature.  This works, but it's
   not stable.  The program will crash if you use this a lot.  But "when it's
   good, it's really good!"  See high priority bugs, below.  Go ahead and try
   it.  

1.5 Release
 * The dux.ini, help, and font files are now located using the executable 
   program's path which lets you run DUX.EXE from the command line even if
   you are not in the DUXSHELF program directory.  Because dux.ini is written
   to, you must install DUXShelf to your hard drive.  The program, help, and 
   font files take up less than a meg of space.  The data can be left on the
   CD ROM.  

 * You can run DUX.EXE and DUXSHELF.DLL with the American Heritage Dic-
   tionary's database, if it's in the default directory or if you modify
   CONFIG.SYS to specify the location of the dictionary database.  This is
   specified in the next topic.  The default database is  currently the 
   encyclopedia database.

 * The databases can now reside on different drives and directories than the
   DUX.EXE and DUXSHELF.DLL program files.  The install utility will add 
   the following line to your CONFIG.SYS:
      SET DUX_ENC_DATA=C:\DUXSHELF
   where C:\DUXSHELF is the directory you specified for the data.  This will
   default to the installed program directory.  

   When there is a combined "DUXShelf" installation, you will get the addi-
   tional following line added to CONFIG.SYS for the American Heritage 
   Dictionary:
      SET DUX_AHD_DATA=I:\AHD
   where I:\AHD is the dictionary's data location.  Until this installation 
   version is available, edit CONFIG.SYS with E.EXE and add the dictionary 
   SET statement yourself (if you have the dictionary & thesaurus data files).

   You'll be able to install and run DUX from the hard drive, yet keep the 
   dictionary's database on the CD ROM.  Look for the file ahd3dlx.dct on your CD
   ROM - this is the dictionary database.  Set the DUX_ENC_DATA CONFIG.SYS 
   variable to this directory.  

 * You can now run DUXShelf with the dictionary open in one window and run another
   copy with the encyclopedia database open in another window.  

 * You can toggle between the two databases using the new buttons on the upper 
   right of the DUXShelf's window frame.  This feature is brand new and not 
   stable.  The program can crash, but no harm results.  Please report patterns 
   of switching that cause crashing to DUX.  If you are only testing the ency-
   clopedia, don't worry about it.  If only one database is found, only one 
   button is displayed.

 * All screens, for either database, support the new clipboard copy text 
   option.

1.4 Release    
 * Copy displayed entry text to the clipboard!  Use the new Edit menu choice
   to capture the displayed text into the clipboard.  It can now be pasted
   into the text or word processor of your choice.  
   
   You can quickly test this by starting the "E" program (this is the simple 
   text mode "word processor" that is normally installed with OS/2.  Use the
   Edit - Paste menu choices to paste text after you have copied the Encyclo-
   pedia's displayed text.

1.3 Release    
 * The application's outer window frame is resizable.  The topic display 
   window shares the window frame's width with the browse list list box 
   window.  There is a thin vertical line separating the two windows. This 
   line can be dragged left and right to change the relative window widths of
   the these two windows.

 * Some window surfaces can be customized by "dropped" custom colors.  But, 
   not all changed surfaces are saved & restored.  You can change the font in 
   the browse list, the menus, static text, the tabs, and the title bar by 
   dragging fonts from the font palette.  Like the colors, not all fonts are 
   saved & restored, but most are.  If you want to "restart" with the 
   defaults, delete the DUX.INI file.  

                             --- End of README ---
