-----------------------------------------------------------------
###   The header/title
-----------------------------------------------------------------

              SMan (aka "Symbian Manager") v1.4

              Coding by Yip Je Sum (Droll) and
             Design by Adrian Chiang (AudioJack)

                   Released: 4-May-2005

                 URL http://renegade.w3xs.com
                    mailto:ajack@w3xs.com


-----------------------------------------------------------------
###   Forward
-----------------------------------------------------------------

This manual refers to v1.4 of the SMan program.  Anything that
has been updated from v1.3 will be marked with "[Update]." Any
new feature will have "[New]" in front of it.

Due to the various flavors of UIQ devices in the market, some
options in SMan will be grayed out on specific UIQ
implementations because a function or module is not needed or
does not work correctly with that manufacturer's implementation 
of UIQ.

If you are upgrading from SMan v1.2c or have trouble uninstalling
SMan v1.2c from your UIQ device, please see the "Upgrading"
section of this manual.

If you have been using SMan for more than a month and appreciate
the time and effort put into it's development, please contribute
to it's further development by "buying" as many copies as you
thing SMan is worth.  We strongly suggest you "buy" a copy of
SMan every time we release a new version that you think has 
changed the way you use your device for the better. The URL to
"buy" SMan is at:

http://shop.my-symbian.com/PlatformProductDetail.jsp?siteId=695&productId=117105

Please buy all your UIQ software from Handango via the My-Symbian
shop.  By doing so, you are giving My-Symbian a commission for
every purchase you make.  This will allow My-Symbian to further
operate their website for free as they have done in the past.
We strongly believe that My-Symbian is the most important website
for any UIQ owner.  To purchase other software from Handango via
My-Symbian.  Please visit this URL at:

http://shop.my-symbian.com


-----------------------------------------------------------------
###   About SMan
-----------------------------------------------------------------

SMan is a system utility that manages your UIQ device. It
provides functionality which manufacturers did not provide or
which are difficult or impossible to do manually. SMan helps
keep your UIQ device running in a "healthy" state and, to a
certain degree, allows you to customize the system behaviour of
your device.

Changes since SMan v1.3

- [New] SMan can now process ZIP files.  You can now ZIP/unZIP 
  files and SMan's ZIP module also supports password encryption.

- [New] SMan can now decode Nokia's Smart Messaging encoded SMS
  messages.

- [Updated] SMan now sports a new icon!

- [Updated] The DTMF Dialer can now read numbers from your 
  Contacts.

- [Updated] Network Info has been enhanced to allow you to
  display a message on the screen or SMS as an event trigger.
  Also, you can now configure SMan to allow others to query
  your location.

- [Updated] Task Manager now can now query the OS for 
  information about a running process.

- [Updated] File Manager has also been enhanced to display the
  icons of files.  The File Manager also integrates with the 
  ZIP Manager so that you can quickly (de)compress files from
  the File Manager directly.  The search option has also been
  enhanced to search for hidden files if you choose to do so.

- [Updated] The Bluejack module now allows you to send any file
  you want instead of a vCard only in earlier versions.

- [Updated] Today View now works in flipclose mode.

- [Updated] The "P900 to P800" option has been renamed
  "Old skool"

- [Updated] SysInfo now also shows how long your UIQ device has
  been running since the last reboot.

- [Updated] The Autostart feature is now unlimited and allows
  you to control the order of applications running and a delay
  before the next application is loaded. 

There are some quirks of the program you should know of:

Sometimes, compressing the heap leaves you with less memory
than you started with. This can happen for many reasons. One
of the most common ones is there are background processes that
are working and allocating memory. The Free RAM status at the
bottom of SMan only shows you a snapshot of free RAM at a
point in time. By the time you click on "Compress Heap," the
free RAM reported may be less. The workaround is to hit the
"Refresh" button until you see the free RAM stabilize before
using the "Compress Heap" button.

Sometimes compressing RAM does not reclaim all possible empty
space.  This is due to heap trashing.

Sometimes, an application can use more RAM than is reported in
SMan.  An application can setup communication buffers with
various system servers that run in the background. The shortfall
in RAM could be due to server-side buffers that are being held on
behalf of the application.


-----------------------------------------------------------------
###  The "Fn" menu
-----------------------------------------------------------------


All of SMan's functions and capabilities begin with the "Fn"
menu.  That is the central point of SMan.  If you want to use a
module or utility not visible in the current SMan screen, just
tap the "Fn" menu.

The "Fn" menu consist of the following sub-menus:

1. Start

   Allows you to launch (the "Run" option) any application
   installed on your UIQ device. It also gives you the option to
   configure seven (7) shortcuts of your favorite applications
   which can be managed with the "Assign" menu.  After the
   seven (7) shortcuts, SMan will also "remember" the last
   three (3) applications you have launched so that they are
   also easily accessible on consecutive runs. If you launch an
   application from the seven (7) shortcuts, it will not be
   "remembered" in the list of last three (3) applications you
   have launched.


2. Modules

   The modules section contain the additional capabilities that
   SMan has to offer users.  By default, the Task Manager is
   shown when you first launch SMan, the other modules can be
   activated by going to this "Modules" menu and selecting the
   modules you would like to use.  The current modules are:

   a. Task Manager
   b. File Manager
   c. SysInfo
   d. Bluejack
   e. InfoStore
   f. Today View
   g. DTMF Dialer
   h. Network Info
   i. ZIP

   Each module is explained in detail in the "Modules
   Explained" section of this manual.


3. Utilities

   The Utilities section contains the system utilities that help
   you manage your UIQ device.  They consist of:

   a. Fix applist
   b. Compress contacts
   c. Fix synch timezone
   d. Set system font
   e. Old Skool
   f. View picture SMS
   g. Notifications
   h. Fix app order
   i. Autostart

   Each utility is explained in detail in the "Utilities
   Explained" section of this manual.


4. Control Panel

   This section gives you quick access to the following sections
   of the control panel found in the UIQ device:

   a. Bluetooth
   b. IrDA
   c. Phone
   d. Others


