std-msg-add


Synopsis

(std-msg-add <msg-list>)

Description

API to add custom messages to the run-time translation table.

STD-MSG-ADD provides a way to add user-provided translations to STD-MSG at run-time, for example by using special message files or fixed translations.

Best is to provide strings for all languages actually in *STD:LOCALIZED-MESSAGES*, in exactly the same order as (car *STD:LOCALIZED-MESSAGES*), which is currently:

(:ENGLISH :GERMAN :RUSSIAN :JAPANESE :CZECH).

But you are not limited to this order, except A2000 for now, see the warning below.

Empty translations (nil) will be untranslated by STD-MSG => :ENGLISH

Warning

This doesn't work in A2000 yet, if you don't use the exact order as defined above.

There we use a especially optimized string table format, based on safearrays.

Example

(std-msg-add '((:ENGLISH :GERMAN)
               ("my prompt" "mein prompt")
              ))

(if (equal (std-firstn 5 (car *STD:LOCALIZED-MESSAGES*))
          '(:ENGLISH :GERMAN :RUSSIAN :JAPANESE :CZECH))
  (std-msg-add
    (list (car *STD:LOCALIZED-MESSAGES*)
          ("Select Objects" "Objekte w\344hlen" nil nil 
           "Vyberte objekty"))))

Arguments

msg-list: A list of list of strings. (car msg-list) must be a list of matching language symbols.

Return Value

Unspecified.

Side Effects

See above.

Module

(std-require 'STDLOCAL)

Defined in STDLOCAL