[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFR] templates://console-setup/{console-setup.templates}



Please find, for review, the debconf templates and packages descriptions for the console-setup source package.

This review will last from Thursday, March 05, 2009 to Sunday, March 15, 2009.

Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.

Your review should be sent as an answer to this mail.

When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.

When we will reach a consensus, I send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.

Finally, the reviewed templates will be sent to the package maintainer
as a bug report, and a mail will be sent to this list with "[BTS]" as
a subject tag.

Rationale:
--- console-setup.old/debian/console-setup.templates	2009-03-01 09:18:35.812738290 +0100
+++ console-setup/debian/console-setup.templates	2009-03-02 08:03:59.728589514 +0100
@@ -7,7 +7,9 @@
 Type: select
 __Choices: . Arabic, # Armenian, # Cyrillic - KOI8-R and KOI8-U, # Cyrillic - non-Slavic languages, # Cyrillic - Slavic languages (also Bosnian and Serbian Latin), . Ethiopic, # Georgian, # Greek, # Hebrew, # Lao, # Latin1 and Latin5 - western Europe and Turkic languages, # Latin2 - central Europe and Romanian, # Latin3 and Latin8 - Chichewa; Esperanto; Irish; Maltese and Welsh, # Latin7 - Lithuanian; Latvian; Maori and Marshallese, . Latin - Vietnamese, # Thai, . Combined - Latin; Slavic Cyrillic; Hebrew; basic Arabic, . Combined - Latin; Slavic Cyrillic; Greek, . Combined - Latin; Slavic and non-Slavic Cyrillic
 Default: . Combined - Latin; Slavic Cyrillic; Hebrew; basic Arabic
-_Description: Set of characters that should be supported by the console font:
+_Description: Character set to support:

Shorten the synopsis. 


+ Please choose the character set that should be supported by the console font.
+ .

Move here the mention of this "support" being for the console font.

  If you don't use a framebuffer, the choices that start with "." will
  reduce the number of available colors on the console.
 
@@ -26,8 +28,8 @@
 Type: select
 Choices: ${CHOICES}
 _Description: Keyboard layout:
- There is more than one keyboard layout with the origin you selected.
- Please select the layout matching your keyboard.
+ There is more than one possible keyboard layout with the origin you selected.
+ Please select the layout matching the keyboard for this machine.

Matter of taste, I think.

Replace "your keyboard" as this is not necessarily "my" keyboard
(general enutral stance we recommend in debconf templates)

 
 Template: console-setup/unsupported_config_layout
 Type: boolean
@@ -35,21 +37,23 @@
 _Description: Keep unsupported settings in configuration file?
  The configuration file /etc/default/console-setup specifies a
  keyboard layout (${XKBLAYOUT}) which is not supported
- by the configuration program.  Do you want to keep it?
+ by the configuration program.

Drop the extra question. The synopsis already has a question and
double questions are discouraged in debconf templates.


  .
- If you choose to keep it then no questions about the keyboard layout
- will be asked and your current configuration will be preserved.
+ Please choose whether you want to keep it. If you choose this option,
+ no questions about the keyboard layout
+ will be asked and the current configuration will be preserved.

Reformulate to make what is to be chosen clearer, particularly as we
dropped the extra question earlier.

 
 Template: console-setup/unsupported_layout
 Type: boolean
 Default: true
 _Description: Keep default keyboard layout (${XKBLAYOUT})?
- The default value for the keyboard layout is based on your
- language/region and the settings in /etc/X11/xorg.conf.  This default
+ The default value for the keyboard layout is based on the
+ language/region and the settings in /etc/X11/xorg.conf. This default

s/your/the

  value is ${XKBLAYOUT} and it is is not supported
- by the configuration program.  Do you want to keep it?
+ by the configuration program.
  .
- If you choose to keep it then no questions about the keyboard layout
+ Please choose whether you want to keep it. If you choose this option,
+ no questions about the keyboard layout
  will be asked.
 

Again, drop the extra question.

 Template: console-setup/unsupported_config_options
@@ -58,16 +62,16 @@
 _Description: Keep unsupported options (${XKBOPTIONS})?
  The configuration file /etc/default/console-setup specifies options
  for the keyboard layout (${XKBOPTIONS}) that are not
- supported by the configuration program.  Do you want to keep them?
+ supported by the configuration program.

Ditto
 
 Template: console-setup/unsupported_options
 Type: boolean
 Default: true
 _Description: Keep unsupported options (${XKBOPTIONS})?
  The default value for the options of the keyboard layout is based on
- your language/region and the settings in /etc/X11/xorg.conf.  This
+ your language/region and the settings in /etc/X11/xorg.conf. This
  default value is ${XKBOPTIONS} and it is not supported
- by the configuration program.  Do you want to keep it?
+ by the configuration program.

Ditto
 
 Template: console-setup/fontface
 Type: select
@@ -77,14 +81,11 @@
 # lists.  If you decide to use formatted lists then keep the lines
 # relatively short.
 _Description: Font for the console:
- Please choose the font face you would like to use on Linux console.
- .
-  - VGA has a traditional appearance and has medium coverage
-    of international scripts;
-  - Fixed has a simplistic appearance and has better coverage
-    of international scripts;
-  - Terminus is aimed to reduce eye fatigue, though some symbols
-    have a similar aspect which may be a problem for programmers.
+ "VGA" has a traditional appearance and has medium coverage of
+ international scripts. "Fixed" has a simplistic appearance and has
+ better coverage of international scripts. "Terminus" is aimed to
+ reduce eye fatigue, though some symbols have a similar aspect which
+ may be a problem for programmers.

Attempt to shorten the template down (with translations, it might
become too long, then fit on two screens, which is always confusing
for users). The enumeration is not really helpful here.


  .
  If you prefer a bold version of the Terminus font, then choose
  TerminusBold if you use a framebuffer, otherwise TerminusBoldVGA.
@@ -94,32 +95,32 @@
 Choices: ${CHOICES}
 Default: 16
 _Description: Font size:
- Please select the size of the font for the Linux console.  For
- reference, the font your computer starts with has size 16.
+ Please select the size of the font for the Linux console. For
+ reference, the font used when the computer boots has size 16.

s/your/something more neutral

 
 Template: console-setup/fontsize-fb
 Type: select
 Choices: ${CHOICES}
 Default: 16
 _Description: Font size:
- Please select the size of the font for the Linux console.  When the
- size is represented as a plain number then the corresponding font can
- be used with all console drivers and the number measures the height
- of the symbols (in number of scan lines).  Otherwise the size has the
- format HEIGHTxWIDTH and the corresponding fonts can be used only if
- you use framebuffer and the kbd console package (console-tools
- doesn't work for such fonts).  Currently these fonts cannot be used
- if the framebuffer you use is based on the RadeonFB kernel module.
- .
- You can use the height of the fonts in order to figure out the real
- size of the symbols on the console.  For reference, the font your
- computer starts with has height 16.
+ Please select the size of the font for the Linux console.
+ Simple integers correspond to fonts can
+ be used with all console drivers. The number then represents the
+ font height (number of scan lines). Alternatively, the font may
+ be represented as HEIGHTxWIDTH: such fonts can be used only with
+ the framebuffer and the kbd console package (not with console-tools).
+ These fonts cannot be used
+ if the framebuffer is based on the RadeonFB kernel module.
+ .
+ Font heights may be used in order to figure out the real
+ size of the symbols on the console. For
+ reference, the font used when the computer boots has size 16.

Reformulation: the initial wording was IMHO confusing. I'm not sure
that my proposal is the best possible, though. Room for improvement.
 
 Template: console-setup/charmap
 Type: select
 Choices: ${CHOICES}
 Default: UTF-8
-_Description: Encoding on the console:
+_Description: Encoding to use on the console:

The console is not encoded "per se". We need to choose the encoding
that will be used at the Linux console.
 
 Template: console-setup/ttys
 Type: string
@@ -137,30 +138,28 @@
 Default: Alt+Shift
 _Description: Method for toggling between national and Latin mode:
  You will need a way to toggle the keyboard between the national
- layout and the standard Latin layout.  Several options are available.
+ layout and the standard Latin layout.

"Several options are available" is useless and that tempalte is
already very long.

  .
- The most ergonomic choices seem to be the right Alt and the Caps Lock keys
+ Right Alt or Caps Lock keys are often chosen for ergonomic reasons
  (in the latter case, use the combination Shift+Caps Lock for normal Caps
- toggle).  Another popular choice is the Alt+Shift combination; note
- however that in this case the combination Alt+Shift (or Control+Shift if
- you choose it) will lose its usual meaning in Emacs and other programs
- using it.
+ toggle). Alt+Shift is also a popular combination; it will
+ however lose its usual behavior in Emacs and other programs
+ that use it for specific needs.
  .
- Note that the listed keys are not present on all keyboards.
+ Not all listed keys are present on all keyboards.

General attempt to shorten things down.

 
 Template: console-setup/switch
 Type: select
 __Choices: No temporary switch, Both Logo keys, Right Alt, Right Logo key, Left Alt, Left Logo key
 Default: No temporary switch
 _Description: Method for temporarily toggling between national and Latin input:
- Sometimes the keyboard is in national mode and you want to type only a few
- Latin letters. In this case it may be desirable to have a key for
- temporarily switching between national and Latin symbols.  While this key
- is pressed in national mode, the keyboard types Latin letters.  Conversely,
- when the keyboard is in Latin mode and this key is pressed, the keyboard
- will type national letters.
+ When the keyboard is in national mode and one wants to type only a few
+ Latin letters, it might be more appropriate to switch temporarily to
+ Latin mode. The keyboard remains in that mode as long as the chosen key is
+ kept pressed. That key may also be used ton input national letters when
+ the keyboard is in Latin mode.

Attenpt for clearer formulation and English improvement. I hope this
is the case..:-)

  .
- If you don't like this feature, choose the option "No temporary switch".
+ You can disable this feature by choosing "No temporary switch".

No assumptions about the reasons for which users might want to disable
the setting..:)

 
 Template: console-setup/altgr
 Type: select
@@ -169,10 +168,8 @@
 _Description: AltGr key replacement:
  With some keyboard layouts, AltGr is a modifier key used to input
  some characters, primarily ones that are unusual for the language of the
- keyboard layout, such as foreign currency symbols and accented letters. 
- If a key has a third symbol on it (on the front vertical face or the
- bottom right of the key top, sometimes in a different color), then AltGr
- is often the means of eliciting that symbol.
+ keyboard layout, such as foreign currency symbols and accented letters.
+ These are often printed as a third symbol on keys.

Shorten the description. I'm not sure that being so verbose really
helps users.

 
 Template: console-setup/compose
 Type: select
--- console-setup.old/debian/control	2009-03-01 09:18:35.800590228 +0100
+++ console-setup/debian/control	2009-03-02 08:08:40.172618435 +0100
@@ -15,9 +15,9 @@
 Depends: debconf (>= 0.5) | debconf-2.0, console-terminus (>= 4.26), xkb-data (>= 0.9)
 Suggests: lsb-base (>= 3.0-6)
 Conflicts: lsb-core (<< 2.0-6), lsb (<< 2.0-6), lsb-base (<< 3.0-6)
-Description: Set up the font and the keyboard on the console
- The package provides the Linux console with the same versatile
- keyboard configuration that the X Window System uses.  As a result
+Description: console font and keymap setup program
+ This package provides the Linux console with the same
+ keyboard configuration scheme than X Window System.  As a result,

Avoid sentence in package description.

s/The package/This package

  there is no need to duplicate or change the keyboard files just to
  make simple customisations such as the use of dead keys, the key
  functioning as AltGr or Compose key, the key(s) to switch between
@@ -36,13 +36,23 @@
 Depends: debconf (>= 0.5) | debconf-2.0
 Suggests: lsb-base (>= 3.0-6)
 Conflicts: console-setup, console-terminus, lsb-core (<< 2.0-6), lsb (<< 2.0-6), lsb-base (<< 3.0-6)
-Description: An experimental micro version of console-setup package
- This package can be useful when Debian system is installed on
- handhelds or other devices with small storage space.  It was created
- as proof of concept for a method to implement versatile keyboard
- configuration in the Debian installer.
+Description: console font and keymap setup program - reduced version

Normalize package description with the one of the main package. Avoids
leading indefinite article.

+ This package provides the Linux console with the same
+ keyboard configuration scheme than X Window System.  As a result,
+ there is no need to duplicate or change the keyboard files just to
+ make simple customisations such as the use of dead keys, the key
+ functioning as AltGr or Compose key, the key(s) to switch between
+ Latin and non-Latin mode, etc.
+ .
+ The package also contains console fonts supporting many of the
+ world's languages.  It provides an unified set of font faces - the
+ classic VGA, the simplistic Fixed, and the cleaned Terminus,
+ TerminusBold and TerminusBoldVGA.
+ .
+ This package can be useful for
+ handhelds or other devices with small storage space.
  .
- This package supports only UTF-8.  The legacy 8-bit encodings are not
+ The package supports only UTF-8. Legacy 8-bit encodings are not
  supported.

Use the main package description as boilerplate.

Add a specific paragraph describing what this specific package is.

 
 Package: bdf2psf
@@ -50,13 +60,13 @@
 Section: utils
 Priority: optional
 Depends: perl
-Description: Font converter to generate console fonts from BDF source fonts
- This is a command line converter that can be used in scripts to build
+Description: font converter to generate console fonts from BDF source fonts

Uncapitalize (see Developer's Reference)

+ This package provides a command-line converter that can be used in scripts to build

s/This is/This package provides

  automatically console fonts from BDF sources.  The converter comes
  with a collection of font encodings that cover many of the world
- languages; notice that the font encoding (so called SFM) does not
- need to follow the actually used encoding (so called ACM).  When the
- source font does not define a glyph for a symbol in the font encoding
+ languages. The font encoding (so-called SFM) does not
+ need to follow the used encoding (so-called ACM).  When the
+ source font does not define a glyph for a symbol in the font encoding,
  the glyph position in the console font is not wasted but used for
  another symbol.

We generally discourage things such as "notice that <foo>" in package
descriptions as they are not documentation.

Drop overused "actually" word

Add a comma

  .
@@ -84,7 +94,7 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for amiga keyboards
+Description: encoded keyboard layouts for Amiga keyboards


Uncapitalize the leading word (Developer's Reference recommendation)

Capitalize the "Amiga" brand

 XC-Package-Type: udeb
 
 Package: console-setup-ataritt-ekmap
@@ -92,7 +102,7 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for ataritt keyboards
+Description: encoded keyboard layouts for Ataritt keyboards
 XC-Package-Type: udeb

Ditto
 
 Package: console-setup-macintoshold-ekmap
@@ -100,7 +110,7 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for macintoshold keyboards
+Description: encoded keyboard layouts for old-style Macintosh keyboards
 XC-Package-Type: udeb

"macintoshold" is jargon
 
 Package: console-setup-pc-ekmap
@@ -108,7 +118,7 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for pc keyboards
+Description: encoded keyboard layouts for PC keyboards
 XC-Package-Type: udeb

Same than -amiga-ekmap
 
 Package: console-setup-sun4-ekmap
@@ -116,7 +126,7 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for sun4 keyboards
+Description: encoded keyboard layouts for Sun4 keyboards
 XC-Package-Type: udeb

Ditto
 
 Package: console-setup-sun5-ekmap
@@ -124,13 +134,13 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for sun5 keyboards
+Description: encoded keyboard layouts for Sun5 keyboards
 XC-Package-Type: udeb

Ditto
 
 Package: console-setup-fonts-udeb
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Console fonts for Debian Installer
+Description: console fonts for Debian Installer
 XC-Package-Type: udeb
 
Ditto.

-- 


Template: debian-installer/console-setup/title
Type: text
# Main menu item. Please keep below 55 columns
_Description: Configure the keyboard

Template: console-setup/codeset
Type: select
__Choices: . Arabic, # Armenian, # Cyrillic - KOI8-R and KOI8-U, # Cyrillic - non-Slavic languages, # Cyrillic - Slavic languages (also Bosnian and Serbian Latin), . Ethiopic, # Georgian, # Greek, # Hebrew, # Lao, # Latin1 and Latin5 - western Europe and Turkic languages, # Latin2 - central Europe and Romanian, # Latin3 and Latin8 - Chichewa; Esperanto; Irish; Maltese and Welsh, # Latin7 - Lithuanian; Latvian; Maori and Marshallese, . Latin - Vietnamese, # Thai, . Combined - Latin; Slavic Cyrillic; Hebrew; basic Arabic, . Combined - Latin; Slavic Cyrillic; Greek, . Combined - Latin; Slavic and non-Slavic Cyrillic
Default: . Combined - Latin; Slavic Cyrillic; Hebrew; basic Arabic
_Description: Character set to support:
 Please choose the character set that should be supported by the console font.
 .
 If you don't use a framebuffer, the choices that start with "." will
 reduce the number of available colors on the console.

Template: console-setup/model
Type: select
Choices: ${CHOICES}
_Description: Keyboard model:

Template: console-setup/layout
Type: select
Choices: ${CHOICES}
Default: U.S. English
_Description: Origin of the keyboard:

Template: console-setup/variant
Type: select
Choices: ${CHOICES}
_Description: Keyboard layout:
 There is more than one possible keyboard layout with the origin you selected.
 Please select the layout matching the keyboard for this machine.

Template: console-setup/unsupported_config_layout
Type: boolean
Default: true
_Description: Keep unsupported settings in configuration file?
 The configuration file /etc/default/console-setup specifies a
 keyboard layout (${XKBLAYOUT}) which is not supported
 by the configuration program.
 .
 Please choose whether you want to keep it. If you choose this option,
 no questions about the keyboard layout
 will be asked and the current configuration will be preserved.

Template: console-setup/unsupported_layout
Type: boolean
Default: true
_Description: Keep default keyboard layout (${XKBLAYOUT})?
 The default value for the keyboard layout is based on the
 language/region and the settings in /etc/X11/xorg.conf. This default
 value is ${XKBLAYOUT} and it is is not supported
 by the configuration program.
 .
 Please choose whether you want to keep it. If you choose this option,
 no questions about the keyboard layout
 will be asked.

Template: console-setup/unsupported_config_options
Type: boolean
Default: true
_Description: Keep unsupported options (${XKBOPTIONS})?
 The configuration file /etc/default/console-setup specifies options
 for the keyboard layout (${XKBOPTIONS}) that are not
 supported by the configuration program.

Template: console-setup/unsupported_options
Type: boolean
Default: true
_Description: Keep unsupported options (${XKBOPTIONS})?
 The default value for the options of the keyboard layout is based on
 your language/region and the settings in /etc/X11/xorg.conf. This
 default value is ${XKBOPTIONS} and it is not supported
 by the configuration program.

Template: console-setup/fontface
Type: select
Choices: ${CHOICES}
Default: Fixed
# The languages with many non-ASCII letters should not use formatted
# lists.  If you decide to use formatted lists then keep the lines
# relatively short.
_Description: Font for the console:
 "VGA" has a traditional appearance and has medium coverage of
 international scripts. "Fixed" has a simplistic appearance and has
 better coverage of international scripts. "Terminus" is aimed to
 reduce eye fatigue, though some symbols have a similar aspect which
 may be a problem for programmers.
 .
 If you prefer a bold version of the Terminus font, then choose
 TerminusBold if you use a framebuffer, otherwise TerminusBoldVGA.

Template: console-setup/fontsize-text
Type: select
Choices: ${CHOICES}
Default: 16
_Description: Font size:
 Please select the size of the font for the Linux console. For
 reference, the font used when the computer boots has size 16.

Template: console-setup/fontsize-fb
Type: select
Choices: ${CHOICES}
Default: 16
_Description: Font size:
 Please select the size of the font for the Linux console.
 Simple integers correspond to fonts can
 be used with all console drivers. The number then represents the
 font height (number of scan lines). Alternatively, the font may
 be represented as HEIGHTxWIDTH: such fonts can be used only with
 the framebuffer and the kbd console package (not with console-tools).
 These fonts cannot be used
 if the framebuffer is based on the RadeonFB kernel module.
 .
 Font heights may be used in order to figure out the real
 size of the symbols on the console. For
 reference, the font used when the computer boots has size 16.

Template: console-setup/charmap
Type: select
Choices: ${CHOICES}
Default: UTF-8
_Description: Encoding to use on the console:

Template: console-setup/ttys
Type: string
Default: /dev/tty[1-6]
_Description: Virtual consoles in use:
 Please enter a space-delimited list of virtual consoles you use. The usual
 Unix filename wildcards are allowed (*, ? and [...]).
 .
 If you are unsure, then use the default /dev/tty[1-6] which stands for six
 virtual consoles. If you use devfs, then enter /dev/vc/[1-6] instead.

Template: console-setup/toggle
Type: select
__Choices: Caps Lock, Right Alt, Right Control, Right Shift, Right Logo key, Menu key, Alt+Shift, Control+Shift, Control+Alt, Alt+Caps Lock, Left Control+Left Shift, Left Alt, Left Control, Left Shift, Left Logo key, Scroll Lock key, No toggling
Default: Alt+Shift
_Description: Method for toggling between national and Latin mode:
 You will need a way to toggle the keyboard between the national
 layout and the standard Latin layout.
 .
 Right Alt or Caps Lock keys are often chosen for ergonomic reasons
 (in the latter case, use the combination Shift+Caps Lock for normal Caps
 toggle). Alt+Shift is also a popular combination; it will
 however lose its usual behavior in Emacs and other programs
 that use it for specific needs.
 .
 Not all listed keys are present on all keyboards.

Template: console-setup/switch
Type: select
__Choices: No temporary switch, Both Logo keys, Right Alt, Right Logo key, Left Alt, Left Logo key
Default: No temporary switch
_Description: Method for temporarily toggling between national and Latin input:
 When the keyboard is in national mode and one wants to type only a few
 Latin letters, it might be more appropriate to switch temporarily to
 Latin mode. The keyboard remains in that mode as long as the chosen key is
 kept pressed. That key may also be used ton input national letters when
 the keyboard is in Latin mode.
 .
 You can disable this feature by choosing "No temporary switch".

Template: console-setup/altgr
Type: select
__Choices: No AltGr key, Right Alt, Right Control, Right Logo key, Menu key, Left Alt, Left Logo key, Keypad Enter key, Both Logo keys, Both Alt keys
Default: Right Alt
_Description: AltGr key replacement:
 With some keyboard layouts, AltGr is a modifier key used to input
 some characters, primarily ones that are unusual for the language of the
 keyboard layout, such as foreign currency symbols and accented letters.
 These are often printed as a third symbol on keys.

Template: console-setup/compose
Type: select
__Choices: No compose key, Right Alt, Right Control, Right Logo key, Menu key, Left Logo key, Caps Lock
Default: No compose key
_Description: Compose key:
 The Compose key (known also as Multi_key) causes the computer to interpret
 the next few keystrokes as a combination in order to produce a character
 not found on the keyboard.
 .
 On the text console the Compose key does not work in Unicode mode. If not
 in Unicode mode, regardless of what you choose here, you can always also
 use the Alt+period combination as a Compose key.

Template: console-setup/modelcode
Type: string
Description: for internal use

Template: console-setup/layoutcode
Type: string
Description: for internal use

Template: console-setup/variantcode
Type: string
Description: for internal use

Template: console-setup/optionscode
Type: string
Description: for internal use

Template: console-setup/fontsize
Type: string
Description: for internal use

Template: console-setup/codesetcode
Type: string
Description: for internal use

--- console-setup.old/debian/console-setup.templates	2009-03-01 09:18:35.812738290 +0100
+++ console-setup/debian/console-setup.templates	2009-03-02 08:03:59.728589514 +0100
@@ -7,7 +7,9 @@
 Type: select
 __Choices: . Arabic, # Armenian, # Cyrillic - KOI8-R and KOI8-U, # Cyrillic - non-Slavic languages, # Cyrillic - Slavic languages (also Bosnian and Serbian Latin), . Ethiopic, # Georgian, # Greek, # Hebrew, # Lao, # Latin1 and Latin5 - western Europe and Turkic languages, # Latin2 - central Europe and Romanian, # Latin3 and Latin8 - Chichewa; Esperanto; Irish; Maltese and Welsh, # Latin7 - Lithuanian; Latvian; Maori and Marshallese, . Latin - Vietnamese, # Thai, . Combined - Latin; Slavic Cyrillic; Hebrew; basic Arabic, . Combined - Latin; Slavic Cyrillic; Greek, . Combined - Latin; Slavic and non-Slavic Cyrillic
 Default: . Combined - Latin; Slavic Cyrillic; Hebrew; basic Arabic
-_Description: Set of characters that should be supported by the console font:
+_Description: Character set to support:
+ Please choose the character set that should be supported by the console font.
+ .
  If you don't use a framebuffer, the choices that start with "." will
  reduce the number of available colors on the console.
 
@@ -26,8 +28,8 @@
 Type: select
 Choices: ${CHOICES}
 _Description: Keyboard layout:
- There is more than one keyboard layout with the origin you selected.
- Please select the layout matching your keyboard.
+ There is more than one possible keyboard layout with the origin you selected.
+ Please select the layout matching the keyboard for this machine.
 
 Template: console-setup/unsupported_config_layout
 Type: boolean
@@ -35,21 +37,23 @@
 _Description: Keep unsupported settings in configuration file?
  The configuration file /etc/default/console-setup specifies a
  keyboard layout (${XKBLAYOUT}) which is not supported
- by the configuration program.  Do you want to keep it?
+ by the configuration program.
  .
- If you choose to keep it then no questions about the keyboard layout
- will be asked and your current configuration will be preserved.
+ Please choose whether you want to keep it. If you choose this option,
+ no questions about the keyboard layout
+ will be asked and the current configuration will be preserved.
 
 Template: console-setup/unsupported_layout
 Type: boolean
 Default: true
 _Description: Keep default keyboard layout (${XKBLAYOUT})?
- The default value for the keyboard layout is based on your
- language/region and the settings in /etc/X11/xorg.conf.  This default
+ The default value for the keyboard layout is based on the
+ language/region and the settings in /etc/X11/xorg.conf. This default
  value is ${XKBLAYOUT} and it is is not supported
- by the configuration program.  Do you want to keep it?
+ by the configuration program.
  .
- If you choose to keep it then no questions about the keyboard layout
+ Please choose whether you want to keep it. If you choose this option,
+ no questions about the keyboard layout
  will be asked.
 
 Template: console-setup/unsupported_config_options
@@ -58,16 +62,16 @@
 _Description: Keep unsupported options (${XKBOPTIONS})?
  The configuration file /etc/default/console-setup specifies options
  for the keyboard layout (${XKBOPTIONS}) that are not
- supported by the configuration program.  Do you want to keep them?
+ supported by the configuration program.
 
 Template: console-setup/unsupported_options
 Type: boolean
 Default: true
 _Description: Keep unsupported options (${XKBOPTIONS})?
  The default value for the options of the keyboard layout is based on
- your language/region and the settings in /etc/X11/xorg.conf.  This
+ your language/region and the settings in /etc/X11/xorg.conf. This
  default value is ${XKBOPTIONS} and it is not supported
- by the configuration program.  Do you want to keep it?
+ by the configuration program.
 
 Template: console-setup/fontface
 Type: select
@@ -77,14 +81,11 @@
 # lists.  If you decide to use formatted lists then keep the lines
 # relatively short.
 _Description: Font for the console:
- Please choose the font face you would like to use on Linux console.
- .
-  - VGA has a traditional appearance and has medium coverage
-    of international scripts;
-  - Fixed has a simplistic appearance and has better coverage
-    of international scripts;
-  - Terminus is aimed to reduce eye fatigue, though some symbols
-    have a similar aspect which may be a problem for programmers.
+ "VGA" has a traditional appearance and has medium coverage of
+ international scripts. "Fixed" has a simplistic appearance and has
+ better coverage of international scripts. "Terminus" is aimed to
+ reduce eye fatigue, though some symbols have a similar aspect which
+ may be a problem for programmers.
  .
  If you prefer a bold version of the Terminus font, then choose
  TerminusBold if you use a framebuffer, otherwise TerminusBoldVGA.
@@ -94,32 +95,32 @@
 Choices: ${CHOICES}
 Default: 16
 _Description: Font size:
- Please select the size of the font for the Linux console.  For
- reference, the font your computer starts with has size 16.
+ Please select the size of the font for the Linux console. For
+ reference, the font used when the computer boots has size 16.
 
 Template: console-setup/fontsize-fb
 Type: select
 Choices: ${CHOICES}
 Default: 16
 _Description: Font size:
- Please select the size of the font for the Linux console.  When the
- size is represented as a plain number then the corresponding font can
- be used with all console drivers and the number measures the height
- of the symbols (in number of scan lines).  Otherwise the size has the
- format HEIGHTxWIDTH and the corresponding fonts can be used only if
- you use framebuffer and the kbd console package (console-tools
- doesn't work for such fonts).  Currently these fonts cannot be used
- if the framebuffer you use is based on the RadeonFB kernel module.
- .
- You can use the height of the fonts in order to figure out the real
- size of the symbols on the console.  For reference, the font your
- computer starts with has height 16.
+ Please select the size of the font for the Linux console.
+ Simple integers correspond to fonts can
+ be used with all console drivers. The number then represents the
+ font height (number of scan lines). Alternatively, the font may
+ be represented as HEIGHTxWIDTH: such fonts can be used only with
+ the framebuffer and the kbd console package (not with console-tools).
+ These fonts cannot be used
+ if the framebuffer is based on the RadeonFB kernel module.
+ .
+ Font heights may be used in order to figure out the real
+ size of the symbols on the console. For
+ reference, the font used when the computer boots has size 16.
 
 Template: console-setup/charmap
 Type: select
 Choices: ${CHOICES}
 Default: UTF-8
-_Description: Encoding on the console:
+_Description: Encoding to use on the console:
 
 Template: console-setup/ttys
 Type: string
@@ -137,30 +138,28 @@
 Default: Alt+Shift
 _Description: Method for toggling between national and Latin mode:
  You will need a way to toggle the keyboard between the national
- layout and the standard Latin layout.  Several options are available.
+ layout and the standard Latin layout.
  .
- The most ergonomic choices seem to be the right Alt and the Caps Lock keys
+ Right Alt or Caps Lock keys are often chosen for ergonomic reasons
  (in the latter case, use the combination Shift+Caps Lock for normal Caps
- toggle).  Another popular choice is the Alt+Shift combination; note
- however that in this case the combination Alt+Shift (or Control+Shift if
- you choose it) will lose its usual meaning in Emacs and other programs
- using it.
+ toggle). Alt+Shift is also a popular combination; it will
+ however lose its usual behavior in Emacs and other programs
+ that use it for specific needs.
  .
- Note that the listed keys are not present on all keyboards.
+ Not all listed keys are present on all keyboards.
 
 Template: console-setup/switch
 Type: select
 __Choices: No temporary switch, Both Logo keys, Right Alt, Right Logo key, Left Alt, Left Logo key
 Default: No temporary switch
 _Description: Method for temporarily toggling between national and Latin input:
- Sometimes the keyboard is in national mode and you want to type only a few
- Latin letters. In this case it may be desirable to have a key for
- temporarily switching between national and Latin symbols.  While this key
- is pressed in national mode, the keyboard types Latin letters.  Conversely,
- when the keyboard is in Latin mode and this key is pressed, the keyboard
- will type national letters.
+ When the keyboard is in national mode and one wants to type only a few
+ Latin letters, it might be more appropriate to switch temporarily to
+ Latin mode. The keyboards remains in that mode as long as the chosen key is
+ kept pressed. That key may also be used ton input national letters when
+ the keyboard is in Latin mode.
  .
- If you don't like this feature, choose the option "No temporary switch".
+ You can disable this feature by choosing "No temporary switch".
 
 Template: console-setup/altgr
 Type: select
@@ -169,10 +168,8 @@
 _Description: AltGr key replacement:
  With some keyboard layouts, AltGr is a modifier key used to input
  some characters, primarily ones that are unusual for the language of the
- keyboard layout, such as foreign currency symbols and accented letters. 
- If a key has a third symbol on it (on the front vertical face or the
- bottom right of the key top, sometimes in a different color), then AltGr
- is often the means of eliciting that symbol.
+ keyboard layout, such as foreign currency symbols and accented letters.
+ These are often printed as a third symbol on keys.
 
 Template: console-setup/compose
 Type: select
--- console-setup.old/debian/control	2009-03-01 09:18:35.800590228 +0100
+++ console-setup/debian/control	2009-03-02 08:08:40.172618435 +0100
@@ -15,9 +15,9 @@
 Depends: debconf (>= 0.5) | debconf-2.0, console-terminus (>= 4.26), xkb-data (>= 0.9)
 Suggests: lsb-base (>= 3.0-6)
 Conflicts: lsb-core (<< 2.0-6), lsb (<< 2.0-6), lsb-base (<< 3.0-6)
-Description: Set up the font and the keyboard on the console
- The package provides the Linux console with the same versatile
- keyboard configuration that the X Window System uses.  As a result
+Description: console font and keymap setup program
+ This package provides the Linux console with the same
+ keyboard configuration scheme than X Window System.  As a result,
  there is no need to duplicate or change the keyboard files just to
  make simple customisations such as the use of dead keys, the key
  functioning as AltGr or Compose key, the key(s) to switch between
@@ -36,13 +36,23 @@
 Depends: debconf (>= 0.5) | debconf-2.0
 Suggests: lsb-base (>= 3.0-6)
 Conflicts: console-setup, console-terminus, lsb-core (<< 2.0-6), lsb (<< 2.0-6), lsb-base (<< 3.0-6)
-Description: An experimental micro version of console-setup package
- This package can be useful when Debian system is installed on
- handhelds or other devices with small storage space.  It was created
- as proof of concept for a method to implement versatile keyboard
- configuration in the Debian installer.
+Description: console font and keymap setup program - reduced version
+ This package provides the Linux console with the same
+ keyboard configuration scheme than X Window System.  As a result,
+ there is no need to duplicate or change the keyboard files just to
+ make simple customisations such as the use of dead keys, the key
+ functioning as AltGr or Compose key, the key(s) to switch between
+ Latin and non-Latin mode, etc.
+ .
+ The package also contains console fonts supporting many of the
+ world's languages.  It provides an unified set of font faces - the
+ classic VGA, the simplistic Fixed, and the cleaned Terminus,
+ TerminusBold and TerminusBoldVGA.
+ .
+ This package can be useful for
+ handhelds or other devices with small storage space.
  .
- This package supports only UTF-8.  The legacy 8-bit encodings are not
+ The package supports only UTF-8. Legacy 8-bit encodings are not
  supported.
 
 Package: bdf2psf
@@ -50,13 +60,13 @@
 Section: utils
 Priority: optional
 Depends: perl
-Description: Font converter to generate console fonts from BDF source fonts
- This is a command line converter that can be used in scripts to build
+Description: font converter to generate console fonts from BDF source fonts
+ This package provides a command-line converter that can be used in scripts to build
  automatically console fonts from BDF sources.  The converter comes
  with a collection of font encodings that cover many of the world
- languages; notice that the font encoding (so called SFM) does not
- need to follow the actually used encoding (so called ACM).  When the
- source font does not define a glyph for a symbol in the font encoding
+ languages. The font encoding (so-called SFM) does not
+ need to follow the used encoding (so-called ACM).  When the
+ source font does not define a glyph for a symbol in the font encoding,
  the glyph position in the console font is not wasted but used for
  another symbol.
  .
@@ -84,7 +94,7 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for amiga keyboards
+Description: encoded keyboard layouts for Amiga keyboards
 XC-Package-Type: udeb
 
 Package: console-setup-ataritt-ekmap
@@ -92,7 +102,7 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for ataritt keyboards
+Description: encoded keyboard layouts for Ataritt keyboards
 XC-Package-Type: udeb
 
 Package: console-setup-macintoshold-ekmap
@@ -100,7 +110,7 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for macintoshold keyboards
+Description: encoded keyboard layouts for old-style Macintosh keyboards
 XC-Package-Type: udeb
 
 Package: console-setup-pc-ekmap
@@ -108,7 +118,7 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for pc keyboards
+Description: encoded keyboard layouts for PC keyboards
 XC-Package-Type: udeb
 
 Package: console-setup-sun4-ekmap
@@ -116,7 +126,7 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for sun4 keyboards
+Description: encoded keyboard layouts for Sun4 keyboards
 XC-Package-Type: udeb
 
 Package: console-setup-sun5-ekmap
@@ -124,13 +134,13 @@
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Encoded keyboard layouts for sun5 keyboards
+Description: encoded keyboard layouts for Sun5 keyboards
 XC-Package-Type: udeb
 
 Package: console-setup-fonts-udeb
 Section: debian-installer
 Priority: extra
 Architecture: all
-Description: Console fonts for Debian Installer
+Description: console fonts for Debian Installer
 XC-Package-Type: udeb
 
Source: console-setup
Section: utils
Priority: optional
Maintainer: Debian Install System Team <debian-boot@lists.debian.org>
Uploaders: Anton Zinoviev <zinoviev@debian.org>, Christian Perrier <bubulle@debian.org>
Build-Depends-Indep: perl, libxml-parser-perl, xkb-data (>= 0.9)
Build-Depends: debhelper (>= 5), po-debconf
Standards-Version: 3.7.3
Vcs-Svn: svn://svn.debian.org/d-i/trunk/packages/console-setup

Package: console-setup
Section: utils
Architecture: all
Recommends: kbd (>= 0.99-12) | console-tools (>= 1:0.2.3-16)
Depends: debconf (>= 0.5) | debconf-2.0, console-terminus (>= 4.26), xkb-data (>= 0.9)
Suggests: lsb-base (>= 3.0-6)
Conflicts: lsb-core (<< 2.0-6), lsb (<< 2.0-6), lsb-base (<< 3.0-6)
Description: console font and keymap setup program
 This package provides the Linux console with the same
 keyboard configuration scheme than X Window System.  As a result,
 there is no need to duplicate or change the keyboard files just to
 make simple customisations such as the use of dead keys, the key
 functioning as AltGr or Compose key, the key(s) to switch between
 Latin and non-Latin mode, etc.
 .
 The package also contains console fonts supporting many of the
 world's languages.  It provides an unified set of font faces - the
 classic VGA, the simplistic Fixed, and the cleaned Terminus,
 TerminusBold and TerminusBoldVGA.

Package: console-setup-mini
Section: utils
Priority: extra
Architecture: all
Recommends: kbd | console-tools
Depends: debconf (>= 0.5) | debconf-2.0
Suggests: lsb-base (>= 3.0-6)
Conflicts: console-setup, console-terminus, lsb-core (<< 2.0-6), lsb (<< 2.0-6), lsb-base (<< 3.0-6)
Description: console font and keymap setup program - reduced version
 This package provides the Linux console with the same
 keyboard configuration scheme than X Window System.  As a result,
 there is no need to duplicate or change the keyboard files just to
 make simple customisations such as the use of dead keys, the key
 functioning as AltGr or Compose key, the key(s) to switch between
 Latin and non-Latin mode, etc.
 .
 The package also contains console fonts supporting many of the
 world's languages.  It provides an unified set of font faces - the
 classic VGA, the simplistic Fixed, and the cleaned Terminus,
 TerminusBold and TerminusBoldVGA.
 .
 This package can be useful for
 handhelds or other devices with small storage space.
 .
 The package supports only UTF-8. Legacy 8-bit encodings are not
 supported.

Package: bdf2psf
Architecture: all
Section: utils
Priority: optional
Depends: perl
Description: font converter to generate console fonts from BDF source fonts
 This package provides a command-line converter that can be used in scripts to build
 automatically console fonts from BDF sources.  The converter comes
 with a collection of font encodings that cover many of the world
 languages. The font encoding (so-called SFM) does not
 need to follow the used encoding (so-called ACM).  When the
 source font does not define a glyph for a symbol in the font encoding,
 the glyph position in the console font is not wasted but used for
 another symbol.
 .
 When deciding about the position in the font for a particular glyph,
 the converter takes into account that in text video modes the video
 adapter copies the 8th column of the glyph matrix of symbols
 positioned in the pseudographic area to the 9th column.  In order to
 create fonts for text video modes the width of the glyph matrix of
 the source BDF font should be 7, 8 or 9 pixels, otherwise the
 converter creates fonts suitable for framebuffer only.

Package: console-setup-udeb
Section: debian-installer
Priority: extra
Depends: console-setup-ekmap, console-setup-fonts-udeb, archdetect, cdebconf-udeb, kbd-udeb
Provides: keyboard-setup
Architecture: all
Description: Configure the keyboard
 This is an experimental replacement of kbd-chooser.
XC-Package-Type: udeb
XB-Installer-Menu-Item: 1200

Package: console-setup-amiga-ekmap
Provides: console-setup-ekmap
Section: debian-installer
Priority: extra
Architecture: all
Description: encoded keyboard layouts for Amiga keyboards
XC-Package-Type: udeb

Package: console-setup-ataritt-ekmap
Provides: console-setup-ekmap
Section: debian-installer
Priority: extra
Architecture: all
Description: encoded keyboard layouts for Ataritt keyboards
XC-Package-Type: udeb

Package: console-setup-macintoshold-ekmap
Provides: console-setup-ekmap
Section: debian-installer
Priority: extra
Architecture: all
Description: encoded keyboard layouts for old-style Macintosh keyboards
XC-Package-Type: udeb

Package: console-setup-pc-ekmap
Provides: console-setup-ekmap
Section: debian-installer
Priority: extra
Architecture: all
Description: encoded keyboard layouts for PC keyboards
XC-Package-Type: udeb

Package: console-setup-sun4-ekmap
Provides: console-setup-ekmap
Section: debian-installer
Priority: extra
Architecture: all
Description: encoded keyboard layouts for Sun4 keyboards
XC-Package-Type: udeb

Package: console-setup-sun5-ekmap
Provides: console-setup-ekmap
Section: debian-installer
Priority: extra
Architecture: all
Description: encoded keyboard layouts for Sun5 keyboards
XC-Package-Type: udeb

Package: console-setup-fonts-udeb
Section: debian-installer
Priority: extra
Architecture: all
Description: console fonts for Debian Installer
XC-Package-Type: udeb

Attachment: signature.asc
Description: Digital signature


Reply to: