Developer's README for Name version 0.7
copyright 2001 by Nathan Wilson

Welcome to the developer's version of the Name Management Engine.

This package includes the source for the November 2001 general release of Name.  The package
currently only runs under MacOS pre OS X on the PowerPC chip.  The package was developed using
MetroWerks Release 5 (IDE version 4.0).  The developer's version does not include a
working executable  It does include all the source for the executable.

Included with this file should be the following files:

Name                       - MetroWerks project file
Fungi Database             - Current version of the Fungi database
Doc:                       - Documentation folder
  User:                      - User documentation (new developers should start here)
    doc.html                   - User manual and overall design information
    db.gif
    edit.gif
    file.gif
    list.jpg
    multi.jpg
    rename.jpg
    reports.jpg
    rose.gif
    search.jpg
  Developer:                 - Developer documentation
    object-overview.html       - Brief descriptions of all C++ objects used in Name
    rose.gif
Source:                    - Source for the objects described in object-overview.html
  ADescReader.cp
  ADescReader.h
  AExReader.cp
  AExReader.h
  Answer.h
  ASCIIReader.cp
  ASCIIReader.h
  Block.h
  BlockCategory.cp
  BlockCategory.h
  BlockLevel.cp
  BlockLevel.h
  BlockList.cp
  BlockList.h
  BlockListIter.h
  BlockProperty.h
  BlockString.cp
  BlockString.h
  CellPerRowSelector.cp
  CellPerRowSelector.h
  CLListener.h
  DB.cp
  DB.h
  DBElement.h
  DBEq.cp
  DBEq.h
  DBGroup.cp
  DBGroup.h
  DBList.h
  DBListener.h
  DBName.cp
  DBName.h
  DBReport.cp
  DBReport.h
  Debug.h
  Deque.h
  Filter.cp
  Filter.h
  FilterElement.cp
  FilterElement.h
  GroupFilterElement.cp
  GroupFilterElement.h
  GroupRep.cp
  GroupRep.h
  IndirectParentsReport.cp
  IndirectParentsReport.h
  IntCache.cp
  IntCache.h
  IntIntCache.cp
  IntIntCache.h
  IxBlock.h
  IxCategory.h
  IxCategoryBlock.h
  IxEq.h
  IxEqBlock.h
  IxGroup.cp
  IxGroup.h
  IxGroupBlock.h
  IxLevel.h
  IxLevelBlock.h
  IxList.cp
  IxList.h
  IxListBlock.cp
  IxListBlock.h
  IxListElement.cp
  IxListElement.h
  IxListElementBlock.h
  IxName.cp
  IxName.h
  IxName1.h
  IxName1Block.h
  IxNameBlock.h
  LineParser.cp
  LineParser.h
  LineRep.cp
  LineRep.h
  LViewFuncs.cp
  LViewFuncs.h
  Main.cp
  MultiGroupQuestion.cp
  MultiGroupQuestion.h
  MultiTaxaQuestion.cp
  MultiTaxaQuestion.h
  mw_assert.cp
  mw_assert.h
  NamedStateMap.cp
  NamedStateMap.h
  NameFiles.cp
  NameFiles.h
  NameFilterElement.cp
  NameFilterElement.h
  NamerApp.cp
  NamerApp.h
  NmCollection.cp
  NmCollection.h
  NmCollectionList.cp
  NmCollectionList.h
  ntoh.h
  OrphanReport.cp
  OrphanReport.h
  PPCheckBox.cp
  PPCheckBox.h
  PPEditField.cp
  PPEditField.h
  PPListBox.cp
  PPListBox.h
  PPListWindow.cp
  PPListWindow.h
  PPPopupMenu.cp
  PPPopupMenu.h
  PPSearchWindow.cp
  PPSearchWindow.h
  PPSelector.cp
  PPSelector.h
  PPSelectorPanel.cp
  PPSelectorPanel.h
  PPTextTableView.cp
  PPTextTableView.h
  RenameQuestion.cp
  RenameQuestion.h
  Report.cp
  Report.h
  ResIDTs.h
  SaveDBQuestion.cp
  SaveDBQuestion.h
  SaveListQuestion.cp
  SaveListQuestion.h
  Selector.cp
  Selector.h
  SelectorPanel.cp
  SelectorPanel.h
  StackList.h
  Statement.cp
  Statement.h
  StringBlock.cp
  StringBlock.h
  StringDeque.h
  StrUtils.cp
  StrUtils.h
  TaxonRep.cp
  TaxonRep.h
  TaxonReport.cp
  TaxonReport.h
  TaxonReportQuestion.cp
  TaxonReportQuestion.h
  UnitTester.cp
  UnitTester.h
  Prefix:                    - Source for the MetroWerks precompiled headers
    DebugPrefix.h
    DebugPrefix.pch++
    FinalPrefix.h
    FinalPrefix.pch++
    Name.h
    PrefixCommon.h
Resources:                 - Macintosh resources used by Name
  Name.ppob
  Name.rsrc
Name Data:                 - MetroWerks datafiles
  CWSettingsMacOS.stg
  PPC Debug:
    TargetDataMacOS.tdt
  PPC Final:
    TargetDataMacOS.tdt



What's new in this version:

0.7:
Supports common names both in the interface and through the ASCII Extension Format.
Common Names are generalized so it should be fairly straight forward to add names in other languages
(as long as you stick to ASCII characters).
Interface lists can now be optionally restricted to accepted names only.
New report which describes the database as a whole.
Common names added from Mushrooms Demystified, 2nd Ed.
Some more scientific names added.

0.6:
Now reads the ASCII Extension Format which allows for easy addition of new names and renaming of
old names.  See AExReader.
Now has database reports that describe a particular taxon (TaxonReport), lists any orphaned names
(OrphanReport) and lists any names whose accepted parent is more than one level away
(IndirectParentsReport).
The database has been extended to include many of the higher level taxa for the genera in old
database.  This process is not yet complete and I'm hoping that others will volunteer to do this
work.

0.5:
Populates the list to the right if only a single item is selected in a panel.
See PPSelectorPanel::SetSibling.
Warns the user if multiple names are added and gives them a chance to review the list.  See
the new class MultiTaxaQuestion.
Gives the user a chance to review name changes.  See the new class RenameQuestion
Warns the user if they are closing a list window with unsaved changes.  See the new class
SaveListQuestion.

0.4:
Fixed bug that crashes the program when adding longer names.  See PPListWindow::AddSelection for
the fix.

0.3:
First public release