[Pkg-sysvinit-devel] [RFR] templates://sysvinit/{sysv-rc.templates}

Christian Perrier bubulle at debian.org
Sat Sep 12 13:43:20 UTC 2009


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

This review will last from Saturday, September 12, 2009 to Tuesday, September 22, 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:
--- sysvinit.old/debian/sysv-rc.templates	2009-09-08 09:08:03.485746100 +0200
+++ sysvinit/debian/sysv-rc.templates	2009-09-12 10:14:30.650056347 +0200
@@ -10,52 +10,30 @@
 Template: sysv-rc/convert-legacy
 Type: boolean
 Default: true
-Description: Migrate legacy boot sequencing to dependency based sequencing?
- The boot system is prepared to migrate to dependency based sequencing.
- It is recommended to migrate for the following reasons:
+Description: Migrate legacy boot sequencing to dependency-based sequencing?

Add hyphen

+ The boot system is prepared to migrate to dependency-based sequencing.
  .
-  * the order of boot and shutdown is calculated dynamically, using
-    dependency information declared within each init.d script, which
-    ensures optimum and correct boot sequence for the set of installed
-    packages
-  * protection against problems introduced by new or upgraded packages
-    by preserving the boot sequence when problems are detected; the boot
-    sequence is only modified if it is safe to do so
-  * potential for further optimization by way of concurrent boot
-    methodology in order to increase boot efficiency
-  * fixes long standing issues with the legacy, static priority based
-    boot ordering.
+ A full rationale for this migration is detailed in
+ /usr/share/doc/sysvinit/README.Debian. This migration process is
+ non-reversible.
  .
- This migration process is non-reversible. The legacy way of ordering
- boot scripts using static sequence numbers will be made obsolete by
- choosing to migrate.  Any boot sequence changes done locally will be
- lost and have to redone using dependencies.
- .
- See http://wiki.debian.org/LSBInitScripts/DependencyBasedBoot for
- more information about dependency based boot sequencing. To
- reattempt the migration process run 'dpkg-reconfigure sysv-rc'.
+ If you don't choose to migrate now, you can do it later by running
+ "dpkg-reconfigure sysv-rc".

This is an attempt to make it short.

This can be summarized to "go and read README.Debian" if you have no
idea about what to answer.

As a consequence, I propose keeping only the important information in
the template:

- what this is about (switching to dependency-based)
- where is full info about this (README.Debian)
- this is non reversible
- what you need to do if you refuse now

I'll add the proposed README.Debian file to this review. In
short....it picks the information that was formerly in the template.

 
 Template: sysv-rc/unable-to-convert
 Type: note
-Description: Unable to migrate to dependency based boot system
+#flag:translate!:3
+Description: Unable to migrate to dependency-based boot system
  Tests have determined that problems in the boot system exist which
- prevent migration to dependency based boot sequencing. It is
- recommended to migrate for the following reasons:
+ prevent migration to dependency-based boot sequencing:
  .
-  * the order of boot and shutdown is calculated dynamically, using
-    dependency information declared within each init.d script, which
-    ensures optimum and correct boot sequence for the set of installed
-    packages
-  * protection against problems introduced by new or upgraded packages
-    by preserving the boot sequence when problems are detected; the boot
-    sequence is only modified if it is safe to do so
+ ${PROBLEMATIC}
  .
- If the reported problem is a local modification it needs to be fixed
- manually.  If it's a bug in the package it should be reported to the
+ If the reported problem is a local modification, it needs to be fixed
+ manually.  If it's a bug in the package, it should be reported to the
  BTS and fixed in the package. See
  http://wiki.debian.org/LSBInitScripts/DependencyBasedBoot for more
- information about how to fix the problems preventing migration. To
- reattempt the migration process after the problems have been fixed,
- run 'dpkg-reconfigure sysv-rc'.
+ information about how to fix the problems preventing migration.
  .
- The following problems were detected: ${PROBLEMATIC}
+ To reattempt the migration process after the problems have been
+ fixed, run "dpkg-reconfigure sysv-rc".

About the same rationale.

Here, I also propose moving the important bit of info higher in the
template and isolate "${PROBLEMATIC}" in a dedicated (non
translatable) paragraph. That will avoid errors by translators who
might be tempted to translate the variable name.




-- 


-------------- next part --------------
# These templates have not been reviewed by the debian-l10n-english
# team
#
# If modifications/additions/rewording are needed, please ask
# debian-l10n-english at lists.debian.org for advice.
#
# Even minor modifications require translation updates and such
# changes should be coordinated with translators and reviewers.

Template: sysv-rc/convert-legacy
Type: boolean
Default: true
Description: Migrate legacy boot sequencing to dependency-based sequencing?
 The boot system is prepared to migrate to dependency-based sequencing.
 .
 A full rationale for this migration is detailed in
 /usr/share/doc/sysvinit/README.Debian. This migration process is
 non-reversible.
 .
 If you don't choose to migrate now, you can do it later by running
 "dpkg-reconfigure sysv-rc".

Template: sysv-rc/unable-to-convert
Type: note
#flag:translate!:3
Description: Unable to migrate to dependency-based boot system
 Tests have determined that problems in the boot system exist which
 prevent migration to dependency-based boot sequencing:
 .
 ${PROBLEMATIC}
 .
 If the reported problem is a local modification, it needs to be fixed
 manually.  If it's a bug in the package, it should be reported to the
 BTS and fixed in the package. See
 http://wiki.debian.org/LSBInitScripts/DependencyBasedBoot for more
 information about how to fix the problems preventing migration.
 .
 To reattempt the migration process after the problems have been
 fixed, run "dpkg-reconfigure sysv-rc".
-------------- next part --------------
--- sysvinit.old/debian/sysv-rc.templates	2009-09-08 09:08:03.485746100 +0200
+++ sysvinit/debian/sysv-rc.templates	2009-09-12 10:14:30.650056347 +0200
@@ -10,52 +10,30 @@
 Template: sysv-rc/convert-legacy
 Type: boolean
 Default: true
-Description: Migrate legacy boot sequencing to dependency based sequencing?
- The boot system is prepared to migrate to dependency based sequencing.
- It is recommended to migrate for the following reasons:
+Description: Migrate legacy boot sequencing to dependency-based sequencing?
+ The boot system is prepared to migrate to dependency-based sequencing.
  .
-  * the order of boot and shutdown is calculated dynamically, using
-    dependency information declared within each init.d script, which
-    ensures optimum and correct boot sequence for the set of installed
-    packages
-  * protection against problems introduced by new or upgraded packages
-    by preserving the boot sequence when problems are detected; the boot
-    sequence is only modified if it is safe to do so
-  * potential for further optimization by way of concurrent boot
-    methodology in order to increase boot efficiency
-  * fixes long standing issues with the legacy, static priority based
-    boot ordering.
+ A full rationale for this migration is detailed in
+ /usr/share/doc/sysvinit/README.Debian. This migration process is
+ non-reversible.
  .
- This migration process is non-reversible. The legacy way of ordering
- boot scripts using static sequence numbers will be made obsolete by
- choosing to migrate.  Any boot sequence changes done locally will be
- lost and have to redone using dependencies.
- .
- See http://wiki.debian.org/LSBInitScripts/DependencyBasedBoot for
- more information about dependency based boot sequencing. To
- reattempt the migration process run 'dpkg-reconfigure sysv-rc'.
+ If you don't choose to migrate now, you can do it later by running
+ "dpkg-reconfigure sysv-rc".
 
 Template: sysv-rc/unable-to-convert
 Type: note
-Description: Unable to migrate to dependency based boot system
+#flag:translate!:3
+Description: Unable to migrate to dependency-based boot system
  Tests have determined that problems in the boot system exist which
- prevent migration to dependency based boot sequencing. It is
- recommended to migrate for the following reasons:
+ prevent migration to dependency-based boot sequencing:
  .
-  * the order of boot and shutdown is calculated dynamically, using
-    dependency information declared within each init.d script, which
-    ensures optimum and correct boot sequence for the set of installed
-    packages
-  * protection against problems introduced by new or upgraded packages
-    by preserving the boot sequence when problems are detected; the boot
-    sequence is only modified if it is safe to do so
+ ${PROBLEMATIC}
  .
- If the reported problem is a local modification it needs to be fixed
- manually.  If it's a bug in the package it should be reported to the
+ If the reported problem is a local modification, it needs to be fixed
+ manually.  If it's a bug in the package, it should be reported to the
  BTS and fixed in the package. See
  http://wiki.debian.org/LSBInitScripts/DependencyBasedBoot for more
- information about how to fix the problems preventing migration. To
- reattempt the migration process after the problems have been fixed,
- run 'dpkg-reconfigure sysv-rc'.
+ information about how to fix the problems preventing migration.
  .
- The following problems were detected: ${PROBLEMATIC}
+ To reattempt the migration process after the problems have been
+ fixed, run "dpkg-reconfigure sysv-rc".
-------------- next part --------------
Source: sysvinit
Section: admin
Priority: required
Maintainer: Debian sysvinit maintainers <pkg-sysvinit-devel at lists.alioth.debian.org>
Uploaders: Petter Reinholdtsen <pere at debian.org>, Henrique de Moraes Holschuh <hmh at debian.org>, Kel Modderman <kel at otaku42.de>
Build-Depends: debhelper (>= 1), po-debconf, quilt (>= 0.40), libselinux1-dev (>= 1.14) [!hurd-i386 !kfreebsd-i386 !kfreebsd-amd64], libsepol1-dev [!hurd-i386 !kfreebsd-i386 !kfreebsd-amd64]
Standards-Version: 3.8.3
Homepage: http://freshmeat.net/projects/sysvinit/
Vcs-Svn: svn://svn.debian.org/pkg-sysvinit/sysvinit/trunk
Vcs-Browser: http://svn.debian.org/wsvn/pkg-sysvinit/sysvinit/trunk/

Package: sysvinit
Essential: yes
Architecture: any
Pre-Depends: initscripts, sysv-rc | file-rc, sysvinit-utils
Depends: ${shlibs:Depends}
Description: System-V-like init utilities
 This package contains programs required for booting
 a Debian system and doing basic process management.
 .
 The most important program in the package is /sbin/init.
 It is the first process started on boot and continues
 to run as process number 1 until the system halts. All
 other processes are descended from it.

Package: sysvinit-utils
Essential: yes
Architecture: any
Conflicts: last, sysvconfig, chkconfig (<< 11.0-79.1-2)
Replaces: last, sysvinit (<= 2.86.ds1-65)
Depends: ${shlibs:Depends}
Suggests: sash
Description: System-V-like utilities
 This package contains the important System-V-like utilities.
 .
 Specifically, this package includes:
 killall5, last, lastb, mesg, pidof, service, sulogin

Package: sysv-rc
Architecture: all
Recommends: lsb-base (>= 3.0-6)
Conflicts: file-rc
Replaces: file-rc
Suggests: sysv-rc-conf, bum
Depends: debconf | debconf-2.0, sysvinit-utils (>= 2.86.ds1-62), insserv (>> 1.12.0-10)
Breaks: initscripts (<< 2.86.ds1-63)
Description: System-V-like runlevel change mechanism
 This package provides support for the System-V like system
 for booting, shutting down and changing runlevels,
 configured through symbolic links in /etc/rc?.d/.

Package: initscripts
Architecture: any
Depends: ${shlibs:Depends}, ${glibc:Depends}, ${mount:Depends}, debianutils (>= 2.13.1), lsb-base (>= 3.0-6), sysvinit-utils (>= 2.86.ds1-39), sysv-rc | file-rc
Recommends: psmisc, e2fsprogs
Conflicts: libdevmapper1.02.1 (<< 2:1.02.24-1)
Replaces: libc6, libc6.1, libc0.1, libc0.3
Description: scripts for initializing and shutting down the system
 The scripts in this package initialize a standard Debian
 GNU/Linux system at boot time and shut it down at halt or
 reboot time.

-------------- next part --------------
Migrating to dependency-based boot sequencing
---------------------------------------------

It is recommended to migrate for the following reasons:

- the order of boot and shutdown is calculated dynamically, using
  dependency information declared within each init.d script, which
  ensures optimum and correct boot sequence for the set of installed
  packages;
- protection against problems introduced by new or upgraded packages
  by preserving the boot sequence when problems are detected; the boot
  sequence is only modified if it is safe to do so;
- potential for further optimization by way of concurrent boot
  methodology in order to increase boot efficiency;
- fixes long standing issues with the legacy, static priority based
  boot ordering.

This migration process is non-reversible. The legacy way of ordering
boot scripts using static sequence numbers will be made obsolete by
choosing to migrate.  Any boot sequence changes done locally will be
lost and have to redone using dependencies.

See http://wiki.debian.org/LSBInitScripts/DependencyBasedBoot for
more information about dependency based boot sequencing.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-sysvinit-devel/attachments/20090912/b9d2411e/attachment.pgp>


More information about the Pkg-sysvinit-devel mailing list