Qtopia Home - Classes - Hierachy - Annotated - Functions - Qt Embedded

Qtopia Style Guide: Naming

Application naming

Application names should be based on established application names used in the current phone market. They should be nouns and obvious to a user from any background.

Note: An application's title should be the same as its launcher name.

Naming conventions

All words should start with a capital letter with the exception of words that are usually excluded from acronyms such as "of", "and", or "to". These extremely common words are referred to as stop words.

Once a certain name is used for a specific item it should be re-used in each and every application. For example: if Contacts and Calendar both have a "company" info field they should use the same label. This means both applications use either "Company", "Cmpny", or "Comp.". Please see the used label names table for reference.

Class Names

Class names start with capital letters, variables start with lower case letters. When a variable has multiple words, the following words start with capitals,

eg:

int myExampleVariable;

MyExampleClass exampleObject;

Abbreviations

The rules listed below should be followed when using abbreviations:

NOTE: No abbreviation point is required if the last letter of the word is displayed such as "cmpny".

Acronyms

Acronyms basically follow the same set of rules as those found in the abbreviations section. Always check existing acronyms before creating a new one.

Using the "..." label

The following rules define the use of the ... in association with menu items.

Examples of when to use "..."

Use ... only when the menu is followed by another dialog that is a direct and integral continuation of the command.

Examples of when not to use "..."

Do not use "..." when the menu is followed by another dialog that is related to but not a continuation of the command.

Currently used label names

PDA Label Phone Label
Categories Category
Time zone T.Z.
Anniversary Anniv.


Copyright © 2001-2005 Trolltech Trademarks
Qtopia version 2.1.1