MorePalmOS
A development library for developing Palm OS applications

MorePalmOS Documentation

b1.2.0

Introduction

MorePalmOS is a collection of Palm OS functions.

Usage

You can include the sources in whatever way you wish. This document explains three ways: as an Auto-Recompiling Library, as a Library Without Automatic Recompilation, and as sources.

Sources

MorePalmOS is distributed with a Codewarrior project for building a static library. But it is probably better to include the files directly in your source code. The linker will strip the functions that you don't use. This solves a lot of issues, including allowing you to segment if necessary. However, if a new version of MorePalmOS includes new C files you will need to add these files to your project.

To use MorePalmOS's sources directly:

  1. Create a MorePalmOS group in your project.
  2. Drag all of the MorePalmOS sources into this group.
  3. Either drag the MorePalmOS public headers into this group or add the directory to your access paths. (The easiest way to add it to all of your access paths is to add a single header from the directory to the project. Codewarrior will add an access path for it. Then, you can remove the header from your project.)
  4. Either drag the MorePalmOS private headers into this group or add the directory to your path.

Library

If you do not want to use the sources directly, the next best approach is to include the MorePalm.mcp project in your project. This will cause MorePalmOS to be recompiled when necessary. This is a good idea as it will save you from forgetting to rebuild the library after a bug fix.

To use MorePalmOS as a static library with automatic recompilation:

  1. Drag the MorePalmOS.mcp project into your project.
  2. Add it to all Palm OS targets.
  3. Use the Targets tab of the main project window to specify which targets should include which versions of the library.
  4. Go back to the Files tab and move the library files that have been added to your project to where you want them.

Without Automatic Recompilation

As a final option, you can add the MorePalmOS libraries to your project. If you use this approach, each time you change a MorePalmOS source file you will need to rebuild the library. If you do not do so you will be running the old code, even though the debugger will probably show you walking through the new code. This can cost hours of frustration, believe me! For this reason, the other two methods are superior.

To use MorePalmOS as a static library without automatic recompilation:

  1. Open the MorePalmOS.mcp project.
  2. Build all targets (hint: switch to the targets tab and select all, then build).
  3. Close the MorePalmOS.mcp project.
  4. Open your project.
  5. Copy the MorePalmOS libraries into your project and add them to the targets you wish.
  6. Add the MorePalmOS public headers' path to your project.
  7. Add the MorePalmOS private headers' path to your project.

MorePalmOS License

Boost Software License - Version 1.0 - August 17th, 2003

Permission is hereby granted, free of charge, to any person or organization obtaining a copy of the software and accompanying documentation covered by this license (the "Software") to use, reproduce, display, distribute, execute, and transmit the Software, and to prepare derivative works of the Software, and to permit third-parties to whom the Software is furnished to do so, all subject to the following:

The copyright notices in the Software and this entire statement, including the above license grant, this restriction and the following disclaimer, must be included in all copies of the Software, in whole or in part, and all derivative works of the Software, unless such copies or derivative works are solely in the form of machine-executable object code generated by a source language processor.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

SourceForge.net Logo