Re: [RFR] templates://console-setup/{console-setup.templates}
Christian Perrier wrote:
> Your review should be sent as an answer to this mail.
I can't find the version you're diffing against (you said it was
out of SVN), so I've only attached modified versions of your
templates/control files, with no patch.jbr.
> 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
^^^^
This "your" was switched to "the" elsewhere. Would it make sense to
change it (globally) to something like "the currently defined"?
> This default value is ${XKBOPTIONS} and it is not supported
> by the configuration program.
s/and it is not/, which is not/g
> Template: console-setup/fontface
[...]
> _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.
I'm not keen on "aimed to". "Intended to" would work; or perhaps
rather than attributing motives we should just say
"Terminus" may help to
(Unless of course this particular weaseling technique is covered by
too many cosmetics-industry patents.)
> If you prefer a bold version of the Terminus font, then choose
> TerminusBold if you use a framebuffer, otherwise TerminusBoldVGA.
That's "otherwise" to the second "if", not the first...
If you prefer a bold version of the Terminus font, choose either
TerminusBold (if you use a framebuffer) or TerminusBoldVGA (otherwise).
> Template: console-setup/fontsize-fb
[...]
> _Description: Font size:
> + Please select the size of the font for the Linux console.
> + Simple integers correspond to fonts can
ing
> + 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
;
Are these different fonts, exactly, or should it talk about "such
font specifications"?
> + 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.
It's not immediately obvious which font(spec)s "these" are. I'll
backtrack slightly:
Alternatively, the font may
be represented as HEIGHTxWIDTH; however, such font specifications
require the kbd console package (not console-tools) plus
framebuffer (and the RadeonFB kernel driver for framebuffer does
not support them either).
The s/module/driver/ switch is on the grounds that it still applies
when the driver is compiled in statically. I'm not sure if the
capitalisation in "RadeonFB" is canonical, but I've kept it anyway.
> + 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.
Making it impersonal pushes it towards ambiguity between "you can
use it as a rule of thumb" and "the computer can calculate it".
Font heights can be useful for figuring out the real
> Template: console-setup/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.
>
> Attenpt for clearer formulation and English improvement. I hope this
> is the case..:-)
Only one thing I'd bother changing, which is an obvious typo.
Normally I wouldn't talk about "national letters", but that's some
sort of cultural feature of the anglophone world (where orthography
isn't a matter for the state); it probably is the appropriate
phrasing for the people reading this template.
> _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.
>
> Shorten the description. I'm not sure that being so verbose really
> helps users.
Agreed, but might they be only the second? s/a third/an extra/
Then in the control file:
> +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,
as the
> 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
z
> +Description: console font and keymap setup program - reduced version
[...]
> + The package also contains console fonts supporting many of the
> + world's languages. It provides an unified set of font faces - the
a (yoonified)
> + classic VGA, the simplistic Fixed, and the cleaned Terminus,
> + TerminusBold and TerminusBoldVGA.
^,
"Cleaned" gives the impression that it used to be dirty. I was
thinking "clean-looking", but Google says there's general agreement
on "clean".
> Package: bdf2psf
[...]
> -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
console fonts from BDF sources automatically. The
> with a collection of font encodings that cover many of the world
's
Then I sit on my hands for the next word, restraining myself from
"fixing" the confusion of languages and scripts. Talking about a
font supporting a language is strictly speaking inaccurate; even if
you've only got Cyrillic, it's perfectly possible to use that to
write grammatically correct Standard English. What fonts support is
conventional writing systems (en_US versus en_SU)... but this isn't
a distinction that seems to fit into normal non-linguists' heads,
and I'm not going to try forcing it.
> + 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.
[...]
"So-called" is rarely right; it implies that the name isn't strictly
appropriate. But why are we even mentioning these unexpanded
initialisms and not, for instance, explaining what a PSF is?
> Drop overused "actually" word
The result is quite opaque, partly because it was being used in its
false-friend sense of "currently", partly because of the Screen Font
Map and Application-Charset Map references, and partly because it's
not clear what these "encodings" are. Is "font encoding" even the
right term for it anyway? Wikipedia doesn't recognise it.
So assuming I've understood what it's saying, I'd suggest
simplifying down to:
The output font can use a different character
encoding from the input. When the source font does not define a
glyph for a particular symbol in the encoding table, that
glyph position in the console font is not wasted but used for
another symbol.
Then in the next paragraph I'd change some punctuation and replace
single digits with the corresponding words:
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
eighth
positioned in the pseudographic area to the 9th column. In order to
ninth ^
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
seven, eight, or nine pixels;
converter creates fonts suitable for framebuffer only.
[...]
> -Description: Encoded keyboard layouts for ataritt keyboards
> +Description: encoded keyboard layouts for Ataritt keyboards
Atari TT
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
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 currently
defined language/region and the settings in /etc/X11/xorg.conf. This
default value is ${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.
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
the currently defined language/region and the settings in /etc/X11/xorg.conf.
This default value is ${XKBOPTIONS}, which 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" may help 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, choose either
TerminusBold (if you use a framebuffer) or TerminusBoldVGA (otherwise).
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 corresponding 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; however, such font specifications
require the kbd console package (not console-tools) plus
framebuffer (and the RadeonFB kernel driver for framebuffer does
not support them either).
.
Font heights can be useful for figuring 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 to 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 an extra 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
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 as the X Window System. As a result,
there is no need to duplicate or change the keyboard files just to
make simple customizations 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 as the X Window System. As a result,
there is no need to duplicate or change the keyboard files just to
make simple customizations 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 a unified set of font faces - the
classic VGA, the simplistic Fixed, and the clean 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
console fonts from BDF sources automatically. The converter comes
with a collection of font encodings that cover many of the world's
languages. The output font can use a different character
encoding from the input. When the source font does not define a
glyph for a particular symbol in the encoding table, that
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 eighth column of the glyph matrix of symbols
positioned in the pseudographic area to the ninth column. In order to
create fonts for text video modes, the width of the glyph matrix of
the source BDF font should be seven, eight, or nine 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 Atari TT 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
Reply to: