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

Re: Please check these templates once again



On Thu, Oct 09, 2003 at 02:17:46AM +0200, Nicolas Boullis wrote:
> I'll be happy to correct any type or mistake, but I'd rather not 
> implement sublte rephrasings since these templates are already being 
> translated.

Well, here are my suggestions, and whether you implement them now,
later, or not at all isn't really my decision. :)

Where a recommendation applies more than once I won't repeat it.  I
expect you to interpret my advice consistently.  ;-)


> Template: em8300/microcode/download
> Type: boolean
> Default: true
> _Description: Download the microcode image from the web?

Not really a localization issue per se, but a debconf style point:

Don't put question marks in the template's short description, because it
doesn't make sense for every frontend.  It makes sense for dialog boxes,
but not for checkboxes, which is a perfectly legitmate UI control to
configre a boolean parameter.

I suggest phrasing this as a punchy sentence fragment.

_Description: download microcode image from the Web

(We're not referring to just any web, but the World Wide Web, right?)

>  The upstream developers have tried several microcode images and
>  selected the one that works best on various cards. So this microcode

Two spaces between sentences.

s/So/Therefore,/

>  image is probably better than the ones you can get from your MS-Windows

s/MS-Windows/Microsoft Windows/

Or just "Windows".

>  drivers. The upstream developers have made it available for download
>  on their web site.

I say "website".

>  However, because of some legal issues, this microcode
>  image cannot be distributed by Debian (even in non-free). If you do

s/ (even in non-free)//

That seems an unimportant detail to me.

>  not want to download it, you can still extract the appropriate
>  microcode image(s) from the MS-Windows .vxd file, using em8300mc_ex.
>  .
>  Warning: if /usr/lib/em8300/em8300.uc already exists on your system, it
>  will be overwritten by the downloaded file.

I thought Policy said we shouldn't put non-packaged stuff in /usr/lib?

> Template: em8300/microcode/download_failed
> Type: note
> _Description: Failed to download microcode image

s/Failed/failed/

Let the debconf frontend worry about capitalizing things.

>  The microcode image could not be downloaded from the upstream
>  authors' web site. You probably won't be able to use your MPEG
>  decoder card until the microcode image is actually downloaded.
>  .
>  To retry, run "dpkg-reconfigure em8300" as root, or download it by
>  hand from "http://dxr3.sourceforge.net/download/em8300.uc"; and put it
>  in "/usr/lib/em8300/em8300.uc".
> 
> Template: em8300/microcode/file
> Type: select
> _Choices: None${files}
> Default: None
> _Description: Which microcode image do you want to use?

_Description: select desired microcode image

> Template: em8300/chipset
> Type: select
> Choices: adv717x, bt865
> _Description: Which chip is used on your MPEG decoder card?

_Description: identify chip used on MPEG decoder card

>  Creative DXR3 cards have a bt865 on board, while Hollywood Plus cards
>  use an adv717x.
> 
> Template: em8300/adv717x/options
> Type: string
> _Description: Options for the adv717x kernel module?

_Description: specify options for adv717x module

>  Options can be passed to the adv717x kernel module when it is loaded
>  to control how it works.
>  .
>  Available options are:
>   pixelport_16bit=x
>   pixelport_other_pal=x
>   swap_redblue_pal=x
>  Where x is 0 or 1. Multiple options should be separated by spaces.

s/Where/where/

This sentence began with "Available" and ends with "1."

>  Some sets of options have been reported to remove color
>  problems. Check the package documentation for details.
>  .
>  Unfortunately, there is currently no way to find the right parameters
>  for your card, so you'll have to find them yourself by trial and error.
> 
> Template: em8300/options
> Type: string
> _Description: Options for the em8300 kernel module?

_Description: specify options for em8300 module

>  Options can be passed to the em8300 kernel module when it is loaded
>  to control how it works.
>  .
>  Available options are:
>   activate_loopback=x
>   bt865_ucode_timeout=x
>   dicom_control=x
>   dicom_fix=x
>   dicom_other_pal=x
>   use_bt865=x
>  Where x is 0 or 1. Multiple options should be separated by spaces.
>  .
>  Some sets of options have been reported to remove color
>  problems. Check the package documentation for details.

The text wrapping in this paragraph isn't consistent with the others.

>  Unfortunately, there is currently no way to find the right parameters
>  for your card, so you'll have to find them yourself by trial and error.
> 
> Template: em8300/make_devices
> Type: boolean
> Default: true
> _Description: Create device files for your MPEG decoder card?

_Description: create device files for MPEG decoder card

>  You need device files to access your MPEG decoder card.

I'd say:

Special device files must exist to enable access to your MPEG decoder
card.

>  .
>  Unfortunately, no major number has been officially allocated yet for
>  em8300. The major number 121 is currently used, but it's officially

s/em8300/the em8300/

>  reserved for "LOCAL/EXPERIMENTAL USE".
>  .
>  Consequently, you may have already chosen to use this major number

I'm not sure "consequently" is the right word here.  I'd use "thus", but
I admit I cannot think of an objective reason.

>  for another use. If you have, using the same major number for em8300
>  may lead to some breakage. In most cases, however, unless you know

"lead to some breakage" is informal geek lingo.

I suggest:

"may cause problems or prevent access to the card"

>  for sure that you are already using it, it should be available.
>  .
>  If you need to use a different major number for em8300, please read
>  /usr/share/doc/em8300/README.Debian for more info.

Overall, it looks really good.  Thanks for contacting the -l10n-english
freaks.  :)

-- 
G. Branden Robinson                |    Any man who does not realize that
Debian GNU/Linux                   |    he is half an animal is only half a
branden@debian.org                 |    man.
http://people.debian.org/~branden/ |    -- Thornton Wilder

Attachment: signature.asc
Description: Digital signature


Reply to: