DeepaMobil 1.0b8                                                           
================                                                           


DeepaMobil is a topic maps based knowledge management tool for PalmOS handheld devices.
DeepaMobil is a side project of the DeepaMehta project.

Joerg Richter
9.4.2002

www.deepamehta.de



Requirements
  - PalmOS handheld device resp. the PalmOS emulator for desktop PCs
  - SuperWaba, a Java Virtual Machine for PalmOS
  - Memory requirements for PalmOS device
    - JavaVM:     280 K
    - DeepaMobil: 200 K + your data

Features
  - 7 built-in topic types
    - Project (a topicmap)
    - Memo
    - Person
    - Company
    - Email
    - Document
    - Webpage
  - Built-in "Music" example
    - Artist
    - CD
    - Track
  - Workspace for organizing projects
  - Several projects can be open at the same time (use the menu button to switch projects)
  - Memos of the Palm buit-in Memo application are appearing as memo topics
  - Creation of associations between topics (click, wait, and then drag a topic)
  - Navigation along associations (command "Show Related")
  - Editable topic properties (incl. clipboard, use menu button while editing)
  - Search topics by type / name / properties (fulltext, case-sensitive)
  - Navigation in large search results
  - Hiding topics/associations
  - Application Framework for application developers
  
Which DeepaMehta features are missing?
  - No document management
  - New topic types can't be defined interactively
  - No export/import feature
  - No groupware capabilities
  - No access to corporate datasources
  - No internet features (email, searching the web, offline browsing)


Running DeepaMobil on the PalmOS Emulator
-----------------------------------------

If you want install DeepaMobil on a real PalmOS device instead of the emulator you can
skip step 1) and must modify steps 2) and 3)

1) Installing the PalmOS emulator

  - Download the PalmOS emulator and skins
    - go to http://www.palmos.com/dev/tools/emulator/
      the emulator is available for Windows, Mac OS (Classic and X) and
      Linux (sources only)
  - Get an image file of the PalmOS ROM
  - Start a emulator session

2) Install SuperWaba 2.2

  - Download and install SuperWaba 2.2
    - go to http://earthoid.org/dwn/down.htm
    - download "SuperWaba 2.2 VM", 200K zip-archive
      (if you plan to develop your own Java applications for PalmOS download
      "SuperWaba 2.2 SDK" instead, filesize is 2.1MB)
    - create a new folder "SuperWaba VM 2.2" and unzip the zip-archive into it
      (if you've downloaded the SDK name the foler "SuperWaba SDK 2.2" instead)
  - Install these 3 files from "SuperWaba VM 2.2" into the PalmOS Emulator
    - SuperWaba.pdb
    - SuperWaba.prc
    - SWNatives.prc
    To install .pdb and .prc files into the PalmOS Emulator use the "File" menus's
    "Install Application/Database" command. (if you've installed the SDK the 3 files are
    found in "SuperWaba SDK 2.2/org/superwaba/palm")
  - To verify the SuperWaba installation run the "SuperWaba" application by clicking
    it in the emulator. After a splashscreen the display should show:
    "SuperWaba Virtual Machine" / Version 2.2 for PalmOS / Virtual Machine installed and
    ready / No SuperWaba programs installed

NOTE: new installed applications are not instantly shown. To see new installed
applications start and immediately quit another application (e.g. the Calculator).

3) Install & Run DeepaMobil

  - Install these 4 files from "DeepaMobil" into the PalmOS Emulator
    - DeepaM.prc
    - DeepaMobil.pdb
    - DM Reset.prc
    - DM Reset.pdb
  - To run DeepaMobil tap the "DeepaM" icon
  - To reset the corporate memory to its initial state tap the "DM Reset" icon


Development
===========

Building the software
---------------------

1) Build tools
  - go to DeepaMobil/Development/Tools
  - execute ./compile

2) Build MultiEdit (by ...)
  - go to DeepaMobil/Development/Sources/MultiEdit
  - execute ./compile

3) Build DeepaMobil
  - go to DeepaMobil/Development
  - execute ./compile
  - execute ./prc
  - execute ./warp

4) Build "DM Reset"
  - go to DeepaMobil/Development/Sources/DM Reset
  - execute ./compile
  - execute ./prc
  - execute ./warp

Enhancing DeepaMobil
--------------------

You can enhance DeepaMobil at sourcecode level, e.g. you can develop further topic types
(or modify the existing ones) by means of DeepaMobil's Application Framework.

NOTE: while development the current directory must be DeepaMobil/Development (otherwise
scripts will not perform correctly)

1) Make your sourcecode changes

2) Build DeepaMobil
  - execute ./compile

3) Testing on desktop PC (as Waba applet)
  - execute ./test

4) Install on PalmOS device
  - create and install DeepaMobil.pdb file by executing ./warp
    Note: recreating and installing DeepaM.prc (by means of ./prc) is not necessary

5) Building API documentation
  - execute ./doc

6) Clean up
  - execute ./clear


Version History
===============

1.0b8  9.4.2002
  - minor change

1.0b7  26.3.2002
  - Begin of support for building types by derivation
  - New standard topic types: "City", "Country", "Continent",
    new standard association type "is located in"
  - "Music" example updated, new topic type "Studio", association type "participation"
    replaced by 11 dedicated association types

1.0b6  20.3.2002
  - Association Types (including property definitions). Standard association types are
    "association" and "composition". Composed elements may be ordered by means of
    composition's "Number" property.
  - New association command "Open" displays the properties of an association (editable)
  - New topic command "Show Info" displays a report about a topic
  - Extended "Music" example, new topic type: Label. Association types: creator,
    participation, membership. Possible participations: Vocal, Drums, Percussion,
    Saxophone, Keyboards, Composition, Arrangement, Production, Mixing, Engineering, ...
  - Main menu simplified (just 2 entries: "Create Project" and "Create ...")
  - The "Search" function is now triggered by the Palms "Find" button.
  - Info window and property window can scroll vertically (use Palms up/down buttons)
  - Improved support for higher than 160x160 display resolutions
  - Fixed: The workspace has no "Close" command anymore
  - Bug fixed: newly created Palm memos are propertly imported in next DeepaMobil session
  - IMPORTANT: database model changed -> "DM Reset" required

1.0b5  11.3.2002
  - Improved GUI for search and navigation (a lot of details)
  - Associations of a Search topic are updated when its query changes
  - "Music" example extended (more data, display CD cover images)
  - Support for higher than 160x160 display resolutions, more test scripts (JDK required)
    - testsony (320x320)
    - testbig  (640x480)
  - Geometry of result lists fixed
  - Serious bugfixes (problems with hide/delete/remove)

1.0b4   8.3.2002
  - Container feature now complete
  - Example "Music" for demonstration of new container feature
  - First Document Management facilities (not complete)
  - New Icons (thanks to Harald)
  - Type menus are sorted (create and search menus)
  - Improved property window layout (lesser wasted space), e.g. see email
  - Geometry of result lists improved (not perfect yet)

1.0b3   5.3.2002
  - Memos of the Palm buit-in Memo application are appearing as memo topics
  - Topics can be searched by type
  - Container for navigation in large search results
  - Improved property window layout (fields have individual height)
  - Creating a new topic can be canceled -- thanks to Harald
  - Framework for Application Developers
  - IMPORTANT: database model changed -> "DM Reset" required

1.0b2  28.2.2002
  - property definitions, e.g. a company has name, fax, address and info
  - "Open" command replaces "Info" and "Rename" commands -- thanks to Harald
  - IMPORTANT: database model changed -> "DM Reset" required

1.0b1  26.2.2002
  - initial release

Project begin: 8.2.2002