www.riscos.com Technical Support:
RISC OS 3.6 introduces facilities for using a message file when outputting text from the help and command keyword table. This is done using a new field in the module header to specify the pathname of the message file, and a new flag in the Help and command keyword table's information word, to indicate the use of the message file.
This makes it easier to internationalise modules.
The list of service calls available in the SWI description obviously refers to RISC OS 3.1, and so is now out of date. For a complete current list, refer to the Numeric index of Service Calls or the Alphabetic index of Service Calls.
This section details changes introduced in RISC OS 3.6.
The module header has a new field added:
|&2C||offset to string||message file pathname (optional)|
The string must be word-aligned and zero-terminated. It gives the pathname of a message file used when outputting text from the help and command keyword table.
The invalid syntax and help fields of the Help and command keyword table still give an offset to a string; this string is either the actual message to output, or a token to be looked up in the message file
The meaning of the invalid syntax and help strings is set by a new flag in the information word.
The invalid syntax and help strings are tokens, to be looked up in the message file given in the module header.
The format of the message file is as follows:
The <text> is output by OS_PrettyPrint - but in this case, rather than using the kernel dictionary, it uses the dictionary in: