Resources

Table of Contents

A. Preferred Terminology

This appendix gives selected terms, their meaning, and preferred spelling and alternatives, if applicable.

Occasionally, The Open Group Forums and Work Groups may prefer to use an alternative term. This should be agreed in consultation with The Open Group editors.

The Open Group documentation is likely to be translated. Remember to convey important distinctions by using the right term.

API

Application Program Interface.

above

Do not use to refer to another location in a document.

alphanumeric

When used as a modifier.

and/or

Avoid using this term. Rewrite the sentence, or use the two options, followed by "or both".

appendices

Do not use appendixes.

ArchiMate

Note capitalization. Usage needs to follow The Open Group trademark usage guidelines.

argument

Value provided to a function or utility (such as the value of a parameter, operand, or option-argument).

async

Use asynchronous.

Boolean

Note capitalization.

back up

When used as a verb.

backslash

When used as a modifier or noun.

backspace

When used as a modifier, noun, or verb.

backup

When used as a modifier or noun.

behavior

Do not use "behaviour".

below

Do not use to refer to another location in a document.

big-endian

When used as a modifier.

built-in

When used as a modifier.

built-in utility

Special utility implemented within the shell. Also see shell.

C language

When used as a noun.

C-language

When used as a modifier.

can

The term can describes a permissible optional feature or behavior available to the user or application. The feature or behavior is mandatory for an implementation that conforms to the specification. An application can rely on the existence of the feature or behavior.

cannot

One word.

cf

Expand to compare.

client-server

When used as a modifier.

cloud-native

When used as an adjective.

codeset

When used as a modifier or noun.

commands

Call to the shell to perform a specific task. A string entered on the command line or in a script. Contrast with utility which is the name of an executable.

command-line

When used as a modifier.

cross-reference

When used as a noun.

data

Use as a singular noun. Do not use datum.

data type

When used as a noun.

database

When used as a modifier or noun.

default

Value or behavior provided by the system.

Digital Transformation

Note capitalization.

directory name

When used as a noun.

display

Use the verb display rather than appear. For example, "The prompt is displayed on the screen". Avoid using displays without an object. For example, "The system response displays on the screen". (Use of the noun appearance is acceptable.)

e.g.,

May be expanded to "for example," (note the addition of a comma).

et al

May be expanded to "and others".

email

When used as a modifier or noun.

end user

Person using a system feature.

end-user

When used as a modifier.

enter

To submit input to the system. Also see type.

Do not use enter to indicate the startup of an application.

Enterprise Architecture

Note capitalization.

etc.

May be expanded to "and so on".

execute

To run a command using the current execution environment. Also see invoke.

FIFO

First in, first out.

FILO

First in, last out.

fewer

Use to refer to countable items; for example, "you will find fewer errors ...".

filename

When used as a noun, variable in syntax, or examples.

file sharing

When used as a noun.

file-sharing

When used as a modifier.

file system

When used as a noun.

fixed length

When used as a noun.

fixed-length

When used as a modifier.

floating point

When used as a noun.

floating-point

When used as a modifier.

general-purpose

When used as a modifier.

I/O

Input/output.

i.e.,

May be expanded to "that is," (note the addition of a comma).

implementation

Refers to the way a function or utility works on a particular operating system.

implementation-dependent

(Same meaning as implementation-defined.) Describes a value or behavior that is not defined by the definitions contained in the specification but is selected by an implementor. The value or behavior may vary among implementations that conform to the definitions contained in the specification. An application should not rely on the existence of the value or behavior. An application that relies on such a value or behavior is not portable across conforming implementations.

The implementor normally documents such a value or behavior so that it can be used correctly by an application.

invoke

Run a command with suppression of searching for shell functions and special built-in utilities.

initialize

Not "initialise".

in-line

When used as a modifier.

input

Use as a noun only, not as a verb.

interface

When used as a modifier or noun, not as a verb.

interprocess

When used as a modifier or noun.

keyboard

When used as a modifier or noun.

left-justified

When used as a modifier.

legacy

Describes a feature or behavior that is being retained for compatibility with older applications, but which has limitations which make it inappropriate for developing portable applications. New applications should use alternative means of obtaining equivalent functionality.

less

Use to refer to non-countable items or when discussing something in terms of size or degree; for example, this is less complicated".

log in

When used as a verb.

login

When used as a modifier or noun.

log out

When used as a verb.

logout

When used as a modifier or noun.

long-term

When used as a modifier or noun.

loosely-coupled

When used as an adjective.

lowercase

When used as a modifier or noun.

may

Describes a feature or behavior that is optional for an implementation that conforms to the definitions contained in the specification. An application should not rely on the existence of the feature or behavior. An application that relies on such a feature or behavior is not portable across conforming implementations.

To avoid ambiguity, the opposite of may is expressed as need not, instead of may not.

media

Use as a singular noun.

mouse

Use to refer to any pointing device, screen button, or menu operation. (Remember to define this usage.)

multitasking

When used as a modifier.

multiuser

When used as a modifier.

must

Same meaning as shall; shall is the preferred term.

NaN

Not a number.

need not

The negative of may. Used in preference to may not to avoid ambiguity.

newline

When used as a modifier or noun.

next-generation

When used as an adjective.

nonzero

When used as a modifier or noun.

OR

Do not use as a verb. For example, instead of saying "OR-ing the bits" say "a logical bitwise OR of the bits".

obsolescent

Describes a feature that may be considered for withdrawal in a future version of the specification. Such features are retained because of their widespread use, but are not recommended for new applications. Vendors may continue to support such features, even after they are withdrawn from the standard.

offline

When used as a modifier.

online

When used as a modifier.

open systems

Use generically. If you need to specify the subset of open systems that are based on the UNIX operating system, write: "UNIX operating systems and their derivatives".

option

Argument to a command that (typically) changes the default behavior of the command.

option-argument

Argument to an option.

output

When used as a noun only, not as a verb.

path name

When used as a noun.

pathname

When used as a variable in syntax examples.

path-name

When used as a modifier.

postprocessor

preprocessor

press

Used to indicate the action of pressing a key that does not echo to the screen; the Control key is one such example.

previous

Do not use to refer to another location by position.

read-only

When used as a modifier.

realtime

When used as a modifier or noun.

reentrant

When used as a modifier.

reference page

Use instead of manpage, manual page, and so on.

runtime

When used as a modifier or noun.

screen object

Anything that appears on a screen; for example, box, menu, icon, and so on. Do not use the names of screen objects as verbs.

select

Use this verb to designate information that will be the subject of a subsequent operation.

set up

When used as a verb.

set-up

When used as a modifier.

setup

When used as a noun.

shall

Describes a feature or behavior that is mandatory for an implementation that conforms to the definitions contained in the specification. An application can rely on the existence of the feature or behavior.

shell, the

Change to "the shell as documented in the sh() reference page" when referring to the default shell provided by systems that conform to the Single UNIX Specification.

short-term

When used as a modifier or noun.

should

For an implementation that conforms to the definitions contained in the specification, describes a feature or behavior that is recommended but optional. An application should not rely on the existence of the feature or behavior. An application that relies on such a feature or behavior is not portable across conforming implementations.

For an application, describes a feature or behavior that is recommended programming practice for maximum portability.

shut down

When used as a verb.

shutdown

When used as a modifier.

start-up

When used as a modifier.

startup

When used as a noun.

subdirectory

When used as a noun.

text-only

When used as a modifier.

that

When used as a restrictive pronoun. For example, "... the subset of open systems that are based on ...".

time out

When used as a verb.

time zone

When used as a noun.

timeout

When used as a noun.

TOGAF

Note capitalization. Usage needs to follow The Open Group trademark usage guidelines.

type

Used to indicate the entering of information. For example, "Type the following command".

UNIX

Note capitalization. Usage needs to follow The Open Group trademark usage guidelines.

undefined

Describes the nature of a value or behavior not defined by the definitions contained in the specification which will result from use of an invalid program construct or invalid data input.

The value or behavior may vary among implementations that conform to the definitions contained in the specification. An application should not rely on the existence or validity of the value or behavior. An application that relies on any particular value or behavior is not portable across conforming implementations.

unspecified

Describes the nature of a value or behavior not specified by the definitions contained in the specification which will result from use of a valid program construct or valid data input.

The value or behavior may vary among implementations that conform to the definitions contained in the specification. An application should not rely on the existence or validity of the value or behavior. An application that relies on any particular value or behavior is not portable across conforming implementations.

uppercase

When used as a modifier or noun.

US

United States.

use-case

user ID

When used as a noun.

user name

utility

Executable file that can be called by name from a shell (not including built-in utilities). See also command.

versus

Use Italic font.

via

May be changed to "through" or "by means of".

vice versa

Use Italic font.

virtual machine

Not VM.

viz

Expand to "namely".

when

Use if an event is inevitable. Do not use to mean in contrast/comparison to.

where

Do not use to mean in contrast/comparison to.

which

When used as a non-restrictive pronoun, and preceded with a comma. For example, "... The Open Group Guide, which contains ...".

while

Do not use to mean in contrast/comparison to.

will

Same meaning as shall; shall is the preferred term.

windows

Use the verbs open and close to refer to windows.

worldwide

When used as a modifier.

write-only

When used as a modifier.

zeros

Not zeroes.


return to top of page