dslang_instr.txt
================

This file is provided without any support, and is Copyright
1996-1997 Graham Dean and Andy Dean.

This file describes the format of the "language.msg" file that
is used by drawSTUDIO to allow the program to be localised for
different languages. A full list of the freely available
languages that are currently available for drawSTUDIO are
kept on our Web site:

	http://www.ajdean.demon.co.uk/studio/ds.html

If you do translate this file into a language that is not
currently freely available and wish it to be made available
to other drawSTUDIO users, please Email us at:

	andy@ajdean.demon.co.uk

and we will add it to the Web pages.

Notes On Translating The "language.msg" File
============================================

o The translated file must be called "language.msg" and must
  be located in the same directory as the drawSTUDIO program.

o Lines beginning with a semi-colon are comments and ignored by DrawStudio.

o The ID strings (MENU_XXX , GAD_XXXX, MSG_XXXX, etc.) must not be altered.

o A backslash \ at the end of a line means the string continues onto the
  next line. This is useful for splitting long messages across multiple
  lines.

o A \n represents a 'newline' in a string. These are used in requesters to keep
  the width of the requester no more than 30-40 characters.

o \c means 'centred text' and \b means 'bold text', please do not remove
  any of these control sequences from the strings.

o Please retain the case of the strings (Mixed case, lower case etc.)

o Please retain the format of the strings, i.e. leave any '...'s ,
  "'s , %s's or %d's etc...

o Check all keyboard shortcuts and make sure there are no conflicts
  (2 or more gadgets using the same shortcut).

Meaning of the ID's
-------------------

MSG_ means a general message, only 1 string must follow this ID.
{text}

MENU_ means a menu string, only 1 string must follow this ID.
{text}

KMENU_ means a menu with a keyboard short cut. 2 strings must follow.
The shortcut must be UPPERCASE.
{text, SHORTCUT}.

GAD_ means gadget text. Only 1 string must follow.
{text}

KGAD_ means a menu with a keyboard short cut. 2 strings must follow.
The shortcut must be lowercase.
{text, shortcut}.

REQ_ means a requester. 2 strings must follow: The gadget text followed
by the message text.
The gadgets are seperated by a '|' character. e.g. OK|Cancel
{gadgets, text}

HELP_ means gadget bubble help (display when leaving the mouse pointer
over a gadget for a few seconds). Only 1 string must follow.
{text}