5. Options

   The Options section allows you to choose what modules you
   would like to see in the modules section.  This can be done by
   going into the "Navigation" menu.  This menu also allows you
   to choose which module will be activated by default when you
   run SMan.

   The Hotkey sub-menu allows you to select one of the buttons on
   your UIQ device to call up SMan while it is running in the
   background.  The hotkey behaves differently when pressed in
   the various modes of the UIQ device.  You can configure the
   hotkey to activate differently when the hotkey is pressed
   quickly or when a long press is done.  Also, the behavior is
   further configurable to behave differently when SMan is
   in-focus or not in-focus ("ex-focus") and again when your UIQ
   device is in flip close or flip open mode.
 
   On some devices, this gives you eight (8) configurable
   behaviors to your UIQ device from one hotkey.

   The "Disable Hotkey" option disables the hotkey that SMan uses
   temporarily.  This is usually used when you would like to
   launch another application that also uses the same hotkey.

   The Ignore "harakiri" option when checked, will ignore any
   request by the OS to ask SMan to quit from memory.  Note,
   "Harakiri" is a Japanese word to describe an act of suicide
   much like what the Symbian OS "asks" of applications.


6. Reboot

   This option allows you to reboot your UIQ device.
 
  
7. About

   The About menu tells you a bit about the authors of SMan. It
   also has a Credits screen with the list of people /
   organizations which we would like to thank for helping us
   directly or indirectly in making SMan the great product that
   it is today.

   It also gives you the name of the translator for SMan if you
   are using a non-English version of this program and manual.


8. Quit

   This quits the program.


-----------------------------------------------------------------
###   Modules Explained
-----------------------------------------------------------------


    -------------------------------------------------------------
1.  Task Manager
    -------------------------------------------------------------

    The Task Manager helps you manage all the running processes
    that are in memory.

    Some background information.  The Symbian OS was designed
    in such a way that when a program is launched, the current
    program should be pushed into the background and left in a
    suspended state until it is once again called by the user
    after which the OS will again put the program in focus and
    push the current program into the background.  This reduces
    the starting up time for an application if it is already
    residing in memory.

    Should the OS find that it is running low on memory, the
    least used application will be "asked" by the OS to
    terminate itself from memory (ie.  The OS issues a
    "harakiri" command to the application).  The application is
    then supposed to clean itself up, release all memory it holds
    and terminate.  That is one reason why most applications do
    not have a Quit, Exit or Close function as the Symbian OS by
    design should know when to "ask" an application to terminate.

    However, there are times when a misbehaving or badly written
    program would not suspend itself when in the background and
    continues running when not needed and thus eats up
    processing time which drains the battery faster.


    The Options menu contains the following:

    Details           - This option gives you background
                        information like the Application UID,
                        amount of RAM it uses and how many
                        process threads does the application
                        use.

    Flipclose flush   - Will terminate all apps not in the
                        defined snapshot when the device's flip
                        is closed should this option be checked.
                        This option must be used in conjunction
                        with the "Snapshot" option.  Also, this
                        option only works on devices that have
                        a flip such as the Sony Ericsson P800 and
                        P900.

    Forced endtask    - By default, SMan will ask the application
                        that is running to do a cleanup and quit
                        from memory.  However, not all
                        applications will honor this request.
                        Checking this option uses the OS to
                        terminate the application. However, no
                        application cleanup is done. 

    Flush exclude     - When checked, the "Flush" command will
                        remove all applications that are not
                        checked from the running tasks list and
                        not in the snapshot list.

    Show hidden tasks - Will show you system/hidden tasks.

    The five (5) buttons at the bottom of the screen (from left
    to right) are:


    Flush     - The flush command removes all running processes
                that are not in the snapshot list.

                Note: If you have not taken a snapshot before,
                      the flush command will not work.  The
                      behavior is further changed by the
                      "Flush exclude" option.

    Endtask   - This button will terminate tasks that have been
                checked. This is very useful if the application
                you had launched does not have a quit or exit
                command.

                Depending on the option you have selected in
                the "Options" menu (ie. "Force endtask"),
                endtask will either do a force application
                terminate via the OS or a "request" to the
                application to do a cleanup and terminate
                itself.

    Refresh   - This refreshes the list of running applications
                on the main screen and updates the amount of
                memory each application is using.

    Snapshot  - The snapshot command records the list of
                applications running in memory and stores it
                in SMan's snapshot file.  This information
                is used when the user issues a flush command.
                SMan will purge all running applications from
                memory except those in the snapshot list.

    Compress  - Tells the OS to compress the heap memory and free
    Heap        up the unused memory.


    The progress bar at the bottom of the screen button will
    show how much free RAM you have in your UIQ device in
    percentage values.  To get the exact amount of free RAM
    available in the device, simply tap the progress bar and
    a system message will appear on the screen indicating
    how much free RAM you have and the total RAM available on the 
    device.



    -------------------------------------------------------------
2.  File Manager
    -------------------------------------------------------------

    The File Manager component of SMan allows you to see the
    file system of your UIQ device and gives you the ability to
    copy, move, delete, rename, beam (via Bluetooth or Infra-red
    and the OBEX protocol), CRC calculation, hexedit and change
    file attributes.  You can also view hidden files, launch
    applications and open data files directly from the file
    manager.

    The Options menu contains the following:

    Bluetooth or - Allows you to choose what transport layer
    IrDA radio     you would like to use when you beam a file
    buttons        across to another device (Bluetooth or
                   IrDA).  The highlight bar in file manager
                   will change to blue for bluetooth and red for
                   IrDA.  The protocol used by the beam command
                   is the OBEX (OBject EXchange) protocol and
                   only devices which use the OBEX protocol can
                   send or receive from the UIQ device.

                   There is a known bug in all UIQ
                   implementations we have had our hands on
                   where if you decide to use IrDA as your
                   transport layer, you must manually activate
                   IrDA on your UIQ device.  Failure to do so
                   will result in an error message.

    Sort         - Allows you to sort the file list by either
                   name, date or size in ascending or descending
                   order.

    Icons        - There are three (3) options to the icons.
                   They are None, Basic and Full.

                   None  - No icons are shown.
                   Basic - Drive, file and folder icons from
                           SMan's defaults are used.
                   Full  = Will get the icon from the
                           application by using recognizers.

    Show hidden  - When checked, will show files and folders that
                   are marked hidden by the file system.

    Auto run app - Will run the file that you tap on if it is an
                   executable (.EXE) or application (.APP) file.
                   This only works if the .EXE or .APP file is
                   part of an application recognized by the
                   Application Launcher in UIQ. Will also open
                   .ZIP files with SMan's ZIP Manager if you have
                   enabled that module

    Auto open    - Will open the data file that you tap on if
    file           there is a proper recognizer installed to
                   launch the application required for that file
                   type.

    Jogdial      - By default, pressing the jogdial will make the
    opens          File manager check the file or folder currently
                   highlighted.  However, with this option checked
                   you can open the data file or application by
                   pressing the jogdial.


    Below the menu option bar for file manager are two info bars.
    The first bar shows you the full path into the current path
    where the directory contents are currently being shown.  The
    second bar shows the sub-folder or file properties
    (attributes) of the highlighted entry as well as the last
    updated modified date and time of the entry.  The properties
    shown are "RSHA" for (R)ead only, (S)ystem, (H)idden, and/or
    (A)rchived.  If the attribute is not set, a "-" will be shown
    instead.

    For example, the attribute "R--A" shows a file with the "read
    only" and "archive" properties on.  The two "-" indicates the
    that particular attribute is switched off.  This tells us
    that the "hidden" and "system" attributes are not set.

    If you tap on the file size of a file or "<dir>" text for a
    directory, you will only highlight the file instead of
    opening it (if auto open is enabled or navigating into the
    subfolder if you tapped on a subfolder).

    Tapping on the drives shortcut in the file list display (A:,
    C:, D: and Z:) will immediately send you to the last folder
    you were on for that particular drive. If you have not
    previously browsed the drive, it will default to the root
    folder. If you want to browse the root of the drive
    immediately, use the "Drives" menu at the top.

    The Drives menu:

    Will show you all the drives made available to your UIQ
    device, what volume label the drive has and how much free
    space is available on the drive.

    The six (6) buttons at the bottom of the screen (from left
    to right) are:

    All        - This option selects all files in the current
                 directory.

    None       - This will de-select all files you had
                 checked earlier.

    Create     - This will create a folder in the existing
    Folder       directory.

    Refresh    - This refreshes the display.

    Search     - This will allow you to search for files by
                 by name and/or filetypes (the "*" wildcard can 
                 be used) or based on a range of files modified 
                 dates.

    Do         - The "Do" button opens up the options you can
                 do with the files you have highlighted.  The
                 "Do" button's menu is divided into two
                 parts.  All options above the separator line
                 (ie. Beam, Cut, Copy, Paste, Rename, Delete
                 and Make ZIP) will only take effect on files 
                 you have checked.  The options "Get CRC," 
                 Properties, Open, Duplicate  and Hexedit will 
                 take effect only on the current highlighted 
                 file.

                 Note: A 'move' action can only be done by
                       first doing a "Cut" operation followed by
                       the "Paste" in the new location.  Much
                       like a clipboard action.

                 The "Get CRC" option is handy when you want
                 to make sure that the file you have has not
                 been tampered or corrupted.  How the CRC is
                 calculated can be seen by checking the SMan
                 v1.2 source codes when it is released or by
                 looking into a sample program CRC.PAS
                 (written in Virtual Pascal v2.1).  The
                 CRC.PAS file is included in the source codes.

    The Hexedit sub-menu:

    File

       Save     - This commits to media all the changes you have
                  made to the file you are editing.  Due to
                  memory limitations on your UIQ device, SMan
                  will only maintain changes for a particular
                  "page" (128 bytes) within the file. If you
                  navigate away from the page, you will be asked
                  whether you want to commit the changes of that
                  page.

       Reload   - Tells SMan to discard any changes you have made
                  and reload from media that section of the file
                  you are editing.

       Preserve - When committing changes to media, this will
       date       preserve the file's original time/date stamp.
                  If this is unchecked, it will stamp the file with
                  the time and date of committing the change.


    Edit

       Delete   - This option allows you to delete the bytes
                  highlighted only at the last page of a file.
                  This effectively reduces the file size.

       Read     - If checked, SMan will not let you make any
       Only       changes to the file.  Some files cannot have
                  this option unchecked. For example, files on
                  the ROM drive.

       Resize   - Allows you to change the HEX and ASCII windows
                  sizes.


    The six (6) buttons at the bottom of the hexedit screen (from
    left to right) are:

    Jump to start  - Jumps to the start of the file at offset 0.

    Previous page  - Jumps to the previous block (128 bytes) of
                     data.

    Jump to offset - Jumps to a user requested offset of the
                     file.
 
    Next page      - Jumps to the next block (128 bytes) of
                     data.

    Jump to end    - Jumps to the last block of data.

    Back           - Quits the hexedit screen and returns to
                     File Manager.
         

    The Search sub-menu:

    The four (4) buttons at the bottom of the screen (from left
    to right) are:

    Start Search    - Will initiate a search based on the
                      settings defined in the Search Criteria
                      settings.

    Stop Search     - When a search is in progress, you can
                      interrupt the search by pressing this
                      button.

    Search Criteria - Set the criteria of the search.

    Back            - Quits the Search screen and returns to
                      File Manager.
         

    The file search menu works by first going to the General tab
    and defining the search criteria of the filename/extension.  
    By default, it will search for all files and file types 
    ("*.*") as defined in the Name field.  You must then select
    which drives to search for.  You will also be allowed to 
    search from the current directory.  If you would like to
    refine the search to a certain range of dates, you will need
    to go to Date tab.  You can quickly select the Today or 
    Yesterday date to search for or specify a specific range of 
    dates.

    When you press the Start Search button, the File Manager will
    search in the drive or path defined and will recursively go
    through each sub-folder and lists out all the files it has
    found.  Tapping on each item listed will make the File
    Manager jump to the directory where the file was found and
    highlight the file.


    -------------------------------------------------------------
