Active GUI element

Static GUI element

Code

WPS object

File/Path

Command line

Entry-field content

[Key combination]

more

Articles published in the VOICE Newsletter use the following markup:

Inside paragraphs ("inline elements")

"This was the first time a computer was used for such calculations."

A newly introduced term that is used for the first time in the article, terms in foreign languages, slightly emphasized things.

"Do not format your drive unless you have a working backup."

A strong emphasis, e.g., for a warning.

V.O.I.C.E

An acronym or abbreviation. If you move the mouse pointer over the acronym, an explaination is displayed.

You have selected to delete the file test.zip. Continue? or To be or not to be?

A quote from real persons or books, or program messages.

Hamlet

The source of a quote. This could tell you whom the "To be or not to be?" quote from above originated from.

Browse or File > New

Active GUI elements, which cause some action to occur when clicked: menu items, push buttons, checkboxes, radio buttons, lists, combo boxes.

A ">" seperates elements that have to be selected consecutively. In the above example, this would mean that you first have to select the menu item "File" and then "New."

Shutdown

Static GUI elements, which are used for information purposes: window and dialog titles, group names. Groups are borders, usually surrounding several associated active GUI elements.

Templates or Local System > System Setup > Mouse

Workplace Shell desktop objects, both abstract and with a file system pendant.

A ">" seperates such elements that have to be selected consecutively. In the above example, this would mean that you first have to open the "Local System" folder object, then the "System Setup" folder, and then the "Mouse" object.

CONFIG.SYS, OS2\INSTALL, or C:\OS2\BOOT\OS2DASD.DMD

The name of a file or folder, or its partial or fully qualified path in the file system.

SysSetObjectData()

Any snippet of program code in a wider sense. E.g., HTML, CSS, REXX, C, Pascal.

[Ctrl-C]

Keyboard input to be entered by the user.

A "-" or "+" between two keys means that they have to be pressed simultaneously. In the above example, you would have to press both the "Ctrl" and "C" keys.

The quick brown fox jumps over the lazy dog.

Text that has to be typed in an entry field.

unzip test.zip -d x:\temp

A command that has to be entered at a command line and executed by pressing the "Enter" key.

unzip: cannot find either test or test.zip.

Output that is displayed by a program at a command line.

directory or filename

A variable, variable name, or program argument. Often used to explain command syntax.

192.168.1.1 or comp.os.os2.bugs

All kinds of addresses.

Paragraph-like elements ("block elements")

Emacs is an extremely feature-rich and extensible editor. However, these qualities have a price: complexity. Many people have surrendered to the steep learning curve that has to be overcome before one can take advantage of all the program's goodies. To help you avoid the same fate, this article describes the installation and customization of the Emacs editor in great detail.

The summary of an article. Usually located directly after the title.

"The VOICE bylaws state:

The name of this organization shall be the "Virtual OS/2 International Consumer Education," hereinafter called VOICE. OS/2 is defined as a computer operating system marketed by IBM. ISV is defined as Independent Software Vendor. SOHO is defined as Small Office/Home Office. OS/2 and IBM are the registered trademarks of the International Business Machines Corporation.

So this organization is about OS/2."

Quotes that extend over several lines.

A box that contains side notes and digressions that don't otherwise fit into the flow of the article.

BUFFERS=100
IOPL=NO
DISKCACHE=512,LW,32
MAXWAIT=1
MEMMAN=SWAP,PROTECT
SWAPPATH=H:\ 10240 92160
BREAK=OFF
THREADS=1024
PRINTMONBUFSIZE=2048,134,134

Generic file content with header.

SOM_Scope BOOL  SOMLINK xctr_xwpMoveWidget(XCenter *somSelf,
                                           ULONG ulIndex2Move,
                                           ULONG ulBeforeIndex)
{
    // XCenterData *somThis = XCenterGetData(somSelf);
    XCenterMethodDebug("XCenter","xctr_xwpMoveWidget");

    return ctrpMoveWidget(somSelf, ulIndex2Move, ulBeforeIndex);
}

Several lines of code.

Several lines that have to be entered into an entry field or similar.

unzip notexist.zip -d x:\
unzip:  cannot find either notexist or notexist.zip.

Input and output at a command line.

An important note.

A warning.

Notes about a larger section of work that has been finished and the consequences thereof.

Things to keep in mind.

Specific characteristics that mark an operation's success. Something that is particularly positive about a piece of software or hardware.

Tables

A table cell

A table cell

A table cell

A non-specific marker for table cells.