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

[RFR] templates://neurodebian/{neurodebian.templates}



Please find, for review, the debconf templates and packages descriptions for the neurodebian source package.

This review will last from Thursday, June 04, 2015 to Sunday, June 14, 2015.

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, a summary will be sent to the review bug report,
and a mail will be sent to this list with "[BTS]" as a subject tag.

It's indeed hard to detail each and every proposed changes : there are
many because the original files had to be both reviewed for English
usage....and also using the standardized writing style we usually
recommend.

The same stands for debian/control.


Template: neurodebian/title
Type: title
_Description: NeuroDebian APT repository installer

Template: neurodebian/enable
Type: boolean
Default: false
_Description: Enable the NeuroDebian packages repository?
 The NeuroDebian project provides a separate APT repository with
 the most recent releases of maintained software and datasets as
 well as software that is not yet provided in Debian.
 .
 If you choose this option, those packages will be available
 for upgrades and installation.
 .
 Even though these packages are closely maintained
 by the NeuroDebian team, enabling this additional archive
 may compromise the integrity of the system.

Template: neurodebian/release
Type: select
__Choices: automatic, ${releases}
Choices-C: auto, ${releases}
Default: auto
_Description: Release name of the base system:
 Please specify the relevant Debian or Ubuntu release name
 (for instance "wheezy" or "trusty").
 .
 If this is set to "automatic"', the release name is chosen
 after the output of "apt-cache policy". If the release name
 for this system is not "${release}", you should choose specific one which
 matches best.


Template: neurodebian/mirror
Type: select
Choices: origin, best, custom, ${mirrors}
Default: best
_Description: NeuroDebian mirror to use:
 NeuroDebian project has a number of community-maintained mirrors
 around the globe.
 .
 If you do not know which mirror URL to choose, select among
 .
  - origin: original NeuroDebian repository
  - best: will try to use netselect to select "closest" mirror.
    Depending on the configuration of the firewall, and actual mirror
    setup, this might fail to select the really closest one.  If netselect
    is not available, the default mirror will be used.


Template: neurodebian/flavor
Type: select
Choices: auto, libre, full
Default: auto
_Description: NeuroDebian flavor to use:
 The NeuroDebian project adheres to Debian Free Software Guidelines and
 offers three packages areas, depending on software licenses, for all suites/releases:
 .
  libre
    DFSG-compliant material only
  full
    all three areas (main, contrib, non-free)
  auto
    picked from the output of "apt-cache policy"
    (for this machine: "${flavor}").

Template: neurodebian/components
Type: multiselect
Choices: software, data, devel
Default: software, data
_Description: NeuroDebian repository components to enable:
 NeuroDebian repository provides different sets of packages:
 .
  software
   Packages containing software packages, often backports of stable
   software releases for previous Debian/Ubuntu releases
  devel
   Additional "bleeding edge" software packages, more risky to be
   enabled by default. It is similar to Debian experimental.
  data
   Packages containing data (e.g. atlases, sample datasets), often
   required by software packages. It should most often be enabled.


Template: neurodebian/overwrite
Type: boolean
Default: true
_Description: Override the existing NeuroDebian APT file entries?
 If an APT sources.list file already exists for NeuroDebian, choosing
 this option will lead to a failure in the configuration of this package.

Template: neurodebian/suffix
Type: string
Default:
_Description: Additional suffix for the NeuroDebian APT file name:
 For instance if you would like to enable additional repository
 (e.g. NeuroDebian devel) or release, without interfering with the
 main/default configuration file.  Generally should be left empty.

Template: neurodebian/run-update-note
Type: note
_Description: Needed update for the packages list
 The installion or removal of the NeuroDebian APT configuration file
 requires running the "apt-get update" command. This needs to be
 done manually after the installation of the neurodebian package.

Template: neurodebian/netselect-not-found
Type: error
_Description: Missing netselect tool
 The "netselect" utility was not found. You probably need to
 install the netselect package.
 .
 Alternatively, you can manually select the mirror to use.

Template: neurodebian/netselect-cannot-be-used
Type: error
_Description: Missing netselect tool
 The "netselect" utility was not found. You probably need to
 install the netselect package.
 .
 Unless this package is installed, the NeuroDebian mirror to use has
 to be chosen manually. You may be prompted with the relevant question
 by running "dpg-reconfigure -plow neurodebian".


--- neurodebian.old/debian/neurodebian.templates	2015-05-21 21:14:37.627014717 +0200
+++ neurodebian/debian/neurodebian.templates	2015-06-04 10:07:49.400262065 +0200
@@ -5,26 +5,30 @@
 Template: neurodebian/enable
 Type: boolean
 Default: false
-_Description: Should NeuroDebian repository be enabled?
- NeuroDebian project provides a separate APT repository with backport
- builds of most recent releases of maintained software, datasets and
- some software not in Debian proper yet.  Enabling this additional
- repository will make those packages available on your base system.
- .
- Note: although NeuroDebian team aims to assure robust and correct
- operation of provided packages, enabling this additional archive
- might compromise the integrity of your base system.
+_Description: Enable the NeuroDebian packages repository?
+ The NeuroDebian project provides a separate APT repository with
+ the most recent releases of maintained software and datasets as
+ well as software that is not yet provided in Debian.
+ .
+ If you choose this option, those packages will be available
+ for upgrades and installation.
+ .
+ Even though these packages are closely maintained
+ by the NeuroDebian team, enabling this additional archive
+ may compromise the integrity of the system.
 
 Template: neurodebian/release
 Type: select
-Choices: auto, ${releases}
+__Choices: automatic, ${releases}
+Choices-C: auto, ${releases}
 Default: auto
 _Description: Release name of the base system:
- Specify for which Debian or Ubuntu release (e.g. wheezy or trusty).
+ Please specify the relevant Debian or Ubuntu release name
+ (for instance "wheezy" or "trusty").
  .
- If 'auto', Debian or Ubuntu release name will be '${release}' as
- deduced from the output of apt-cache policy.  If the release of your
- system is not '${release}' -- please choose specific one which
+ If this is set to "automatic"', the release name is chosen
+ after the output of "apt-cache policy". If the release name
+ for this system is not "${release}", you should choose specific one which
  matches best.
 
 
@@ -33,7 +37,7 @@
 Choices: origin, best, custom, ${mirrors}
 Default: best
 _Description: NeuroDebian mirror to use:
- NeuroDebian project has a number of community-maintainer mirrors
+ NeuroDebian project has a number of community-maintained mirrors
  around the globe.
  .
  If you do not know which mirror URL to choose, select among
@@ -41,8 +45,8 @@
   - origin: original NeuroDebian repository
   - best: will try to use netselect to select "closest" mirror.
     Depending on the configuration of the firewall, and actual mirror
-    setup, might fail to select actually closest one.  If netselect
-    is not available, default mirror (possibly 'origin') will be used.
+    setup, this might fail to select the really closest one.  If netselect
+    is not available, the default mirror will be used.
 
 
 Template: neurodebian/flavor
@@ -50,42 +54,41 @@
 Choices: auto, libre, full
 Default: auto
 _Description: NeuroDebian flavor to use:
- NeuroDebian project adheres to Debian Free Software Guidelines and
- has three areas of the archive in all suites/releases:
+ The NeuroDebian project adheres to Debian Free Software Guidelines and
+ offers three packages areas, depending on software licenses, for all suites/releases:
  .
   libre
-    only the DFSG-compliant materials
+    DFSG-compliant material only
   full
     all three areas (main, contrib, non-free)
   auto
-    according to output of apt-cache policy '${flavor}' will be used.
-    If that is not the flavor you need, select manually another one.
+    picked from the output of "apt-cache policy"
+    (for this machine: "${flavor}").
 
 Template: neurodebian/components
 Type: multiselect
 Choices: software, data, devel
 Default: software, data
 _Description: NeuroDebian repository components to enable:
- NeuroDebian repository provides
+ NeuroDebian repository provides different sets of packages:
  .
   software
    Packages containing software packages, often backports of stable
    software releases for previous Debian/Ubuntu releases
   devel
-   Additional "bleeding edge" software packages, which might not be a
-   good fit for being enabled by default. (Similar to Debian
-   experimental)
+   Additional "bleeding edge" software packages, more risky to be
+   enabled by default. It is similar to Debian experimental.
   data
    Packages containing data (e.g. atlases, sample datasets), often
-   required by software packages.  Should generally be enabled.
+   required by software packages. It should most often be enabled.
 
 
 Template: neurodebian/overwrite
 Type: boolean
 Default: true
-_Description: Should existing NeuroDebian APT file be overridden?
- If not allowed, configuration would fail if there is
- an existing apt configuration file for the NeuroDebian.
+_Description: Override the existing NeuroDebian APT file entries?
+ If an APT sources.list file already exists for NeuroDebian, choosing
+ this option will lead to a failure in the configuration of this package.
 
 Template: neurodebian/suffix
 Type: string
@@ -97,22 +100,27 @@
 
 Template: neurodebian/run-update-note
 Type: note
-_Description: APT list of packages needs to be updated
- For the installed (or removed) NeuroDebian APT configuration to take
- an effect, list of packages needs to be updated.  This needs to be
- done "manually" (e.g., via apt-get update) upon completion of
- installation or reconfiguration of the neurodebian package.
+_Description: Needed update for the packages list
+ The installion or removal of the NeuroDebian APT configuration file
+ requires running the "apt-get update" command. This needs to be
+ done manually after the installation of the neurodebian package.
 
 Template: neurodebian/netselect-not-found
 Type: error
-_Description: netselect tool was not found!
- Please install netselect tool first (apt-get install netselect) or
- choose a specific mirror.
+_Description: Missing netselect tool
+ The "netselect" utility was not found. You probably need to
+ install the netselect package.
+ .
+ Alternatively, you can manually select the mirror to use.
 
 Template: neurodebian/netselect-cannot-be-used
 Type: error
-_Description: netselect tool was not found (no other mirror)!
- Please install netselect tool first (apt-get install netselect)
- before installing/configuring this package, or run with a lower
- DEBIAN_PRIORITY to choose a specific mirror.
+_Description: Missing netselect tool
+ The "netselect" utility was not found. You probably need to
+ install the netselect package.
+ .
+ Unless this package is installed, the NeuroDebian mirror to use has
+ to be chosen manually. You may be prompted with the relevant question
+ by running "dpg-reconfigure -plow neurodebian".
+
 
--- neurodebian.old/debian/control	2015-05-21 21:14:37.627014717 +0200
+++ neurodebian/debian/control	2015-06-04 10:18:02.377606437 +0200
@@ -14,14 +14,14 @@
 Depends: python, wget, neurodebian-archive-keyring, ${misc:Depends}
 Recommends: netselect
 Suggests: neurodebian-desktop, neurodebian-popularity-contest
-Description: turnkey platform for the neuroscience
+Description: neuroscience-oriented distribution - repository configuration
  The NeuroDebian project integrates and maintain a variety of
  neuroscience-oriented (such as AFNI, FSL, PsychoPy, etc.) and many
  generic computational (such as condor, pandas, etc.) software projects
  within Debian.
  .
- This package enables NeuroDebian repository on top of the stock
- Debian or Ubuntu system.
+ This package enables the NeuroDebian repository on top of standard
+ Debian or Ubuntu systems.
 
 
 Package: neurodebian-dev
@@ -29,8 +29,13 @@
 Depends: ${misc:Depends}, devscripts, cowbuilder, neurodebian-archive-keyring
 Recommends: python, zerofree, moreutils, time, ubuntu-keyring, debian-archive-keyring, apt-utils
 Suggests: virtualbox-ose, virtualbox-ose-fuse