3.  SysInfo
    -------------------------------------------------------------

    Will show you various information about your UIQ device.
    The information is queried from the device using a device
    discovery class provided by the Symbian SDK.

    Clicking on each field will open a window that shows the
    complete information for that field.

    This option can be very useful when you want to compare the
    differences between UIQ devices made by different
    manufacturers.

    At the bottom of the screen, the SysInfo module will also
    show you how long the UIQ device has been running since the
    last reboot of the device.

    Note: The detection library that Symbian provided is not
          100% accurate.  There are instances where it reports
          back to SMan incorrectly.  This will need to be fixed
          by the device manufacturer.


    -------------------------------------------------------------
4.  Bluejack
    -------------------------------------------------------------

    The bluejack option when activated aggressively sweeps for
    bluetooth enabled devices and attempts to bluejack them.
    This process results in a lot of battery power being consumed
    by the UIQ device.  The parameters here offer a timeout
    behavior that would reduce the number of sweeps SMan does
    when found in certain conditions.

    Note: these settings make more sense if you set your
    Bluetooth Operation Mode to "Auto". However, "Auto" is often
    less reliable in establishing connections with the remote
    device. Experiment on your own to find whether "On" or "Auto"
    works best for you.


    =============================================================

    If you want to know more about bluejacking, visit this site
    at URL:

    http://esato.com/board/viewtopic.php?topic=15976&forum=16

    There is also an SMan log analyzer on the internet made by
    a third party developer, you can visit the site URL:

    http://www.blujack.com

    =============================================================


    The Options menu contains the following:

    Timers        - Set the bluejack timeouts for certain
                    conditions. (see below, timers explained).

    Prox. sweep   - Allows you to configure the level of details
    logs            in your log file. (see below, logs
                    explained).

    Notifications - Allows you to configure how SMan notifies you
                    of a successful Bluejack.  This can be done
                    via a message on the screen, a vibrate to
                    the phone, or by playing an audio file.

    Message       - This option will set the bluejack message.
                    You can choose to use the built-in which is
                    actually a vCard or choose the "Other file"
                    option which allows you to choose any file
                    type you want to send.

    Exclude list  - Allows you to record all the bluetooth
                    devices you do not want to bluejack.

    Resolve name  - If checked, will show the bluetooth device's
                    name instead of its bluetooth address.

                    Note: Some devices may have no name assigned
                          to them.

    Prox. sweep   - If checked will do just one round of device
    once            discovery to bluejack. (ie. Nuke everyone
                    within range)

    Log to disk   - Log all bluejack activities onto a log file
                    in SMan's directory.

    The Log menu:

    Clear mem.    - Will clear the log that is in memory.
    log

    File log      - Gives you access to the complete log
                    file located in
                    "\system\apps\sman\sman.log.txt" and
                    has the sub-options to "View" or
                    "Delete" the file log.

    The three (3) buttons at the bottom of the hexedit screen
    (from left to right) are:

    Sweep       - This will do a proximity sweep for all
                  discoverable bluetooth devices around you.
                  While the sweep is running, you can stop the
                  process by clicking the "Stop" button.

    Individual  - Scans for all discoverable bluetooth devices
                  around you and lets you select which device
                  to Bluejack.

    Stop        - Stops the bluejack function.


    Bluejack Timers explained:

    OBEX timeout (secs):  - How long to wait for OBEX related
                            operations. In our tests, some OBEX
                            operations did not appear to have a
                            built-in timeout.

                            Min: 10 secs, Max: 30 secs.

    Decay (secs):         - How long for SMan to wait before it
                            bluejacks the same device again.

                            Min: 5 secs, Max: 1800 secs.

    Failed Attempts:      - Determine how many failed attempts
                            (ie. sweep that return no bluetooth
                            devices in range) before calling
                            the cool-off timeout.

                            Min: 1 time, Max: 10 times.

    Cool-off (sec):       - How many seconds to cool-off (ie. not
                            to scan for bluetooth devices within
                            range).  This when used with the
                            "failed attempts" option allows SMan
                            to not scan so aggressively for any
                            bluetooth devices and this in turn
                            conserves battery.

                            Min: 1 sec, Max: 1800 secs.

    Bluejack Logs explained:

    This option allows you to select the level of logging you
    would like to see when a bluejack is in progress.  This can
    be handy as you activate the "proximity sweep" and walk
    around the city.  There are so many places you do not expect
    to find people with bluetooth devices and yet, SMan is able
    to detect them and bluejack them.  What you can do is to get
    SMan to log all it's activities and from there, you can find
    out how many devices you had bluejacked.

    The log options are done in realtime and can be changed while
    a sweep is in progress.  You can log all successful
    bluejacking, OBEX calls, scanning progress and decaying
    behavior.


    In flipclose mode:

    Press the Menu key and you you have the following options:

    4 - Starts a proximity sweep
    5 - Clears the memory logs


    -------------------------------------------------------------
5.  InfoStore
    -------------------------------------------------------------

    InfoStore helps you keep sensitive information for easy
    retrieval like passwords and PIN.  The database is kept
    secured by a password so that you only need to remember one
    password to access all your personal information.

    By default, a newly initialized database has a password of
    '0000'. This is also the default password that SMan will use
    to try and open your database when you ask it to. Also, if
    you uninstall SMan, the database file remains intact in the
    folder where you installed SMan. If you later choose to
    reinstall SMan, your data will be available to you. If you
    wish to completely remove SMan, remember to delete this file.

    The Options menu contains the following:


    Open DB
       Opens the InfoStore database file to access the personal
       information stored within.  If you have password
       protected the DB, you will be prompted for the password
       before the information in the database can be accessed.
       If you set your password to "0000", you will not be
       prompted to enter the password because this is the default
       password that SMan uses to open the database file.

    Close DB
       Closes the database file.  You cannot do anything to
       the file when the file is closed except to re-init the
       file (see below).

    Change password
       This allows you to change the existing password of your
       database file.

    Re-init DB
       This option allows you to reinitialize the database file
       and effectively erase all the database contents.  You are
       prompted to enter your password before you can re-init the
       DB. If you have forgotten the password, use the File
       Manager to delete the following file:

       \system\apps\sman\sman.db

    Update statistics
       This updates the statistical sampling of records in the
       database to make access time faster. You shouldn't need
       to use this option unless you have a large database and
       have been doing a lot of inserts/updates/deletes.

    Compact
       Does some house cleaning on the database file and
       removes all unused space in the database.  This results
       in a smaller database file which makes access time
       faster.

    Sort ascending/descending
       These radio buttons sort all the information in your
       database (based on [Description of data]) in either
       ascending or descending order.

    The Data menu contains the following:


    Import DB
      Allows you to import your InfoStore database from a .CSV
      file created by the Export DB command.

    Export DB
      Allows you to export your InfoStore database into a .CSV
      file which you can use to re-import back into SMan or
      send to your PC to be viewed in a spreadsheet application
      that supports the .CSV format.

    InfoStore data structure explained:

    The structure of the database is as follows -

    [Description of data]
    [Field1]
    [Data1]
    [Field2]
    [Data2]
    [Field3]
    [Data3]
    [Field4]
    [Data4]
    [Field5]
    [Data5]

    The "[Description of data]" should be used to describe what
    information is being kept in that entry.  This is also
    used to sort the order of the information stored in the
    database file.

    "[Field*]" is used to describe the actual information of
    "[Data*]."  You can input your own field description or
    use the scroll down for the more commonly used field
    descriptions.  SMan will also remember the fields you
    had input earlier on and adds it to the scroll down.

    "[Data*]" is the actual data described by the "[Field*]"
    name.

    If you specify a blank entry for the Display name of a
    record and choose to save it, SMan will delete the
    entire record (if it is an existing one) or discard the
    record (if you are creating a new one).

    If you specify a blank entry for [Field*], the
    corresponding [Data*] field will be cleared out.

    InfoStore button explained, from left to right:


    The "Do" button at the bottom right of the screen allows you
    to perform various function on your records.  They are:
    
    Del  - delete selected records from the list view.

    Add  - add a new record.

    Edit - edit the record you are currently Viewing or
           have highlighted in the list view.

           Note: Depressing the jogdial when editing a
                 record causes the changes to be saved!

    View - view the currently highlighted record.

    Save - save the record you are currently editing.


    -------------------------------------------------------------
6.  Today View
    -------------------------------------------------------------

    Processes your Tasks and Calender options and displays
    appointments that you have for the day (Calendar) and shows
    you all the tasks you have assigned for yourself (Todo).

    The Options menu contains the following:


    Completed
       This allows you to configure the Today View to either
       show you past events for the day or remove them from the
       display. You can also separately configure the "Todo" to
       do the same.

       Note: The show completed option for "Todo" items will
             only show items which have been completed on the day
             you are currently viewing.

    Auto expand
       Allows you to configure which option in the Today View
       you would like to see expanded and displayed.  This
       gives you the flexibility to (for example) only set the
       "Today View" to show "Calendar" entries and not "Todo"
       entries.

    Todo priority
       This settings tells SMan what todo items to show.  You
       can set SMan to show all or only todo items with a
       priority of 1..X where "X" is the priority number.  You
       can also open each todo item and mark them as done when
       you have completed them.

       To open each calendar or todo item, simply tap on it with
       your stylus.

    The two (2) buttons at the bottom of the screen (from left to
    right) are:

    Refresh  - Refreshes the display (when it passes midnight or
               after you have synchronized your UIQ device using
               PCSuite.

    Warp     - This allows you to see a future date (or past
               date) to see what calendar entries you have for
               that day.  You will be prompted to select the
               month and year to view.  Tapping on the actual
               date causes SMan to process the "Today View" for
               that day.  Tapping on the "Today" button will jump
               to the current date (highlighted in red).


    In flipclose mode:

    If you press the keypad keys, you can do the following:

    1/3 - Jump between previous/next year.
    4/6 - Jump between previous/next month.
    7/9 - Jump between previous/next week.
    */# - Jump between previous/next day.
    5   - Jumps to today's calendar.
    0   - Checks the Todo list.


    Press the Menu key and you you have the following options:

    4 - Refreshes the current screen


    -------------------------------------------------------------
7.  DTMF Dialer
    -------------------------------------------------------------

    This module allows you to use your UIQ device to dial on most
    landline phones.  This can be done by producing the DTMF dial
    tones that you hear when you pick up the phone and start to
    dial.  This is very handy when you need to use a phone
    urgently and the only phone near you is locked.

    Note: Using this module in your country may be illegal.
          Please check with your local laws before using this
          module.

    The Dial menu contains the following:

    Contacts   - You can use this option to pick the number
                 from your Contacts application to be used in
                 the DTMF dialer.  However, do take note that
                 land lines do not accept the "+" prefix which
                 you must manually change by yourself.

    Use Keypad - When checked, will produce the appropriate DTMF
                 tones when pressed on the virtual keypad.  When
                 un-checked, you can pre-write the number on the
                 input area or copy and paste from somewhere
                 using the Edit menu.  Then press the "Dial"
                 button on the right.  When using it in this way,
                 SMan will ignore any characters which are not
                 dial numbers. This makes it handy to use. For
                 example, you can cut and paste an entire SMS
                 into the input area and just hit Dial without
                 worrying about SMan rejecting non digit
                 characters.  Note also that the "#" and "*"
                 characters are accepted by SMan for producing
                 DTMF tones.


    -------------------------------------------------------------
8.  Network Info
    -------------------------------------------------------------

    The Network Info modules gives you more information about
    your network that the service provider would like you to
    know.

    The following information is given to you.  However, unless
    you know a bit about GSM or UMTS networks, the information
    provided would not mean much.  The information given by this
    module are:

    1. Signal strength (dBm units)
    2. Current serving Cell Id (in "[]") and the last two cells
       serving your UIQ device.
    3. Country Code of your current provider.
    4. Network Id of your current provider.
    5. The long name and short name of your current provider.
       Note that the information above is network provider
       dependent.

    There is also a group and cell information, but that must be
    provided by you and will be explained later in the document.

    That being said, one of the information provided by this
    module is called the Cell Id.  A Cell Id is the
    identification number of the cell / base station that your
    service provider has put at your location to serve
    subscribers with.  Without a base station in your area, you
    will get no service.  The unique thing about the Cell Id is
    the fact that it is a unique number found only at that one
    location.  So if you see a cell id of XXXX in a particular
    area, you can be assured that in the whole country, XXXX is
    only found in that one location.  This gives us an
    opportunity to create location based services.

    =============================================================
    How the location based services work.
    =============================================================

    In almost all cases, you would like a location based service
    or event to be triggered based on not just one cell but a
    group of cells.  SMan is designed to trigger these events
    based on a group of cells.  If your event is based around
    only one cell, you will need to create a group which consist
    of only one cell.

    Once you have set up your groups (based on a general
    location, path or geographic location -- it's up to you
    as the user to decide how you would like to arrange this),
    you can then set up the events.

    An event can only be determined when your UIQ device enters
    or leaves a group (or both enter and leave).  The current
    triggers offered at the moment are:

    1.  Play a media file. 
    2.  Vibrate the device.
    3.  Display a message on the screen, or
    4.  Send an SMS.

    You can have more than one event per group.  However, if you
    assign multiple events to play a media file, do not expect to
    hear all the files being played.

    You could also make use of the group by collecting cell ids
    of the complete city or route and describe where the cell is
    located.  This can be useful when you give the group to
    another SMan user who may visit your city.  They can look at
    the network info and know where they are and not get too
    lost.  Sometimes, you may see SMan reporting the cell
    id as 0 even though your device is attached to the network.
    This can happen when you toggle the flight mode device on
    your phone.  This is an existing bug in some Symbian
    implementations.  You may have to reboot your device or
    restart SMan to fix this.

    Sharing of groups can be done easily by the import/export
    feature.

    The Options menu contains the following:

    Always run
       Is the option is checked, the Network Info module will
       always run in the background.  This is required if you
       have configured events in this module.  SMan registers
       with the telephony server on your UIQ device in such a way
       that the telephony server only calls SMan when there are
       changes in the cell information, This helps conserve
       battery.  However, please note that toggling this option
       on will still consume more battery than normal usage.

    Autorecord cells
       This options will create a new group and record all the
       cell ids that SMan "sees" when this is checked.  The group
       created will be named by the date and time you started the
       auto-record.  You will need to uncheck this to stop
       recording into the group.  Checking it again will create
       another group.  Each cell that is recorded will have a
       default description of the date and time that your device
       attached itself to that cell.

    Event delay
       This option will cause SMan to do a timeout to an event.
       This means that when an event is triggered, it will not
       trigger again depending on the minutes you have set in
       this option.  This prevents an event from being triggered
       many times because you are in an area that goes in and out
       of that group's boundary.

    Message repeats
       Should you configure the Network Info to trigger a message
       display, you can configure the repeat rate (how fast the 
       message appears between displays) and the number of 
       repeats (how many times the message should appear on the
       screen).

    SMS options
       This option allows you to configure if you would like to 
       allow other users to query SMan (via SMS) for your 
       location.  This is broken up into three (3) sections.
       They are:

       Options

         Monitor SMS    - If checked, will monitor all incomming 
                          SMSes for the keyword and command.

         Keyword        - The keyword that will be use so that 
                          SMan will know this is a query for the 
                          Network Info module.

         Case sensitive - If checked, the keyword will strictly 
                          follow the case of the keyword as well. 

       Filters

         Enabled        - If checked will filter the SMS requests
                          received.

         Criteria       - Allows you to choose if you want to 
                          accept or reject the SMS query.  This
                          helps you create a blacklist or
                          whitelist of who can do the SMS query.

         List           - The actual list of users you will have
                          to make your blacklist or whitelist
                          from.

       List

         Helps you build a whitelist or blacklist.



    Things you will have to note about using the SMS query options.
    During the beta testing, a few users reported that this option 
    was not working.  However, when the user was asked to reformat
    their UIQ device and test, the option works.  We suspect a
    conflict with another application but have not managed to 
    isolate which program is the culprit.

    The list that you create must list the number in there exactly
    like when you receive it in the SMS.  For example, if the SMS 
    comes in a 0(area code)(phone number) and your list has it as 
    +(country code)(area code)(phone number), SMan will see it as 
    two different numbers.

    The Storage menu contains the following:

    Edit
       This allows you to edit groups, cells in the group,
       configure events and import/export groups.  You can
       rename groups, give description to individual cells,
       move cells around and manually add/remove cells.

       Note: Due to the many functions being represented by
             icons in the edit menu, please refer to the
             SMan-NetworkInfo-Edit-English.gif file for a
             description of each icon.

    Re-init store
       This re-initializes the cell info database into a blank
       state.  You may need to run this option once if you are 
       running this option for the first time and have no 
       previous network database information prior to that.

    Compress
       Does some house cleaning on the cell info database file
       and removes all unused space in the database.  This
       results in a smaller database file which makes access
       time faster.

    Update Stats
       This updates the statistical sampling of records in the
       cell info database to make the access time faster. You
       shouldn't need to use this option unless you have a large
       database and have been doing a lot of inserts/updates/
       deletes.

    -------------------------------------------------------------
9.  ZIP Manager
    -------------------------------------------------------------
 
    The way the ZIP manager works in SMan is defined by the two
    primary functions of the ZIP manager.  They are the ZIP
    (creating of a ZIP file) and unZIP (the extraction of files
    from a ZIP archive).

    You must define two folder that the ZIP manager will work
    with.  They are the ZIP folder, where all ZIP files are
    created in and the unZIP folder, where all files extracted
    from a ZIP archive are stored.  To work with an existing
    ZIP file, you will need to view the contents before you can
    work with the file.  Similarly, clearing the ZIP view
    effectively tells the ZIP manager that no more work will be
    done to the ZIP archive being viewed.

    This gives the user the simple task of focusing on the task
    at hand and know that all ZIP files being created or
    extracted are found in a fixed location.


    The File menu contains the following:

    View Contents
       This option opens a ZIP file and shows you the contents.
       You must "View Contents" the file before you can do
       anything with the ZIP file. Viewing the contents of a file
       does not lock the file.

    Clear view
       The clears the ZIP manager state and closes the current
       ZIP file.


    The Archive menu contains the following:

    Extract all
       This option tells the ZIP manager to extract all the files
       in the archive into the extract folder.

    Extract selected
       This option tells the ZIP manager to extract all the files
       that have been checked in the archive into the extract
       folder.

    Add to archive
       Will prompt you to select the files that you want to add
       to the existing ZIP archive or to a new archive.

    Test Archive
       Will test the integrity of the ZIP file and informs you if
       the archive is good or bad and if bad, what files failed
       the integrity check.

    Delete selected
       Will delete all the files in the ZIP archive that have
       been checked.


    The Options menu contains the following:

    Stop zip engine
       This option tells the ZIP manager to stop processing
       the last ZIP request.

    Clear log
       Clears the memory log of the ZIP manager.

    Preferences
       Allows you to determine where all ZIP files are created
       (in the ZIP tab) or the extract folder where all files in
       the ZIP archive are extracted to.  This is broken into two
       tabs:

       ZIP
 
         Folder:

           The Folder option allows you to choose where all ZIP
           files will be created by the ZIP manager.  Just tap on
           the Folder button to navigate to the path you want the
           folder to be designated.

         Compression:

           You can also determine the compression quality in the
           ZIP tab between a scale of 1 to 9 where 1 creates the
           ZIP file the fastest and 9 creates the tightest ZIP
           file.  A value of 0 will store a file into the ZIP
           file but will not be compressed.

       UnZIP

         Folder:

           The Folder option allows you to choose where all
           extracted files will be created by the ZIP manager.
           Just tap on the Folder button to navigate to the path
           you want the folder to be designated.

         Unzip with path:

           When checked, the ZIP manager will re-create the sub-
           folder path that is stored in the ZIP archive into the
           extract folder when extracting.

         Unzip overwrite:

           This allows you to configure the action that the ZIP
           manager takes should the file already exist in the
           extract folder when the ZIP manager is extracting.
           The valid options are:

           Skip if file exist - Will skip the extracting file if
                                the file already exist in the
                                extract folder.

           Always overwrite   - Will always overwrite the file
                                in the extract folder with the
                                file being extracted from the
                                ZIP archive.

           Overwrite if newer - Will compare the dates of the two
                                and overwrite the existing file
                                if the file in the archive is
                                newer.

           Interactive        - Will prompt the user for the next
                                course of action when the file
                                already exists in the extract
                                folder.

-----------------------------------------------------------------
###   Utilities Explained
-----------------------------------------------------------------

    -------------------------------------------------------------
1.  Fix applist
    -------------------------------------------------------------

    This option fixes a bug in the Sony Ericsson P800 UIQ device.
    Under certain conditions, you will find the application list
    disappears.  Previously, the only way to get the list back is
    to restart the P800. If you select this option in SMan, SMan
    will fix this without the need to restart your P800.


    -------------------------------------------------------------
2.  Compress contacts
    -------------------------------------------------------------

    This tells your UIQ device to compress the Contacts
    application's database and clean it up making it smaller and
    faster to access.


    -------------------------------------------------------------
3.  Fix synch timezone
    -------------------------------------------------------------

    This option deletes the Daylight.ini and GmtOffset.ini files
    from the Sony Ericsson P800 and P900 devices. Doing this
    allows you to synchronize your UIQ device with the PCSuite
    software provided by Sony Ericsson and allows the device to
    re-synch all calendar entries with the current time zone.
    Very useful for roaming users.


    -------------------------------------------------------------
4.  Set system font
    -------------------------------------------------------------

    This basically allows you to change the font the Symbian OS
    uses.  You can also change the size of the font to suite your
    needs.  This can be very handy to the visually handicap.

    To make use of readily available TrueType (.TTF) fonts and
    expand your library of type faces you can use on your UIQ
    device, you will need to install the "freetype.sis" installer
    also packaged in this SMan package.  You then simply add the
    TTF files into the \system\fonts folder, restart the UIQ
    device so that the fonts are registered in the OS, then use
    this option to set the font and the size.  You can also use
    the anti-alias feature found in most TrueType fonts.
 
    The reset feature puts the UIQ device into the factory
    default state.

    This option requires a restart of your UIQ device.

    Note: For non-english speaking users, you can also install
          a local language font.  With the chinese language font,
          the font usually comes with a set of roman letters in
          them already so your menus should not be affected.
          The plus effect of that is you can now receive
          Chinese SMSes and they will display correctly on your
          screen.


    -------------------------------------------------------------
5.  Old skool
    -------------------------------------------------------------

    This option makes your Sony Ericsson P9x0 look like a P800.
    The reason for doing this is so that your P9x0 will use a
    bare minimum theme which results in it looking very much like
    a P800.  This results in your P9x0 reclaiming back as much as
    2048K (depending on which theme you use) of free ram.  Also,
    all menus will run faster.  You can undo this by reinstalling
    your favorite themes into you P9x0.  

    -------------------------------------------------------------
6.  View picture SMS
    -------------------------------------------------------------

    SMan will go through all the messages in your SMS Inbox and
    list out all the messages found to be encoded using the
    Nokia Smart Messaging protocol.  Simply high lighting the
    SMS entry will cause SMan to decode the message.

    -------------------------------------------------------------
7.  Notifications
    -------------------------------------------------------------

    This feature allows SMan to alert you of the following:

    a.  Incomming SMS
        Will notify you when you have an unread SMS in your
        inbox.

    b.  Missed calls
        Will notify you when you have a missed call.

    c.  No network
        Will notify you when you UIQ device is outside the
        coverage of your service provider or if you are in a
        location where there is no signal from your operator.

    This option is useful when you have left your UIQ device
    unattended or are in a noisy environment and cannot hear the
    normal alerts.  This alerts that SMan provide are by using
    the alarm notification but allows you to use either the
    pre-configured alarm alerts or specify your own sounds for
    the respective alerts.  It will also follow the vibrate rule
    set by the alarm settings in your UIQ device.


    ----------------
    The General tab
    ----------------

    Queue alarms

      This option when checked allows multiple notifications.
      When unchecked, if a notification alert is triggered and
      SMan finds that there is already an SMan alarm in the
      alarm queue, will not add additional alarms until the
      current alarm is cleared.


    Group alarm

      This option puts together all similar events into one 
      alarm.  For example, if you have a few missed calls, they 
      will be considered only one missed call and sets the alarm 
      to indicate to you only one missed call alert instead of a 
      few missed call alerts.


    Flip toggle

      For Sony Ericsson UIQ devices, there is an option to
      enable/disable this feature depending on the flip status of
      your device.


    -------------------------------------------------------------
8.  Fix app order
    -------------------------------------------------------------

    This solves the problem when the Sony Ericsson P800 applist
    gets sorted into alphabetical order and the reserved P800
    apps gets mixed up with other user applications. This can
    also be used to backup your application list order before
    you try changing it.  You can then restore the changes if
    you do not like your changes.

    You have three (3) option of recovery, they are:

    Reset   - This causes SMan to reset the application list
              into it's factory default settings.  All user
              installed applications will be in the "Unfiled"
              folder.

    Backup  - The option tells SMan to backup the existing
              application list.  Should something happen to your
              application list, a simple restore will get it back
              exactly the way it was when you called the "Backup"
              option.  Again, the applications installed after
              that backup will be in the "Unfiled" folder.

    Restore - This restores the application list done from
              the above "Backup" command.

              Note: The "Restore" command will only work if you
                    have done a backup with the "Backup" command.


    -------------------------------------------------------------
9.  Autostart
    -------------------------------------------------------------

    Autostart gives you the option to start SMan automatically
    when you switch on your phone.  The "Others" option gives
    you the option to start other applications besides SMan.

    You can also change the order of startup between applications
    and configure how many seconds of delay between applications.
    This would enable each application to load itself into memory 
    and allocate RAM in a contiguous way before the next 
    application loads. SMan autostarts the applications in the
    order you specify and will only move on to the next autostart
    application after the previous one has been launched
    (including waiting for the delay to expire).

    The threshold counter configures SMan to only start processing
    autostart applications 60 (default value) seconds after
    the device has started up.  This prevents the application 
    from launching applications should SMan be installed in an
    external media (and the media is removed and reinserted a
    short time after the device has started).

    The startup module is intentionally installed in drive D:.
    This allows you to disable the startup application feature of
    SMan.  To do this, remove your memory stick and restart your
    P800.  Very handy when the application you wanted to auto
    startup misbehaves and hangs your phone.

    On Motorola UIQ devices, this can only be installed in
    drive C: to work.  You will lose the safeguard mechanism of
    having it in drive D: and removing it should an application
    misbehave during startup. You will need to bring it to a
    service for reflashing to fix this problem.  However, this
    has been tested with SMan and it runs correctly at startup.

    A big warning message will appear before activating this
    option on a Motorola UIQ device.


-----------------------------------------------------------------
###   Things to note about SMan
-----------------------------------------------------------------

1.  The autostart feature in Motorola A92x models must be
    installed in drive C: unlike other UIQ devices.  The
    consequence of this is that should an application you try to
    autostart misbehaves and causes the device to hang, you
    can not use the "remove memory card" trick and restart your
    device on a Motorola unit.

2.  When editing the .CSV files outside of SMan, make sure you 
    use the text qualifier on the .CSV file when saving.  (ie.
    each comma seperated infomation must be quoted or the import
    into SMan will fail.


-----------------------------------------------------------------
###   Upgrading
-----------------------------------------------------------------

    =============================================================
    Keeping your old config when upgrading to SMan v1.4
    =============================================================

    Installing SMan v1.4 will result in you having to configure 
    all your settings again.  However, we have made it such that
    future versions of SMan should be able to use the previous 
    configuration files starting from SMan v1.4.  


    =============================================================
    Problems installing new SMan or uninstalling older version
    =============================================================

    If you get the error message "in use" when trying to
    uninstall or upgrade SMan, please do the following:


    To upgrade to latest version of SMan
    ====================================

    You can use the built-in file manager in SMan or install
    Symbian's qfileman application to do this.

    1.  Go to the folder "x:\system\install" (where x: is the
        drive letter you installed SMan in).
    2.  Delete the "sman*.sis" file found there.  This could vary
        from "sman12.sis" to "sman12c-dut.sis" depeding on the
        version and language installed.
    3.  Install the latest version of SMan like you normally do
        with any applications into your UIQ device.


    To uninstall SMan from your UIQ device
    ======================================

    You must Install Symbian's qfileman application to do this.

    1.  Go to the folder "x:\system\install" (where x: is the
        drive letter you installed SMan in).
    2.  Delete the "sman*.sis" file found there.  This could vary
        from "sman12.sis" to "sman12c-dut.sis" depeding on the
        version and language installed.
    3.  Go to the folder "x:\system\apps" and delete the folder
        "SMan" and all it's contents.
    4.  Delete the file "SMan.boot" in "c:\"
    5.  Delete the file "SManRecog.mdl" from either
        "c:\system\recogs" or "d:\system\recogs" folder.  Check
        both locations.


-----------------------------------------------------------------
###   Talk to us
-----------------------------------------------------------------

    If you have any ideas or suggestions for SMan, please don't
    hesitate to contact us via e-mail.  We will do our best to
    try and reply to every e-mail.

    If you have any questions, I strongly suggest you go to these
    websites.  We regularly participate in their forums.

    http://www.my-symbian.com

    http://www.esato.com

    http://www.secentral.net

    http://www.i-symbian.com

    http://www.se-nse.com


-----------------------------------------------------------------
###   The End
-----------------------------------------------------------------

    Thank you for reading the SMan manual.