Spell out on first occurrence.
For guidelines on how to use instance as well as object, see the Taligent Publications Handbook. See also "class" on page 12 and "object" on page 55.
NOTE
i.e.
Avoid using Latin terms or abbreviations. Use that is or rephrase your sentence. IEEE
When the context is clear, use the acronym because it is more commonly recognized than Institute of Electrical and Electronics Engineers. illegal
Use when discussing syntax violation, otherwise use not allowed or not permitted. imperative
Use the imperative form of the verb for instructions and procedures whenever the reader is the agent of the action. Without the imperative, you leave the performer of the action out of the picture:
The system should be backed up.
Overusing you can be unnecessarily wordy:
You now back up the system.
Instead, use the imperative:
Back up the system now.
inch (in.)
Abbreviate units of measure when using them with a number to indicate a specific measurement. Spell out the word in running text, or use a period after the abbreviation (in.). inherit
Do not use this term. Instead, use derive. ISV
When the context is clear, use the abbreviation because it is more commonly recognized than independent software vendor. indexes
Plural of index. Do not use indices. infinite
Do not use this term. Use the actual number or specify a large range, such as more than 1,000,000. inline
(modifier) input
(modifier, noun) Do not use as a verb.
Rather than: Input the information into the database.
Write: Type the information into the database.
input/output (I/O)
Spell out on first occurrence. inquire
Use inquire or ask instead of enquire. inquiry
Use this term instead of enquiry. instance
An instance is a data structure created to the specification of a class. In most cases, instance is synonymous with object. insure
Only use to describe what an insurance company does. Do not confuse with "assure" on page 5 and "ensure" on page 23 interface
(modifier, noun) Do not use as a verb. International Standards Organization (ISO)
Use the abbreviation when the context is clear. Internet
When capitalized, the term refers to the system of networks and gateways that use the Transmission Control Protocol/Interface Program(TCP/IP) suite of protocols. internet
When lowercase, the term refers to a set of networks joined together by gateways, functioning as a single network. For AppleTalk, an internet is a set of AppleTalk networks linked together. interprocess communications (IPC)
Spell out on first occurrence. irrecoverable error
Use this term instead of catastrophic error. italic
Use italics to indicate:
Do not use italics to identify letters, words, or phrases to be typed onscreen. Instead, use a font change. See "computer voice" on page 16 for further information on font changes.
Taligent's Guide to Designing Programs reflects years of experience building large, object-oriented C++ systems that incorporate advanced programming techniques and industry innovations.
To raise an exception flag is to set the corresponding exception bit in the current environment.
indexes (not indices)
In the CommonPoint application system, you can document components into a compound document to provide functionality that goes beyond what has typically been provided by a single large application.
Add apostrophe s.
Copy filename to newdirectory.
Italicize all punctuation that immediately follows an italicized word.
[Contents]
[Previous]
[Next]
Click the icon to mail questions or corrections about this material to Taligent personnel.
Generated with WebMaker