-Description: NeuroDebian development tools
- neuro.debian.net sphinx website sources and development tools used by
+Description: neuroscience-oriented distribution - development tools
+ The NeuroDebian project integrates and maintain a variety of
+ neuroscience-oriented (such as AFNI, FSL, PsychoPy, etc.) and many
+ generic computational (such as condor, pandas, etc.) software projects
+ within Debian.
+ .
+ This package provides sources and development tools used by
  NeuroDebian to provide backports for a range of Debian/Ubuntu
  releases.
 
@@ -40,8 +45,13 @@
 Depends: ${misc:Depends}, ssh-askpass-gnome | ssh-askpass, desktop-base, gnome-icon-theme,
          neurodebian-popularity-contest
 Suggests:
-Description: neuroscience research environment
- This package contains NeuroDebian artwork (icons, background image)
+Description: neuroscience-oriented distribution - desktop integration
+ The NeuroDebian project integrates and maintain a variety of
+ neuroscience-oriented (such as AFNI, FSL, PsychoPy, etc.) and many
+ generic computational (such as condor, pandas, etc.) software projects
+ within Debian.
+ .
+ This package provides NeuroDebian artwork (icons, background image)
  and a NeuroDebian menu featuring most popular neuroscience tools
  automatically installed upon initial invocation.
 
@@ -51,29 +61,38 @@
 Depends: ${misc:Depends}
 Replaces: neurodebian-keyring (<< 0.34~)
 Breaks: neurodebian-keyring (<< 0.34~)
-Description: GnuPG archive keys of the NeuroDebian archive
+Description: neuroscience-oriented distribution - GnuPG archive keys
+ The NeuroDebian project integrates and maintain a variety of
+ neuroscience-oriented (such as AFNI, FSL, PsychoPy, etc.) and many
+ generic computational (such as condor, pandas, etc.) software projects
+ within Debian.
+ .
  The NeuroDebian project digitally signs its Release files. This package
  contains the archive keys used for that.
 
 Package: neurodebian-popularity-contest
 Architecture: all
 Depends: ${misc:Depends}, popularity-contest
-Description: Helper for NeuroDebian popularity contest submissions
+Description: neuroscience-oriented distribution - popcon integration
+ The NeuroDebian project integrates and maintain a variety of
+ neuroscience-oriented (such as AFNI, FSL, PsychoPy, etc.) and many
+ generic computational (such as condor, pandas, etc.) software projects
+ within Debian.
+ .
  This package is a complement to the generic popularity-contest
  package to enable anonymous submission of usage statistics to
  NeuroDebian in addition to the popcon submissions to the underlying
- distribution (e.g. Debian or Ubuntu) popcon server.
+ distribution (either Debian or Ubuntu) popcon server.
  .
- Your participation in popcon is important for following reasons:
+ Participatin to in popcon is important for following reasons:
   - Popular packages receive more attention from developers, bugs are
     fixed faster and updates are provided quicker.
-  - Assure that we do not drop support for a previous release of Debian
+  - Assure that support is not dropped for a previous release of Debian
     or Ubuntu while are active users.
   - User statistics could be used by upstream research software
     developers to acquire funding for continued development.
  .
- It has an effect only if you have decided to participate in the
- Popularity Contest of your distribution, i.e. Debian or Ubuntu.
- You can always enable or disable your participation in popcon by
- running 'dpkg-reconfigure popularity-contest' as root.
+ This requires that popcon is activated for the underlying distribution
+ (Debian or Ubuntu). This can be achieved by running
+ "dpkg-reconfigure popularity-contest" as root.
 
Source: neurodebian
Section: science
Priority: optional
Maintainer: NeuroDebian Team <team@neuro.debian.net>
Uploaders: Michael Hanke <mih@debian.org>, Yaroslav Halchenko <debian@onerussian.com>
Build-Depends: debhelper (>= 7.0.50~), xcftools, help2man, inkscape, imagemagick, python-html5lib, po-debconf
Standards-Version: 3.9.5
Homepage: http://neuro.debian.net
Vcs-Browser: http://git.debian.org/?p=pkg-exppsy/neurodebian.git
Vcs-Git: git://git.debian.org/git/pkg-exppsy/neurodebian.git

Package: neurodebian
Architecture: all
Depends: python, wget, neurodebian-archive-keyring, ${misc:Depends}
Recommends: netselect
Suggests: neurodebian-desktop, neurodebian-popularity-contest
Description: neuroscience-oriented distribution - repository configuration
 The NeuroDebian project integrates and maintain a variety of
 neuroscience-oriented (such as AFNI, FSL, PsychoPy, etc.) and many
 generic computational (such as condor, pandas, etc.) software projects
 within Debian.
 .
 This package enables the NeuroDebian repository on top of standard
 Debian or Ubuntu systems.


Package: neurodebian-dev
Architecture: all
Depends: ${misc:Depends}, devscripts, cowbuilder, neurodebian-archive-keyring
Recommends: python, zerofree, moreutils, time, ubuntu-keyring, debian-archive-keyring, apt-utils
Suggests: virtualbox-ose, virtualbox-ose-fuse
Description: neuroscience-oriented distribution - development tools
 The NeuroDebian project integrates and maintain a variety of
 neuroscience-oriented (such as AFNI, FSL, PsychoPy, etc.) and many
 generic computational (such as condor, pandas, etc.) software projects
 within Debian.
 .
 This package provides sources and development tools used by
 NeuroDebian to provide backports for a range of Debian/Ubuntu
 releases.


Package: neurodebian-desktop
Architecture: all
Depends: ${misc:Depends}, ssh-askpass-gnome | ssh-askpass, desktop-base, gnome-icon-theme,
         neurodebian-popularity-contest
Suggests:
Description: neuroscience-oriented distribution - desktop integration
 The NeuroDebian project integrates and maintain a variety of
 neuroscience-oriented (such as AFNI, FSL, PsychoPy, etc.) and many
 generic computational (such as condor, pandas, etc.) software projects
 within Debian.
 .
 This package provides NeuroDebian artwork (icons, background image)
 and a NeuroDebian menu featuring most popular neuroscience tools
 automatically installed upon initial invocation.


Package: neurodebian-archive-keyring
Architecture: all
Depends: ${misc:Depends}
Replaces: neurodebian-keyring (<< 0.34~)
Breaks: neurodebian-keyring (<< 0.34~)
Description: neuroscience-oriented distribution - GnuPG archive keys
 The NeuroDebian project integrates and maintain a variety of
 neuroscience-oriented (such as AFNI, FSL, PsychoPy, etc.) and many
 generic computational (such as condor, pandas, etc.) software projects
 within Debian.
 .
 The NeuroDebian project digitally signs its Release files. This package
 contains the archive keys used for that.

Package: neurodebian-popularity-contest
Architecture: all
Depends: ${misc:Depends}, popularity-contest
Description: neuroscience-oriented distribution - popcon integration
 The NeuroDebian project integrates and maintain a variety of
 neuroscience-oriented (such as AFNI, FSL, PsychoPy, etc.) and many
 generic computational (such as condor, pandas, etc.) software projects
 within Debian.
 .
 This package is a complement to the generic popularity-contest
 package to enable anonymous submission of usage statistics to
 NeuroDebian in addition to the popcon submissions to the underlying
 distribution (either Debian or Ubuntu) popcon server.
 .
 Participatin to in popcon is important for following reasons:
  - Popular packages receive more attention from developers, bugs are
    fixed faster and updates are provided quicker.
  - Assure that support is not dropped for a previous release of Debian
    or Ubuntu while are active users.
  - User statistics could be used by upstream research software
    developers to acquire funding for continued development.
 .
 This requires that popcon is activated for the underlying distribution
 (Debian or Ubuntu). This can be achieved by running
 "dpkg-reconfigure popularity-contest" as root.

Attachment: signature.asc
Description: Digital signature


Reply to: