Login Status


ShareSource Site » Projects » iouyom » iouyomWiki

Project: I owe U, You Owe Me [Wiki]

(*) Summary   [^] Files   [^] Screenshots   [_] Wiki   [!] Bug Tracker  
(») Mercurial Repository  
Project Wiki (Page: Manual)
Last Changed 6 months ago, by Bernhard

Manual

Main Screen

The Main screen consists of a list of items somebody owes you or you owe someone.
The Format is "<Amount>* <Category>: *<Who Owes Whom>"

  • Items or Money that is owed you is marked with a blue icon and/or the
  • text "Someone>OM"
  • Thinks that you owe is marked with a red icon and/or the text
  • "IO<Someone" Default Action is to edit a selected entry. Pressing c deletes a selected entry and * creates a new one. Use the Yes|Take-Call Button to display a small InfoPopup for the selected Entry. Items are sorted by date and time, newest first.

Tabs

Switching between the tabs is one way to filter the displayed items. There are 3 tabs:

  • Display All Items
  • Display only Items I Owe Someone
  • Display only Items Someone Owes Me

The Menu and Quick Access

Available Menu Entries and their Functions:

  • New see Creating a New Entry
  • Edit see above
  • Delete you know...
  • Select View Gives you the option to changes the style of the list
  • Filter See Filtering Displayed Entries
  • Delete All Off Does exactly that. Use this to to delete categories or
  • persons that clobber your lists
  • ShowInfoPopup Display small Popup for Selected Entry
  • About Display Author, License and Date

Available Keys

Key Function
1 Switch to Single Line List
2 Switch to Double Line List
3 Switch to Double Line List w/ Icon (useful on E90)
4 Switch to Portrait Mode
5 Switch to Landscape Mode
c Delete Selected Entry
Yes/Take-Call Show Info Popup for Selected Entry
* Create New Entry

Item-Balance and Application-Title

The Application Title offers three pieces of information

  • A Balance (in Brackets) of all currently displayed items. Things that you
  • will get back (aka incoming things) add to the sum, while things (or money)
  • that you need to give back (aka outgoing stuff) are subtracted from the sum.
  • The active Category-Filter or No Filter
  • The active Person-Filter or No Filter

Orientation

If you have an N95 or similar, the orientation should change automatically, depending on how you hold your cellphone. Note the "should" however, since this is an untested feature

Creating a New Entry

Just select New From the Menu. Note that the main Information about what you lent or borrowed is in the amount and the category of things
e.g.:

  • "10 Euros"
  • "1 CD"
  • etc

While the description and the date are just there to clarify things. If you want to add a new category or person, just select New Person or New Category in the person- or category-field.

Note

that when the amount is > 1, an "s" is automatically added to the category in the main view. So you should always use the singular when creating new categories.

Filtering Displayed Entries

You can filter by the following 3 attributes and in any combination

  • By Person
  • By Category
  • By Description
  • By Direction (in/out) For the first two, just select the appropriate Filter from the Menu. For the last, just go to the tab you want.

The entries marked (filtered list) only show those Categories or Persons for which Filtering would not result in an Emty List.

Filter by Description

Basically this allows you to search for a substring in all Descriptions. Unfortunately it is currently not possible to make the search case-insensitive. If you reuse the menu-entry with a description filter set, you will be asked if you want to disable it, instead of changing it.

Example

You are on Tab "Owe Me" and have an active Person Filter for Person X. Person X owes you stuff in Category A and B. If you select Filter by Categories (filtered list), only the Categories A and B will be available for selection.

Note

Creating a new entry while a filter is active will preselect the selected person, category or direction.

Date and Time

As of Version 1.3.0, great care is taken, to always display the date and time as you entered it. The rational behind this is, that even if you go to Buenos Aires you will still be more likely to want to know the time of day as it was when you lent/borrowed something in Vienna, rather than what time of night it is in Vienna if you are in Buenos Aires and would lent/borrow something at the same time right now.

Why doesn't that happen out of the Box ?

Because PythonS60's Date Dialogs don't return the number of seconds to 00:00 on the entered date, but the number of seconds in Greenwich to 00:00 on the local cellphone timezone