Re: [RFR] templates://localepurge/{localepurge.templates}
Christian PERRIER wrote:
> @@ -1,12 +1,15 @@
> Template: localepurge/nopurge
> Type: multiselect
> Choices: ${locales}
> +_Description: Locale files to keep on this system:
> + The localepurge package will remove all locale files from the system
> + except those that you select here.
> + .
> + It is recommended to choose locales with no country specifier (such
> + as "de", "it, etc.) as well as those that include a country code
^"
> + ("de_DE", "de_CH", "it_IT", etc.).
> + .
> + Entries from /etc/locale.gen will be preselected
> if no prior configuration has been successfully completed.
>
> First of all, we need the synopsis to be a "prompt"....so turning it
> into oe, incuding final colon....
(For Niels's benefit: s/oe/one/)
The trouble with that middle paragraph is that it sounds as if it's
telling me to pick *all* the xx and xx_XX locales, when in fact the
advice was that I should just keep en and en_GB and purge all the
en_US and so on. (Is that really a good idea, though?)
Maybe:
When selecting the locale corresponding to your language and country
code (such as "de_DE", "de_CH", "it_IT", etc.) it is recommended to
choose the two-character entry ("de", "it", etc.) as well.
> Template: localepurge/use-dpkg-feature
[...]
> Template: localepurge/none_selected
Look OK.
> Template: localepurge/remove_no
(This made me think "why does Norwegian get special treatment?" - I
need more coffee.)
> Type: note
> +_Description: No localepurge action until the package is configured
> + The localepurge package will not be useful until you successfully configure it with
> the command "dpkg-reconfigure localepurge". The configured entries from
> + /etc/locale.gen of the locales package will then be automatically
> preselected.
Or since it'll also work if my assistant configures it:
The localepurge package will not be useful until it has been successfully
configured using the command "dpkg-reconfigure localepurge". [...]
> Template: localepurge/mandelete
> Type: boolean
> Default: true
> _Description: Also delete localized man pages?
> + Based on the same locale information you chose, localepurge can also
> + delete localized man pages.
>
> No "above". Depending on the debconf interface, this might be "before"
> and not "above"...:-)
>
> And the localized man pages are not superfluous....they're just not
> used by this system..:-)
Well, if I don't need them then they're superfluous here. But the
sentence still works without that word, so it seems appropriate to
leave it out!
I don't really like that use of "based on", but I'm not sure what my
dislike is based on.
> Template: localepurge/dontbothernew
> Type: boolean
> Default: false
> _Description: Inform about new locales?
> + If you choose this option, you will be given the opportunity
> to decide whether to keep or delete newly introduced locales.
> + .
> + If you don't choose it, newly introduced locales will be
> + automatically dropped from the system.
I've never quite been able to understand why anyone would want this;
is it for people who are concerned that their nation might soon
fragment into sub-codes, or what?
> Template: localepurge/showfreedspace
> Type: boolean
> Default: true
> _Description: Display freed disk space?
> + The localepurge program can calculate and display the disk space freed by its
> + operations and show a saved disk space summary when quitting.
>
> Avoid weird capitalization.
>
> "at"? "when"? Justin?
If the idea is that there are two different displays, a per-action
freed space calculation and a final total, it might be clearer as:
The localepurge program can display the disk space freed by each
operation, and show a final summary of saved disk space.
> Template: localepurge/quickndirtycalc
[...]
> There are two ways available to calculate freed disk space. One is
> much faster than the other but far less accurate if other changes occur
> + on the filesystem during disk space calculation. The other one is more
> + accurate but slower.
Nitpick: s/filesystem/file system/
> Template: localepurge/verbose
> Type: boolean
> Default: false
> _Description: Display verbose output?
> + The localepurge program may be configured to explicitly show which locale files it
> deletes. This possibly causes a lot of screen output.
Slightly odd modality stuff there:
The localepurge program can be configured to explicitly show which
locale files it deletes. This may cause a lot of screen output.
Control file:
> Suggests: debfoster, deborphan, bleachbit
> -Description: Reclaim disk space removing unneeded localizations
> +Description: reclaim disk space by removing unneeded localizations
[...]
> Synopsis should not start with a capital letter. Adding "by" (Justin?)
That makes it a better verb phrase. The recommended construction
is a noun phrase - something more like:
Description: tool for reclaiming disk space from unneeded localizations
but I'm not sure this is worth the effort, given that I don't know
whether I'd call it a "tool" or a "system" or what.
> + This package provides a script to recover disk space wasted for unneeded locales,
> Gnome/KDE localizations and localized man pages. Depending on the
^^^^^
s/Gnome/GNOME/
> + installation, it is possible to save hundreds of
> + megabytes of disk space dedicated for localization you will most
s/dedicated for/taken up by/
> + probably never have any use for. It is run automatically upon
> + completion of any APT installation actions.
> .
> + Please note that this tool is a hack which is *not* integrated with
Two paragraphs beginning with "please" gives me politeness fatigue.
This one could equally well just start with "This tool is..."
> + the system's package management and therefore is not for the faint
> + of heart. This program interferes with the package management
> and does provoke strange, but usually harmless, behaviour of programs
> related with apt/dpkg like dpkg-repack, reportbug, etc.
And then this sentence is rather repetitive, and has some minor
problems (such as en_GB -our alongside en_US -ize).
This tool is a hack which is *not* integrated with the system's
package management system and therefore is not for the faint of heart.
Its interference can provoke strange, but usually harmless, behavior in
programs related to apt/dpkg, such as dpkg-repack, reportbug, etc.
> + Responsibility for its usage and possible breakage of the system
> + therefore lies in the system administrator's hands.
> .
> + Please do abstain from reporting any such bugs blaming
> + localepurge if you break the system by using it. If you don't know
> + what you are doing and can't handle any resulting breakage, you should
> + not install this package.
Strictly speaking I don't think "such bugs" has anything to refer back
to, but it seems to work anyway.
Oops, and I've re-wrapped it.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
diff -ru localepurge-0.7.3.pristine/debian/control localepurge-0.7.3/debian/control
--- localepurge-0.7.3.pristine/debian/control 2013-09-19 12:20:05.000000000 +0100
+++ localepurge-0.7.3/debian/control 2013-10-21 10:55:03.019473300 +0100
@@ -11,23 +11,21 @@
Architecture: all
Depends: ${misc:Depends}, locales, ucf, debconf | debconf-2.0, procps
Suggests: debfoster, deborphan, bleachbit
-Description: Reclaim disk space removing unneeded localizations
- This is a script to recover disk space wasted for unneeded locales,
- Gnome/KDE localizations and localized man pages. Depending on the
- installation, it is possible to save some 200, 300, or even more
- mega bytes of disk space dedicated for localization you will most
- probably never have any use for. It is run automagically upon
- completion of any apt installation actions.
+Description: reclaim disk space by removing unneeded localizations
+ This package provides a script to recover disk space wasted for unneeded
+ locales, GNOME/KDE localizations and localized man pages. Depending on
+ the installation, it is possible to save hundreds of megabytes of disk
+ space taken up by localization you will most probably never have any
+ use for. It is run automatically upon completion of any APT installation
+ actions.
.
- Please note, that this tool is a hack which is *not* integrated with
- Debian's package management system and therefore is not for the faint
- of heart. This program interferes with the Debian package management
- and does provoke strange, but usually harmless, behaviour of programs
- related with apt/dpkg like dpkg-repack, reportbug, etc.
- Responsibility for its usage and possible breakage of your system
- therefore lies in the sysadmin's (your) hands.
+ This tool is a hack which is *not* integrated with the system's
+ package management system and therefore is not for the faint of heart.
+ Its interference can provoke strange, but usually harmless, behavior in
+ programs related to apt/dpkg, such as dpkg-repack, reportbug, etc.
+ Responsibility for its usage and possible breakage of the system
+ therefore lies in the system administrator's hands.
.
- Please definitely do abstain from reporting any such bugs blaming
- localepurge if you break your system by using it. If you don't know
- what you are doing and can't handle any resulting breakage on your own
- then please simply don't use this package.
+ Please do abstain from reporting any such bugs blaming localepurge if you
+ break the system by using it. If you don't know what you are doing and
+ can't handle any resulting breakage, you should not install this package.
diff -ru localepurge-0.7.3.pristine/debian/localepurge.templates localepurge-0.7.3/debian/localepurge.templates
--- localepurge-0.7.3.pristine/debian/localepurge.templates 2013-06-15 17:46:01.000000000 +0100
+++ localepurge-0.7.3/debian/localepurge.templates 2013-10-21 10:23:47.353848839 +0100
@@ -1,12 +1,15 @@
Template: localepurge/nopurge
Type: multiselect
Choices: ${locales}
-_Description: Selecting locale files
- localepurge will remove all locale files from your system but the ones for
- the language codes you select now. Usually two character locales like "de"
- or "pt" rather than "de_DE" or "pt_BR" contain the major portion of
- localizations. So please select both for best support of your national
- language settings. The entries from /etc/locale.gen will be preselected
+_Description: Locale files to keep on this system:
+ The localepurge package will remove all locale files from the system
+ except those that you select here.
+ .
+ When selecting the locale corresponding to your language and country
+ code (such as "de_DE", "de_CH", "it_IT", etc.) it is recommended to
+ choose the two-character entry ("de", "it", etc.) as well.
+ .
+ Entries from /etc/locale.gen will be preselected
if no prior configuration has been successfully completed.
Template: localepurge/use-dpkg-feature
@@ -17,11 +20,11 @@
from packages being installed.
.
Please see /usr/share/doc/localepurge/README.dpkg-path for more
- information about this feature. It can be enabled (or disabled)
+ information about this feature. It can be enabled (or disabled)
later by running "dpkg-reconfigure localepurge".
.
- Caveat: Changing this option will only take affect for packages
- unpacked after localepurge has been (re)configured. Packages
+ This option will become active for packages
+ unpacked after localepurge has been (re)configured. Packages
installed or upgraded together with localepurge may (or may not) be
subject to the previous configuration of localepurge.
@@ -29,40 +32,41 @@
Type: boolean
Default: false
_Description: Really remove all locales?
- You chose not to keep any locales. This means that all locales will be
- removed from your system. Are you sure this really is what you want?
+ No locale has been chosen for being kept. This means that all locales will be
+ removed from this system. Please confirm whether this is really your
+ intent.
Template: localepurge/remove_no
Type: note
-_Description: localepurge will not take any action
- localepurge will not be useful until you successfully configure it with
- the command "dpkg-reconfigure localepurge". The configured entries from
- /etc/locale.gen of the locales package will then be automagically
- preselected.
+_Description: No localepurge action until the package is configured
+ The localepurge package will not be useful until it has been successfully
+ configured using the command "dpkg-reconfigure localepurge". The
+ configured entries from /etc/locale.gen of the locales package will then
+ be automatically preselected.
Template: localepurge/mandelete
Type: boolean
Default: true
_Description: Also delete localized man pages?
- Based on the same locale information you chose above, localepurge can also
- delete superfluous localized man pages.
+ Based on the same locale information you chose, localepurge can also
+ delete localized man pages.
Template: localepurge/dontbothernew
Type: boolean
Default: false
_Description: Inform about new locales?
- If you are content with the selection of locales you chose to keep and
- don't want to care about whether to delete or keep newly found locales,
- just deselect this option to automatically remove new locales you probably wouldn't
- care about anyway. If you select this option, you will be given the opportunity
+ If you choose this option, you will be given the opportunity
to decide whether to keep or delete newly introduced locales.
+ .
+ If you don't choose it, newly introduced locales will be
+ automatically dropped from the system.
Template: localepurge/showfreedspace
Type: boolean
Default: true
_Description: Display freed disk space?
- localepurge can calculate and display the disk space freed by its
- operations and show a saved disk space summary at quitting.
+ The localepurge program can display the disk space freed by each
+ operation, and show a final summary of saved disk space.
Template: localepurge/quickndirtycalc
Type: boolean
@@ -70,12 +74,12 @@
_Description: Accurate disk space calculation?
There are two ways available to calculate freed disk space. One is
much faster than the other but far less accurate if other changes occur
- on the filesystem during disc space calculation. The other one works more
- accurately and is therefore the preferred choice.
+ on the file system during disk space calculation. The other one is more
+ accurate but slower.
Template: localepurge/verbose
Type: boolean
Default: false
_Description: Display verbose output?
- localepurge may be configured to explicitly show which locale files it
- deletes. This possibly causes a lot of screen output.
+ The localepurge program can be configured to explicitly show which
+ locale files it deletes. This may cause a lot of screen output.
Template: localepurge/nopurge
Type: multiselect
Choices: ${locales}
_Description: Locale files to keep on this system:
The localepurge package will remove all locale files from the system
except those that you select here.
.
When selecting the locale corresponding to your language and country
code (such as "de_DE", "de_CH", "it_IT", etc.) it is recommended to
choose the two-character entry ("de", "it", etc.) as well.
.
Entries from /etc/locale.gen will be preselected
if no prior configuration has been successfully completed.
Template: localepurge/use-dpkg-feature
Type: boolean
Default: true
_Description: Use dpkg --path-exclude?
dpkg supports --path-exclude and --path-include options to filter files
from packages being installed.
.
Please see /usr/share/doc/localepurge/README.dpkg-path for more
information about this feature. It can be enabled (or disabled)
later by running "dpkg-reconfigure localepurge".
.
This option will become active for packages
unpacked after localepurge has been (re)configured. Packages
installed or upgraded together with localepurge may (or may not) be
subject to the previous configuration of localepurge.
Template: localepurge/none_selected
Type: boolean
Default: false
_Description: Really remove all locales?
No locale has been chosen for being kept. This means that all locales will be
removed from this system. Please confirm whether this is really your
intent.
Template: localepurge/remove_no
Type: note
_Description: No localepurge action until the package is configured
The localepurge package will not be useful until it has been successfully
configured using the command "dpkg-reconfigure localepurge". The
configured entries from /etc/locale.gen of the locales package will then
be automatically preselected.
Template: localepurge/mandelete
Type: boolean
Default: true
_Description: Also delete localized man pages?
Based on the same locale information you chose, localepurge can also
delete localized man pages.
Template: localepurge/dontbothernew
Type: boolean
Default: false
_Description: Inform about new locales?
If you choose this option, you will be given the opportunity
to decide whether to keep or delete newly introduced locales.
.
If you don't choose it, newly introduced locales will be
automatically dropped from the system.
Template: localepurge/showfreedspace
Type: boolean
Default: true
_Description: Display freed disk space?
The localepurge program can display the disk space freed by each
operation, and show a final summary of saved disk space.
Template: localepurge/quickndirtycalc
Type: boolean
Default: true
_Description: Accurate disk space calculation?
There are two ways available to calculate freed disk space. One is
much faster than the other but far less accurate if other changes occur
on the file system during disk space calculation. The other one is more
accurate but slower.
Template: localepurge/verbose
Type: boolean
Default: false
_Description: Display verbose output?
The localepurge program can be configured to explicitly show which
locale files it deletes. This may cause a lot of screen output.
Source: localepurge
Section: admin
Priority: optional
Maintainer: Niels Thykier <niels@thykier.net>
Build-Depends: po-debconf, debhelper (>= 9)
Standards-Version: 3.9.4
Vcs-Git: git://anonscm.debian.org/collab-maint/localepurge.git
Vcs-Browser: http://anonscm.debian.org/gitweb/?p=collab-maint/localepurge.git
Package: localepurge
Architecture: all
Depends: ${misc:Depends}, locales, ucf, debconf | debconf-2.0, procps
Suggests: debfoster, deborphan, bleachbit
Description: reclaim disk space by removing unneeded localizations
This package provides a script to recover disk space wasted for unneeded
locales, GNOME/KDE localizations and localized man pages. Depending on
the installation, it is possible to save hundreds of megabytes of disk
space taken up by localization you will most probably never have any
use for. It is run automatically upon completion of any APT installation
actions.
.
This tool is a hack which is *not* integrated with the system's
package management system and therefore is not for the faint of heart.
Its interference can provoke strange, but usually harmless, behavior in
programs related to apt/dpkg, such as dpkg-repack, reportbug, etc.
Responsibility for its usage and possible breakage of the system
therefore lies in the system administrator's hands.
.
Please do abstain from reporting any such bugs blaming localepurge if you
break the system by using it. If you don't know what you are doing and
can't handle any resulting breakage, you should not install this package.
Reply to: