Bug#673688: confusing NEWS.Debian message
Package: ifupdown
Version: 0.7~rc3
Severity: normal
Tags: l10n
The paragraph in the NEWS.Debian about the new interface class featuers
is quite confusing. I had to read it several times until I unserstood
what it wants to say. Please consider reformulating it. Keep in mind that
upon upgrading to this is potentially shown to a lot of people and that
not all of them have a very technical background.
I'm not sure if this change really warants an NEWS.Debian entry as for most
people it does not change anything and as far as I understand it this is a
new additional feature, not a change in ifupdown behavior. Is it really
necessary that every Debian user sees this message?
Below I have included an attempt to reformulate the message to make it easier
to understand. But I'm not an english native speaker and might text might be
far from optimal. Therefore I also CCed the debian-i10n-english list on this
report.
Original message:
ifupdown (0.7~rc1+experimental) experimental; urgency=low
If ifup or ifquery is called with the --all option, if doesn't just
bring up all interfaces marked as "auto", but all interfaces of a
specified class, 'auto' by default. For the most uses, this doesn't
change anything, but lets all the interfaces of a specific class to be
brought up or queried.
If ifupdown is called with the --all option, before or after doing
anything to the interfaces, it calls all the hook scripts (pre-up or
down) with IFACE set to "--all", LOGICAL set to the current class
specified by the --allow option (or "auto" if it's not set),
ADDRFAM="meta" and METHOD="none".
-- Andrew O. Shadura <bugzilla@tut.by> Tue, 17 Apr 2012 01:05:42 +0200
My reformulation attempt:
------
The --all option to ifup and ifquery can be combined with the --allow
option to bring up or query all interfaces of a specific class. The
default class if no --allow option is present is "auto". Therefore
for most use cases this does not change anything.
If ifupdown is called with the --all option, before or after doing
anything to the interfaces, it calls all the hook scripts (pre-up or
down) with IFACE set to "--all", LOGICAL set to the current class
specified by the --allow option (or "auto" if it's not set),
ADDRFAM="meta" and METHOD="none".
------
Thanks,
Gaudenz
-- System Information:
Debian Release: wheezy/sid
APT prefers testing
APT policy: (800, 'testing'), (700, 'unstable'), (50, 'experimental')
Architecture: amd64 (x86_64)
Kernel: Linux 3.3.0-trunk-amd64 (SMP w/2 CPU cores)
Locale: LANG=de_CH.UTF-8, LC_CTYPE=de_CH.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages ifupdown depends on:
ii dpkg 1.16.3
ii initscripts 2.88dsf-22.1
ii iproute 20120319-1
ii libc6 2.13-32
ii lsb-base 4.1+Debian3
ifupdown recommends no packages.
Versions of packages ifupdown suggests:
pn isc-dhcp-client [dhcp-client] 4.2.2.dfsg.1-5
pn net-tools 1.60-24.1
pn ppp 2.4.5-5.1
pn rdnssd <none>
-- no debconf information
Reply to: