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

Re: please reviex my debconf templates



# My revisions should be a valid sed script, but I've not tested it:
# 
/Template: em8300.microcode.download/,/^$/{
#> Type: boolean
#> Default: true
#> _Description: Download microcode image from the Web?
#>  The upstream developers have tried several microcode images and
#>  selected the one that works best on various cards. Therefore, this
#>  microcode image is probably better than the ones you can get from
#>  your Windows drivers. The upstream developers have made it available
#>  for download on their website.

# Do "your Windows drivers" really contain multiple microcode images?
# If not,
s/the ones/the one/
}

#>  .
#>  However, because of some legal issues, this microcode image cannot be
#>  distributed by Debian. If you do not want to download it, you can
#>  still extract the appropriate microcode image(s) from the Windows
#>  .vxd file, using em8300mc_ex.

# What legal issues, just out of interest?

#>  .
#>  Warning: If /lib/firmware/em8300.bin already exists on your system, it
#>  will be overwritten by the downloaded file.
#>
/Template: em8300.microcode.download_failed/,/^$/{
#> Type: error
#> _Description: Failed to download microcode image
#>  The microcode image could not be downloaded from the upstream

# slightly inaccurate verb choice
s/could not be/was not/

#>  authors' web site. You probably won't be able to use your MPEG
#>  decoder card until the microcode image is actually downloaded.

# superfluous and mildly inaccurate adverb, use of passive
s/until the.*downloaded/until you download a microcode image/

#>  .
#>  To retry, run "dpkg-reconfigure em8300" as root, or download it by
#>  hand from

# remove incongruous "by hand" metaphor
s/ by/ from/
/hand from/d

#>    http://dxr3.sourceforge.net/download/em8300.uc
#>  and put it in "/lib/firmware/em8300.bin".

s/put it in/save it as/
}

/Template: em8300.microcode.file/,/^$/{
#> Type: select
#> _Choices: None${files}
#> Default: None
#> _Description: Primary microcode:
#>  A microcode image previously installed in /usr/share/em8300/ will be
#>  copied to /lib/firmware/em8300.bin and used.

# Use active voice
s/A microcode/This will copy a microcode/
s/ will be//
s/copied //
s/used/and use it/
}

/Template: em8300.microcode.delete_olddir/,/^$/{
#> Type: boolean
#> Default: false
#> _Description: Delete old firmware directory?

# Use active voice
s/Multiple.*detected/Multiple microcode images seem to be installed/

#>  in /usr/share/em8000/. Support for multiple microcode images has
#>  been removed from this version, so if you wish to continue using
#>  multiple microcode images you will have to keep these files and

s/images /images, /

#>  handle the situation manually. You will be responsible for removing
#>  these files once you have finished with them.
#>  .
#>  Most people just need a single microcode image. If you only want to
#>  use one microcode image, or if you do not know why you have multiple

s/just need a/need only a/
s/If you only want to/If you want to/
s/use one/use only one/

#>  microcode images installed, then you do not need to keep these
#>  microcode images. The extra files will then be removed.

# simplify advice and use deleted, not removed
s/then you do not need to keep these/then you can answer Y
s/microcode.*removed/and the extra files will be deleted/

}

#> Template: em8300/chipset
#> Type: select
#> Choices: adv717x, bt865
#> _Description: Chip used on MPEG decoder card:
#>  Creative DXR3 cards have a bt865 on board, while Hollywood Plus cards
#>  use an adv717x.
#>
#> Template: em8300/bt865/options
#> Type: string
#> _Description: Options for bt865 module:
#>  Options can be passed to the bt865 kernel module when it is loaded
#>  to control how it works.
#>  .
#>  Options include:
#>   output_mode=comp+svideo|rgb
#>  Multiple options should be separated by spaces.
#>
#> Template: em8300/adv717x/options
#> Type: string
#> _Description: Options for adv717x module:
#>  Options can be passed to the adv717x kernel module when it is loaded
#>  to control how it works.
#>  .
#>  Options include:
#>   output_mode=comp+svideo|svideo|comp|comp+psvideo|psvideo|composvideo|yuv|rgb|rgbs
#>   pixelport_16bit=0|1
#>   pixelport_other_pal=0|1
#>   pixeldata_adjust_ntsc=0|1|2|3
#>   pixeldata_adjust_pal=0|1|2|3
#>  Multiple options should be separated by spaces.
#>  .
#>  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 em8300 module:
#>  Options can be passed to the em8300 kernel module when it is loaded
#>  to control how it works.
#>  .
#>  Options include:
#>   activate_loopback=0|1
#>   audio_device=alsa|oss|osslike|none
#>   alsa_index=-1|0|1|2|3|...
#>   dsp_num=-1|0|1|2|3|...
#>   bt865_ucode_timeout=0|1
#>   dicom_control=0|1
#>   dicom_fix=0|1
#>   dicom_other_pal=0|1
#>   use_bt865=0|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.
#>  .
#>  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.no_device_creation/,/^$/{
#> Type: note
#> Default: true
#> _Description: No creation of device files
#>  Special device files must exist to enable access to your MPEG decoder
#>  card.
#>  .
#>  You seem to be using a static /dev. As no major number has been
#>  officially allocated yet for the em8300, special device files can't
#>  be created.

s/As no.*been/Special device files can't be/
s/officially.*can't/created automatically because no major number has/
s/be created./been allocated to the em8300 officially yet./

#>  .
#>  Hence, you'll have to choose a major number to use (121 is used by
#>  default, but it's officially reserved for "LOCAL/EXPERIMENTAL USE")

# consistency with previous paragraph
s/reserved for/allocated to/

#>  and manually create the corresponding device files. Please read
#>  /usr/share/doc/em8300/README.Debian for more info.

# Remove manual metaphor
s/manually //
s/files/files yourself/

}

q

Hope that helps,
-- 
MJR/slef
My Opinion Only: see http://people.debian.org/~mjr/
Please follow http://www.uk.debian.org/MailingLists/#codeofconduct



Reply to: