BSBingoTM BYOBingoTM Num-NumTM Triangle Puzzle ThisIsCoolTM Nim Save That Calendar!TM GCC/GCJ for MingW Waba For DOS TinyBasic

Num-NumTM Help

v1.00P: PalmOS

Welcome to Num-NumTM! Click here for Terms of Use.

Please choose from the help topics below:

Introduction
Overview
Quick Start
Installing/Uninstalling
Adding and Removing Languages
Terms of Use
Credits
About the Author

Introduction

Thank you for choosing Num-NumTM, the fun, free, educational, extensible number spelling program! With versions available for Windows (95/98/NT/2000), Windows CE, PalmOS and also Linux, MacOS, etc. (Java version)!

Be sure to visit http://www.num-num.com/ for tips, tricks and updates.

This documentation is for the PalmOS® version.

International users: for a translation of these instructions in your language, go to http://babelfish.yahoo.com/ and enter the URL http://www.num-num.com/Num-NumPalm.htm.

Usage of this program indicates your acceptance of the Terms of Use. If you do not agree with these terms, exit the program immediately and uninstall it.

Main Contents
Overview

Overview

Num-NumTM helps you count and spell numbers in a foreign language. You can use it when you write checks or to practice counting. The rules for spelling a number are external to this program; one can therefore easily add support for additional languages.

Num-NumTM lets you enter the number you want to spell. You can also step sequentially through a series of numbers (one, two, three...) so you can learn how to count. Num-Num can spell numbers in a variety of formats (cardinal, money, year or ordinal).

Main Contents
Quick Start

Quick Start

Simple Operation

Enter the number you wish to spell and press [Convert]. You can select another language or another output format. Press the [/\] and [\/] buttons to go to the next or previous number. You can also use the [Page Up] and [Page Down] key on your Palm.

More Details

The maximum range is -999999999999.99 to 999999999999.99. Fractional numbers are not allowed for dates and cardinal numbers. Do not use thousands separators (type 10000, not 10,000 or 10.000). The Money format does not always reflect the colloquial usage, but should be a reasonable approximation.

Terminology

A cardinal number is a normal number (one, two, three), whereas an ordinal number indicates order (first, second, third). A distinct format is needed for years because numbers like 1967 are spoken differently as a cardinal number ("one thousand nine hundred sixty seven") than a year ("nineteen sixty seven").

Advanced

The rules for spelling a number are external to this program; one can therefore easily add support for additional languages.

Main Contents
Installing/Uninstalling

Installing/Uninstalling

Installing the Program

If you haven't already done so, download Num-NumP.zip from http://www.num-num.com/ and unzip it into an empty directory.

Install Num-Num.prc to your Palm as you would any .prc file. If you do only this, then English (US) is the sole entry in the Language list.

Installing the Additional Languages

Num-Num ships with rules for French, Italian, Spanish, German and Dutch. Each rule list is simply a memo in Memo Pad. To add these languages, we need to import these five into memos to Memo Pad.

If you use Palm Desktop, do the following. (These instructions are based on Palm Desktop 3.0.1.)

  • start Palm Desktop (Palm Desktop runs on your desktop computer, not your Palm.)
  • press the [Memo] button on the lefthand side
  • drop down the category drop list on the upper-righthand side of the memos list, and choose Edit Categories...
  • in the Edit Memo Categories box that appears, choose [New...]
  • in the New Category box, type Num-Num and press [OK]
  • press [OK] to close the Edit Memo Categories box
  • from the File main menu, choose Import...
  • navigate to Num-NumL.mpa and open it. You should see a confirmation dialog to the effect that you have successfully imported five records
  • verify that the Num-Num category has five memos each starting with /@-CheckMate:
  • close Palm Desktop and perform a HotSync to beam these new memos to your Palm

If you do not use Palm Desktop (example: pilot-xfer under Linux), unzip the contents of Num-NumL.zip and somehow transfer the contents of each text file to memo pad, preferably under the category Num-Num (to avoid cluttering up another category).

Uninstalling

To uninstall Num-Num, delete it in the Application Manager and also delete any memos associated with language rules in Memo Pad.

Main Contents
Adding and Removing Languages

Adding and Removing Languages

Overview

The rules that Num-Num uses to spell a number are external to the program. Each language is simply a memo in Memo Pad. This means that you can add rules for additional languages and also remove rules. This section assumes you are familiar with basic Memo Pad operations.

Removing a Language

To remove a language:

  • exit Num-Num
  • run Memo Pad
  • go to the Num-Num category
  • delete the memo corresponding to the language to remove
  • exit Memo Pad and restart Num-Num

Adding a Language

To download and install a new language:

  1. Go to http://www.num-num.com/Num-NumP.htm
  2. Scroll to the bottom of the page, where you will see a list with all available languages.
  3. Right-click on the name of the language you want to add (the lefthand column, for example: English) and choose Save Target As... (or Save Link As...).
  4. Save the language file to a folder (i.e. c:\downloads)

What you do next depends on whether you use Palm Desktop or not.

Palm Desktop

  1. start Palm Desktop
  2. press the [Memo] button on the lefthand side
  3. drop down the category drop list on the upper-righthand side of the memos list, and choose Num-Num
  4. from the File main menu, choose Import...
  5. in the Files of type drop list, select Text (*.txt)
  6. in the File name edit box, type *.yn and press [Enter]
  7. navigate to your downloaded file and open it
  8. in the Specify Import Fields box, press [OK]
  9. verify that the new memo is added to the existing list
  10. close Palm Desktop and perform a HotSync to beam this new memo to your Palm
  11. restart Num-Num

No Palm Desktop

  1. somehow get your downloaded file into your Palm's Memo Pad as described above
  2. restart Num-Num

Developing Your Own Rules

Are you a hacker interested in creating rules for a new language? Then visit http://www.num-num.com/Num-NumDevl.htm to find out how.

Main Contents

Terms of Use

Num-NumTM Copyright © 2000 by Mohan Embar. All Rights Reserved.

Num-Num is a trademark of Mohan Embar, Inc.

Usage of this program indicates your acceptance of the following license conditions. If you do not agree with these terms, exit the program immediately and uninstall it.

This program comes with no warranties, either express or implied. In no event will the copyright holder be liable from any damages resulting from the use of this software.

This program is PropagandaWare. If you continue using this program seven days after the first use, you agree to visit the following websites:

www.mcspotlight.org
www.peta.org
www.veganvillage.co.uk/vv/vegfam
www.animalsong.org

You are exempt from this agreement if you do not have Internet access.

Permission is granted to any individual or institution to copy or redistribute this software provided that:

  • it is not altered in any way
  • it is not sold for profit
  • this copyright notice is displayed
  • if made available for download on a non-FTP web page, that a link be made to www.num-num.com whenever possible

Developed in C++ using CodeWarrior® for PalmOS R6.

Main Contents

Credits

Thanks to:

  • my Dutch wife, Wanda, for putting up with me and accidentally giving me the idea for this program, and
  • my daughter, for lighting up my life and forcing me to make each precious minute count,
Main Contents

About the Author

Mohan Embar is one of those rare finds that has both outstanding technical and communications skills. Both an excellent mentor and developer, he has worked in a wide variety of projects, such as object-oriented billing systems, servlet frameworks and low-level UNIX printer drivers. He has both domestic and international experience with companies such as Nortwestern Mutual Life, Deluxe Data Systems, France Telecom, Société Générale, Cyco Software, and Kraft, Inc. He is fluent in English, French and Dutch and has a working knowledge of German, Spanish and Italian.

Mohan is also bilingual in C++ and Java and loves switching back and forth between the two languages, while making full use of the idioms of both. Visit the Cool Demos section at http://www.thisiscool.com/coolprogs.htm to see more cool programs written in C++, Java and other languages like Delphi and JavaScript.

Mohan Embar singlehandedly:

  • invented the number transformation language
  • wrote the Java and C++ (PalmOS, WinCE, Win32) versions of Num-Num
  • wrote the English, French, German, Spanish, Italian, German and Dutch rules
  • authored the accompanying documentation and online help.

Is it creative and well-programmed? Is the documentation nicely written? Check out his other demos, download the source code and scrutinize it. If you like his work, you can try to hire his services if he's available. Click here to contact Mohan. (Contract positions only: no full-time positions, headhunters or consulting firms, please.)

Main Contents