~ubuntu-branches/ubuntu/natty/localechooser/natty

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Colin Watson
  • Date: 2006-11-27 13:44:11 UTC
  • Revision ID: james.westby@ubuntu.com-20061127134411-la2cyk7prqj0xww5
Tags: 1.30ubuntu1
* Resynchronise with Debian. Remaining changes:
  - Add a localechooser-data package containing lists useful for packages
    that create automatic installation scripts.
  - Always support English, unless preseeded otherwise.
  - Check whether the language has changed after asking the country
    question, and recalculate a number of things if so.
  - Drop fallbacks for Norwegian Bokmål and Nynorsk.
  - Simplify use of locale-gen using the new command-line argument
    facility in Ubuntu's locales package.
  - Move Portuguese above Portuguese (Brazil) in languagelist.l10n.
  - Add encoding field to languagelist file and use the full SUPPORTED
    file rather than SUPPORTED-short.
  - If the language question was already marked as seen and the answer
    didn't change, then don't recalculate the locale.
* Drop wording change in location question. I think the wording in Debian
  is sufficiently better now than it was back in the dawn of time when we
  changed this that we no longer need to carry around a giant diff for all
  the resulting translation changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
48
48
The way both packages collaborate is somewhat complicated and will be
49
49
described in details below. The general rationale is about building a
50
50
value for the system locale which may be as close as possible of the
51
 
"real" locale (language+country). As not all langyage+country
 
51
"real" locale (language+country). As not all language+country
52
52
combinations are currently supported in Debian, approximations will
53
53
occur in some cases.
54
54
 
56
56
1) propose a language choice
57
57
2) propose a "short" list of countries with all countries for which
58
58
   this language has a supported locale
59
 
3) optionnaly propose the whole list of world countries
 
59
3) optionally propose the whole list of world countries
60
60
4) (for medium priority installs) prompt for a locale if several locales
61
61
   (with different modifiers or charsets) exist for that language/country
62
62
   combination
63
63
 
64
64
This package should behave as follows:
65
65
 
66
 
Langauge choice
 
66
Language choice
67
67
---------------
68
68
 
69
69
  0. Ask the user to pick one of the available languages.
70
70
 
71
71
  1. Change presentation language in debconf.
72
72
     (value debconf/language; content=language ISO-639 code plus
73
 
      optionnally lmanguage variant, for instance pt_BR)
 
73
      optionally language variant, for instance pt_BR)
74
74
 
75
75
  2. Set the following variables for later use:
76
76
     -debian-installer/language
117
117
-present user, at medium priority only, with a screen listing all
118
118
 world countries
119
119
 This value will see the debian-installer/country value with the ISO-3166
120
 
 code of the country. This value will onyl be used as a default for
 
120
 code of the country. This value will only be used as a default for
121
121
 location related choices such as the timezone or the mirror
122
122
 
123
123
2) If NO country code was set after the language choice
127
127
-always prompt the user (high priority) with a *short* list of all
128
128
 countries for which a valid locale exists for this language
129
129
 THIS LIST IS BUILT AT BUILD TIME for countrychooser, not on the fly
130
 
 at install time. It is build only for languages which have a debconf
 
130
 at install time. It is built only for languages which have a debconf
131
131
 translation for countrychooser
132
132
 
133
133
 This short list includes an "other" choice.
176
176
Debian.  The remaining list is presented to the user with the above
177
177
determined default value.
178
178
 
179
 
This part allows for a final refinment of the locale without filling
 
179
This part allows for a final refinement of the locale without filling
180
180
default installs with a rather technical question.
181
181
 
182
182
There have been request for the possibility of editing the priority
213
213
   - Timezone restricted list of choices based on the selected country
214
214
 
215
215
  locales
216
 
   - The selected additionnal locales will be generated on the installed system
 
216
   - The selected additional locales will be generated on the installed system
217
217
 
218
218
Interaction with the lowmem package
219
219
-----------------------------------
220
220
 
221
221
The lowmem package is triggered when the available memory prevents
222
 
from using translations, because they eat lot of space on the ramdisk.
 
222
using translations, because they eat a lot of space on the ramdisk.
223
223
 
224
224
For this to work, lowmem must set debian-installer/locale to en_US and set
225
225
its seen flag.
234
234
Language choice
235
235
---------------
236
236
 
237
 
The core of the package are the languagelist/languagelist.l10n files.
 
237
The core of the package are the languagelist and languagelist.l10n files.
238
238
For a language to appear in the language chooser screen it must have entries in both these files.
239
239
 
240
240
  languagelist
297
297
                     It will usually be empty except for languages
298
298
                     where fallback to something else than English is wished
299
299
                     
300
 
                     Setting this field will enfore setting LANGUAGE in
 
300
                     Setting this field will enforce setting LANGUAGE in
301
301
                     /etc/environment or /etc/default/locale
302
302
 
303
303
                     Never add random languages without talking deeply
304
304
                     with the i18n coordinators.
305
305
 
306
306
   -console-data    =special options for the console-data package
307
 
                     (mostly keyboard or temrinal settings)
 
307
                     (mostly keyboard or terminal settings)
308
308
 
309
309