From 9749aa6e20a687f2e0056f058b3095f00fd04ef5 Mon Sep 17 00:00:00 2001 From: svu Date: Wed, 22 Dec 2004 23:28:46 +0000 Subject: more rules regarding symbols --- docs/README.symbols | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/README.symbols b/docs/README.symbols index 10be81c..749618e 100644 --- a/docs/README.symbols +++ b/docs/README.symbols @@ -3,7 +3,7 @@ The files in the symbols directory describe possible layouts for a given keyboard. The default layout in each file should describe the most common layout -for its kind, ususally the symbols printed on the keys. Layout variants +for its kind, usually the symbols printed on the keys. Layout variants can describe common differences that are not necessarily printed on the keys. (e.g. a phonetic version of Cyrillic). @@ -36,3 +36,16 @@ The ISO codes can be found at the following addressed: Country layouts: http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/iso_3166-1_decoding_table.html Language layouts: http://www.loc.gov/standards/iso639-2/langcodes.html Script layouts: http://www.unicode.org/iso15924/iso15924-codes.html + +The description in the directory file base.xml.in should match the group names +in the symbols file. + +If the layout is country-based, this has to be the full +name of the country. It is highly not recommended to use the forms +"Republic of XXX" or "XXX Republic" - the form "XXX" should be used instead. +The only exception is "United Kingdom". + +If the layout is language-based, this has to be the name of the language. + +Within single symbols file, all the variants should have the same group name +(implemented using the "include" directive wherever possible). -- cgit v1.2.1