localepurge.8


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

.TH LOCALEPURGE 8
.SH NAME
localepurge \- removing superfluous locale data
.SH SYNOPSIS
.B localepurge
.br
.SH "DESCRIPTION"
.BR localepurge
is a small script to recover disk space wasted for unneeded locale  
files and localized man pages. It will be automagically invoked by 
.BR emerge 
some day... 
You have to define the locale
directory names you want to keep from removal
in the 
.BR /etc/locale.nopurge
configuration file.
.br
Any other directory (or file) in 
.BR /usr/share/locale
not containing a subdirectory named
.BR LC_MESSAGES
will be discreetly ignored.
.SH OPTIONS
The configurable options consist of toggling verbose output, reporting a
summary of freed space, and deletion of localized manual pages in
addition to locale files.  All actions are specified in the
.BR /etc/locale.nopurge 
configuration file. 
For detailed debugging the commandline switch 
.BR -debug 
or just a short
.BR -d
instead are available for usage.
For verbose output the commandline switch 
.BR -verbose
or just a short
.BR -v
can be added. You can use too
.BR -help
to have help ;) or a short 
.BR -h.
You can use too
.BR -version
and if you dont like colors you can use
.BR -nocolor
or the short form
.BR -nc
if you want a pretend mode you can use
.BR -pretend
or the short from
.BR -p
enjoy.

.SH "A Word of CAUTION"
Please note, that 
.BR this
.BR tool
.BR is
.BR a
.BR hack
.BR which
.BR is
.BR not
.BR integrated
.BR with
.BR Gentoo
.BR Portage
.BR system 
and therefore is not meant for the faint of heart.  Responsibility for its 
usage and possible breakage of your system therefore lies in the sysadmin's 
(your) hands.
.br
Please definitely do abstain from reporting any bugs blaming localepurge if 
.BR 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 it.
.br
All locale directories containing a subdirectory named LC_MESSAGES
which are either commented out or not even listed at all in
.BR /etc/locale.nopurge 
will be irreversibly deleted.  The only way to
reinstall any lost locales is "remerging"
the ebuild.
.SH FILES
.BR /etc/locale.nopurge
.SH SEE ALSO
.SH AUTHOR
.BR localepurge
and its accompanying manual page was written for the 
.BR Gentoo 
.BR Linux 
system by Jos� Alberto Su�rez L�pez. Based in the grat job for Debian
GNU/Linux of Paul Seelig <pseelig@debian.org>.