|Syntax and mark-up / Phrases|
DITA has four elements for marking up system messages, error messages, and other output from a computer system, or equipment user interface.
Whether it is through a software application, a machine instrument panel, or a consumer electronic device display, information is commonly displayed to the user through some sort of user interface. In some cases the information takes the form of lights, gauges, and dials, in other cases the information is audible, and in other cases it is textual or graphical. When describing these messages from the equipment in DITA, a number of semantic elements are used.
Error messages are usually made up of a msgnum element (the error code) and a msgph or msgblock element. Likewise, status messages are best described with msgph or msgblock. The result displayed on a calculator after a user has entered an equation is best described with a systemoutput element.
The distinction between a message and system output is that the message is something produced by the system or device as part of its function, while a system output is something that the system returns as a direct result of something that the user inputs. Another way of putting it is that the systemoutput is used in conjunction with userinput to describe a "conversation" between the user and the system.